Pea-rsonal shopper for your agent
Let your assistant pick your MCP servers
Add MCP Shelf to the AI assistant you already use, then ask it in plain words for an MCP server. It searches the shelf, tells you what the server needs, and hands you the config checked against the project's own README and package. Makers (and fans) can submit a server through it too. Free, no key and no account.
https://mcpshelf.co/mcpAsk it like you would ask a friend who knows MCP
“Find me an MCP server for Postgres and give me the Cursor config.”
Uses
search_shelf,get_install_config“I want my agent to read web pages. Which servers can I connect by URL, with nothing to install?”
Uses
search_shelf“Exa or Firecrawl for web research? Keep it short.”
Uses
compare_servers“What are the alternatives to Context7, and what would I give up?”
Uses
find_alternatives“Set up the GitHub MCP server in Claude Code. What do I need first?”
Uses
get_server,get_install_config“Is my server github.com/acme/acme-mcp on MCP Shelf yet? If not, submit it.”
Uses
check_listing,submit_listing
Connect it to your app
The same address works everywhere. Pick your app; each one links to our full setup guide if you get stuck.
Claude Code
Your terminal, in the project folder
claude mcp add --transport http mcpshelf https://mcpshelf.co/mcpCursor
~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"mcpshelf": {
"url": "https://mcpshelf.co/mcp"
}
}
}Claude Desktop
Customize → Connectors → add a custom connector
https://mcpshelf.co/mcpPaste the URL and sign in if asked. Custom connectors depend on your plan.
VS Code
.vscode/mcp.json in your project
{
"servers": {
"mcpshelf": {
"type": "http",
"url": "https://mcpshelf.co/mcp"
}
}
}Codex
~/.codex/config.toml, shared by the Codex CLI, IDE extension and ChatGPT desktop app
[mcp_servers.mcpshelf]
url = "https://mcpshelf.co/mcp"Or run: codex mcp add mcpshelf --url https://mcpshelf.co/mcp, then codex mcp login mcpshelf if it asks you to sign in.
Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcpshelf": {
"serverUrl": "https://mcpshelf.co/mcp"
}
}
}ChatGPT
chatgpt.com/plugins → + → Add custom MCP server
https://mcpshelf.co/mcpPaste the URL as the server address, choose OAuth if it asks you to sign in, create it as a plugin, then install it before using it in a chat. Workspace admins can block custom servers.
What it will and won’t do
- It only reads, with one exception: suggesting a listing. That shows you a draft first and sends nothing until you say so, and a person reviews it before anything goes on the shelf.
- It never signs you up, installs anything or changes anything outside MCP Shelf.
- Configs come from the shelf as written: package names, flags and env vars checked against each project's README and package, never made up by the model.
- It says what a server needs before you install it (an API key, an account, a local app) and whether it runs on your machine or at a hosted URL.
- Install checks come with their date. "Started in our test" is what we saw, not a promise it works everywhere.
- If nothing on the shelf fits, it says so instead of guessing.
Tools and prompts
Your assistant sees these and picks the right one for what you ask.
| Tool | What it does |
|---|---|
| search_shelf | Find MCP servers on MCP Shelf by what they do (e.g. "postgres", "browser", "figma") and/or category. Returns name, slug, one-line summary, whether it is a hosted URL, our install check and the page URL. Use get_server for the full entry. |
| get_server | Everything MCP Shelf knows about one server: what it does, what it needs, its tools, the checked config, our install check result, package notes, stars and last commit, plus links to head-to-head comparisons and alternatives. |
| get_install_config | The config for one server in the format a specific app expects, with where to put it and the setup steps from the project's README. Clients: claude-code, cursor, claude-desktop, vs-code, codex, windsurf, chatgpt. |
| compare_servers | Side by side facts for two to four servers: what each is for, what it needs, local or hosted, install check, tools, stars and last commit. Where we have written a head-to-head for a pair, its verdict and table are included. |
| find_alternatives | Other servers on the shelf that do the same job as one server. Where we have written an alternatives article, returns its verdict and each pick with what it is best for and what you give up; otherwise the other servers in the same category. |
| check_server_tools | Before someone installs a server: which of its tools only read, which change data and which run commands or code, from the tool list we got in our own run. Also how many tools describe themselves and say whether they change things, roughly how much context the tool list uses, and plain advice on which tools to keep approval on for. |
| list_categories | The shelves (categories) on MCP Shelf with the server slugs on each. |
| get_setup_guide | Step-by-step guide for adding MCP servers to an app. Guides: what-is-an-mcp-server, remote-vs-local-mcp-servers, mcp-remote, claude-code, claude-desktop, cursor, cursor-mcp-json-location, vs-code, codex, chatgpt, claude-connectors, jetbrains, docker-mcp-servers, build-an-mcp-server, test-an-mcp-server, mcp-server-errors, check-an-mcp-server. |
| check_listing | For makers: is a server on MCP Shelf? Give its GitHub repo URL, npm or PyPI package name, website or name. Returns where it is listed and the badge snippet, or how to suggest it. |
| submit_listing | Suggest an MCP server or Claude skill for MCP Shelf, for its maker or for a person who uses it. Call first without confirm: blanks are filled from the GitHub README or website and the draft comes back with anything still missing, nothing saved. Show the draft to the person, then call again with confirm: true to send it. A person reviews every suggestion before anything is published. Only call when the person asked, with their own name and email (they get a receipt by email). |
| get_submission_status | Where a suggestion sent with submit_listing (or the /submit form) stands: pending, approved (with its page), rejected (with the note) or duplicate. |
Apps that show MCP prompts (Claude Code lists them under /) also get find_and_install (find the best server on mcp shelf for a job and set it up in your app) and compare_options (shortlist the servers on mcp shelf for a job and explain which to pick and why) and submit_to_shelf (check whether a server or claude skill is on mcp shelf and, if not, suggest it for review).
Building something yourself? The developer docs cover the REST API, the feeds and the files for agents.
Peas and answers
Is the MCP Shelf MCP server free?
Yes. It needs no API key, no account and no payment, and it has no usage tiers. It is the same data as the website, so we keep it open.
Which apps can use it?
Any app that can connect to a remote MCP server over Streamable HTTP: Claude (desktop, web and Claude Code), ChatGPT, Cursor, VS Code, Codex and Windsurf, among others. Cursor and VS Code install it in one click.
Will it install servers for me?
No. It finds the server and gives your assistant the exact config and steps for your app. In a coding agent such as Claude Code or Cursor, the agent can then write the config file or run the command for you, with your OK.
Does it know about servers that are not on the shelf?
No, and it says so. MCP Shelf lists a hand-picked set of maintained servers rather than everything on GitHub, so the answers stay short and the configs stay right.
What does it send back to MCP Shelf?
Only the tool calls themselves, such as the words you searched for. There is no sign-in and no key, so nothing ties a call to you or your account.
Can I submit an MCP server or Claude skill through my assistant?
Yes, whether you made it or just use it. Give your assistant the GitHub link and your name and email. It fills in the details from the README, shows you the draft, and sends it only when you say so. A person reviews every suggestion, the receipt and the result come to your email, and your assistant can check the status later. If it is already listed, you get its page and the optional badge instead.