Tulimoa MCP Server
A remote Model Context Protocol server that lets AI agents discover curated SaaS and AI-agent tools from the Tulimoa directory.
- Endpoint:
https://mcp.tulimoa.com/mcp - Transport: Streamable HTTP
- Auth: none for the read tools (public data). The write tools (
submit_listing,edit_listing) require an OAuth login viaauth.tulimoa.comand awrite-scoped token bound to your Tulimoa account.
Tools
| Tool | Auth | What it does |
|---|---|---|
search_listings | none | Find tools by free-text query, category, pricing_model (free / freemium / paid / lifetime), mcp (tool has its own MCP server), eu_only, sort (new / popular / viewed), limit. Returns approved, published listings. |
get_listing | none | Full detail for one tool by its slug, including how it uses AI (ai_usage), data region and EU hosting, model source and certifications. |
list_categories | none | The category ids and labels used by search_listings. |
submit_listing | write | Create a new directory listing for AI or MCP software on behalf of the logged-in user (name, url, short_description, country, category, mcp, pricing_model, logo_url, ai_usage, visibility, optional data points and X handles). logo_url is required: a public https image URL (PNG, JPEG, WebP, GIF or AVIF, at least 64 px), scaled to max 512 px and stored as WebP. ai_usage (40 to 600 chars) is required. visibility: badge (free, Tulimoa badge on the website, reviewed within 7 days, returns the badge HTML) or launch ($5 one-time, no badge, reviewed first, refunded if rejected; needs withdrawal_consent: true, returns a checkout_url). Already listed websites are rejected. Created as pending; public after admin review. Max 5 / 24h per owner. |
edit_listing | write | Update fields of a listing you own (by slug), including a new logo_url, ai_usage and the optional data points. A listing without a logo needs one with the next edit. Any edit sends it back to review (status pending) before it is public again. |
Connect
Claude Code
claude mcp add --transport http tulimoa https://mcp.tulimoa.com/mcp
OpenClaw
openclaw mcp add tulimoa --url https://mcp.tulimoa.com/mcp --transport streamable-http
Generic MCP client (mcp.json)
{
"servers": {
"tulimoa": { "type": "http", "url": "https://mcp.tulimoa.com/mcp" }
}
}
How it works
A single Cloudflare Worker built on the agents SDK createMcpHandler (stateless Streamable HTTP, no Durable Objects). Reads hit the public Tulimoa catalog with the Supabase anon key, gated by RLS to approved and published listings β authless, since that data is public. Writes resolve a Tulimoa identity per request (either a direct OAuth Bearer, hash-looked-up in oauth_tokens and audience-bound to https://mcp.tulimoa.com/mcp, or an internally-signed identity header from the Tulimoa gateway) and then insert with an explicit owner_id. Hardened with per-colo rate limits and edge caching to protect the backend.
OAuth-capable clients discover the authorization server (auth.tulimoa.com) via GET /.well-known/oauth-protected-resource.
Develop
pnpm install
pnpm dev # wrangler dev (local)
pnpm typecheck # tsc --noEmit
pnpm deploy # wrangler deploy
The clawhub-skill/ folder contains the ClawHub skill that wraps this server for OpenClaw discovery.