The official local MCP server and CLI for AllMCPs.com — search, browse, get install configs for, and submit Model Context Protocol (MCP) servers directly from Claude, Cursor, any MCP-compatible agent, or a plain shell script.

This package is a thin stdio bridge to the AllMCPs remote MCP endpoint. Tool behavior lives server-side, so this package always exposes the current live tool set with no need to upgrade the package when a tool is added or changed.

v2.0.0 replaces the single submit_mcp tool with the full tool set below, including a renamed submit_mcp_server (previously submit_mcp). If you depend on the old tool name, pin allmcps-server@1.

Install

Requires Node.js 18+. Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "allmcps": {
      "command": "npx",
      "args": ["-y", "allmcps-server"]
    }
  }
}

CLI mode

Run with a subcommand instead of a bare npx allmcps-server and it becomes a plain scriptable CLI over the public REST API — no MCP client needed:

npx allmcps-server search postgres      # search the directory
npx allmcps-server categories           # list every category
npx allmcps-server server <id>          # full detail for one listing
npx allmcps-server help                 # usage

Each prints JSON to stdout, so it composes with jq and other Unix tools. With no subcommand it runs as the MCP stdio server described below (the default npx allmcps-server behavior).

Tools

| Tool | Required arguments | Description | | ----------------------- | --------------------- | ------------------------------------------------------------------------- | | search_mcp_servers | — | Search the directory by keyword and/or category. | | get_mcp_install_config| id | Get the install config snippet and docs for a server by ID. | | list_mcp_categories | — | List all categories with server counts. | | get_boost_pricing | — | Get pricing and features for boosting/featuring a listing. | | boost_mcp_server | id | Start a sponsorship/boost order — returns a Stripe checkout URL and x402 invoice. | | get_boost_status | id | Check boost and verified-badge status for a listing. | | submit_mcp_server | name, url, email| Submit a new MCP server to the directory. | | verify_mcp_claim | id | Verify ownership and claim a listing via GitHub README, site badge, or DNS. |

submit_mcp_server submissions land in the pending review queue at allmcps.com. The response includes a claim_url and a ready-to-paste badge_markdown snippet — adding that badge to your repo's README verifies the listing instantly instead of waiting on manual review.

Every tool's full input schema (including optional arguments like category, description, sku, and method) is available at runtime via the standard MCP tools/list call, or by inspecting /api/mcp directly.

Configuration

| Environment variable | Default | Purpose | | --------------------- | ------------------------------ | ----------------------------------------- | | ALLMCPS_MCP_URL | https://allmcps.com/api/mcp | Override the remote endpoint this package bridges to. |

Related

• Directory API docs: https://allmcps.com/docs/api
• Remote MCP server (same tools, called directly over HTTP): https://allmcps.com/api/mcp
• Also listed on the official MCP Registry as io.github.Jackalope-Dev/allmcps-server, Glama, and the LobeHub Marketplace

License

MIT © Jackalope Digital — see LICENSE.