The MCPea API

Developers

Everything on the shelf is available to agents and scripts: an MCP server your assistant can call, a small read-only REST API and feeds. No API key, no sign-up.

MCP server

Add MCP Shelf to your assistant and ask it things like “find me a Postgres MCP server and give me the Cursor config”. It uses Streamable HTTP, needs no sign-in and only reads data.

Endpoint

https://mcpshelf.co/mcp

Claude Code

claude mcp add --transport http mcpshelf https://mcpshelf.co/mcp

Cursor (~/.cursor/mcp.json) and Claude Desktop

{
  "mcpServers": {
    "mcpshelf": {
      "url": "https://mcpshelf.co/mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "mcpshelf": {
      "type": "http",
      "url": "https://mcpshelf.co/mcp"
    }
  }
}

In ChatGPT, add https://mcpshelf.co/mcp as a custom connector with no authentication. See the ChatGPT guide.

MCP tools

Tool	Arguments	What it does
search_shelf	query, category	Find MCP servers on MCP Shelf by what they do (e.g. "postgres", "browser", "figma") and/or category. Returns name, slug, one-line summary and page URL. Use get_server for the full entry.
get_server	slug	Everything MCP Shelf knows about one server: what it does, what it needs, the checked config, our install check result, package notes, stars and last commit.
get_install_config	slug, client	The config for one server in the format a specific app expects, with where to put it. Clients: claude-desktop, claude-code, cursor, vs-code, windsurf, chatgpt.
list_categories	none	The shelves (categories) on MCP Shelf with the server slugs on each.
get_setup_guide	guide	Step-by-step guide for adding MCP servers to an app. Guides: claude-code, cursor, cursor-mcp-json-location, claude-desktop, chatgpt, check-an-mcp-server, remote-vs-local-mcp-servers.

Try it with curl

curl -s https://mcpshelf.co/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_shelf","arguments":{"query":"browser"}}}'

REST API

Base URL https://mcpshelf.co/api/v1. Every response is JSON with CORS open, so it works from a browser too.

Method	Path	Returns
GET	/servers?q=&category=	Servers matching words and/or a category slug
GET	/servers/{slug}	One server: description, needs, config, install check, stars, logo
GET	/servers/{slug}/install?client=	The config in the format an app expects, and where it goes
GET	/categories	Categories with the slugs of their servers
GET	/guides	Setup guides with links

curl -s "https://mcpshelf.co/api/v1/servers?q=postgres"

One server's config for VS Code

curl -s "https://mcpshelf.co/api/v1/servers/playwright/install?client=vs-code"

client is one of claude-desktop, claude-code, cursor, vs-code, windsurf or chatgpt. Leave it out to get all of them.

Feeds and llms.txt

llms.txt /llms.txt
llms-full.txt /llms-full.txt
Latest additions (RSS) /rss.xml
Latest additions (JSON Feed) /feed.json

Caching and limits

Data refreshes from the database once a day, so there is no point polling more often than that. There is no key and no hard rate limit; please keep it to a few requests a second. Questions or ideas: mcpshelf@gmail.com.