AllMCPs Server README

allmcps-server

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):

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:

Terminal

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 by keyword and/or category; optional `transport` (remote/stdio) and `verified_only` filters.
`get_mcp_install_config`	`id`	Setup for a server in 13 clients (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Zed, Codex, Gemini CLI, JetBrains, Roo Code, Continue, LM Studio); optional `client` for one.
`get_mcp_alternatives`	`id`	Alternatives to a server in the same category.
`compare_mcp_servers`	`ids` (2 to 4)	Side by side: install, evidence it works, tools, health, stars, last commit, quality score.
`recommend_mcp_stack`	`role`	A small stack of complementary servers for a role or workflow.
`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.
`register_mcp_agent`	`email`	Start unattended-agent registration — emails a confirmation code.
`confirm_mcp_agent`	`email`, `code`	Exchange the emailed code for a bearer token (see below).

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.

verify_mcp_claim normally requires an active AllMCPs sign-in, which an unattended agent doesn't have. To claim without a browser session: call register_mcp_agent, retrieve the code from the email it sends, call confirm_mcp_agent to mint a bearer token, then pass that token as agentToken on verify_mcp_claim. Full spec: https://allmcps.com/auth.md

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.

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