mcpserverlist-mcp

Check if your MCP server is ready for MCP directories, then get it submitted and keep every listing up to date.

Documentation

mcpserverlist-mcp

Stdio MCP server for MCP Server List. It connects to the hosted service at https://mcpserverlist.io/mcp and passes tools through unchanged, so any stdio-only client or directory can use it.

What MCP Server List does

It helps MCP server authors get their server listed in MCP directories. It checks whether your server is ready to submit, and offers a $99 managed submission service that handles the submissions for you.

Install

Run with npx -y mcpserverlist-mcp (Node 20 or newer).

Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "mcpserverlist": {
      "command": "npx",
      "args": ["-y", "mcpserverlist-mcp"]
    }
  }
}

Claude Code:

claude mcp add mcpserverlist -- npx -y mcpserverlist-mcp

To use an API key, add "env": { "MCP_SERVER_LIST_API_KEY": "..." } to the config above, or pass -e MCP_SERVER_LIST_API_KEY=... to claude mcp add.

Direct remote (no install)

Clients that support Streamable HTTP can connect straight to the hosted server:

claude mcp add --transport http mcpserverlist https://mcpserverlist.io/mcp

Or in a JSON config, { "mcpServers": { "mcpserverlist": { "url": "https://mcpserverlist.io/mcp" } } }.

Environment variables

VariableRequiredDescription
MCP_SERVER_LIST_API_KEYNoSent as Authorization: Bearer <key>. Only sent when set.
MCP_SERVER_LIST_URLNoRemote endpoint. Default https://mcpserverlist.io/mcp.

Anonymous vs. API key

Discovery and check tools work without a key. Tools that act on your account (your servers, submissions) need an API key, which you get by calling the create_account tool. Use tools/list for the current set.

Behavior

  • Connects to the remote at startup. If that fails, it prints an error to stderr and exits non-zero. Stdout carries only MCP protocol traffic.
  • Forwards tools/list and tools/call unchanged. Resources and prompts are forwarded only if the remote advertises them. The remote's server instructions are mirrored.
  • If the connection to the remote drops, a request reconnects and retries once.

Development

npm install
npm test   # builds, then runs tests against an in-process fake remote

License

MIT