allmcps-server
allmcps-server is a local MCP/CLI bridge for discovering, installing, submitting, boosting, and verifying MCP servers on AllMCPs.com.
Search the AllMCPs directory by keyword or category.
Get install/config snippets for a specific MCP server by ID.
Recommend curated MCP server stacks for roles/workflows.
List all MCP categories with server counts.
Get boost/feature pricing and start boost sponsorship orders.
Check boost status, verified-badge level, and sponsorship expiration.
Submit new MCP servers with optional enrichment metadata.
Verify and claim ownership of an MCP listing via GitHub, website badge, or DNS.
Use it as a CLI for JSON output (
search,categories,server,help) or as an MCP stdio server.
Verifies ownership and claims MCP server listings by checking for a verification badge in a GitHub repository's README; also accepts GitHub repository URLs for submissions.
Initiates sponsorship or boost orders for MCP server listings, returning a Stripe checkout session URL and x402 invoice for payment.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@allmcps-server Submit my new MCP server https://github.com/foo/bar named Foo with test@example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_mcptool with the full tool set below, including a renamedsubmit_mcp_server(previouslysubmit_mcp). If you depend on the old tool name, pinallmcps-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"]
}
}
}Related MCP server: Glama MCP Server Search
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 # usageEach 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 by keyword and/or category; optional |
|
| 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 |
|
| Alternatives to a server in the same category. |
|
| Side by side: install, evidence it works, tools, health, stars, last commit, quality score. |
|
| A small stack of complementary servers for a role or workflow. |
| — | List all categories with server counts. |
| — | Get pricing and features for boosting/featuring a listing. |
|
| Start a sponsorship/boost order — returns a Stripe checkout URL and x402 invoice. |
|
| Check boost and verified-badge status for a listing. |
|
| Submit a new MCP server to the directory. |
|
| Verify ownership and claim a listing via GitHub README, site badge, or DNS. |
|
| Start unattended-agent registration — emails a confirmation 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 |
|
| 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.
Available Tools
13 toolsboost_mcp_serverA
Initiate a sponsorship / boost order for an MCP server by ID, returning a Stripe checkout session URL and x402 invoice.
Inputs: id (required), sku, email.
compare_mcp_serversBRead-only
Compare 2 to 4 MCP servers side by side: transport, install command, evidence they work, tool count and source, health, GitHub stars, last commit and quality score.
Inputs: ids (required).
confirm_mcp_agentA
Exchange the 6-digit code emailed by register_mcp_agent for a durable bearer token (90-day TTL). Pass the returned token as agentToken on verify_mcp_claim, or set it as an Authorization: Bearer <token> header on subsequent MCP requests if your client supports that.
Inputs: code (required), email (required).
get_boost_pricingARead-only
Get pricing and features for boosting / featuring an MCP server on AllMCPs.com.
get_boost_statusBRead-only
Check current boost status, verified badge level, and sponsorship expiration for an MCP server by ID.
Inputs: id (required).
get_mcp_alternativesARead-only
List alternative MCP servers to a given server ID — same category, ranked by fit and evidence that they work.
Inputs: id (required), limit.
get_mcp_install_configARead-only
Get setup for one MCP server by ID: the config for every major client (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Zed, Codex, Gemini CLI, JetBrains, Roo Code, Continue, LM Studio) plus its documentation. Pass client for just one.
Inputs: id (required), client.
list_mcp_categoriesARead-only
List all categories available in the AllMCPs directory along with server counts.
recommend_mcp_stackARead-only
Recommend a small stack of complementary MCP servers for a role or workflow (e.g. "fullstack web app", "data science", "devops on AWS"), drawn from a live directory search.
Inputs: role (required).
register_mcp_agentA
Start unattended-agent registration: emails a 6-digit confirmation code to the given address. Follow up with confirm_mcp_agent to exchange the code for a bearer token, which unlocks verify_mcp_claim (and future privileged tools) without ever needing a human to sign in via browser.
Inputs: email (required), scopes, agentName.
search_mcp_serversARead-only
Search the AllMCPs directory for Model Context Protocol (MCP) servers by keyword or category.
Inputs: limit, query, category, transport, +1 more.
submit_mcp_serverA
Programmatically submit a new MCP server repository to AllMCPs.com for indexing and review. Supports the same optional enrichment fields as the human submission form — fill in whichever you can confidently determine from the repository (README, package.json, code) to produce a fully flushed-out listing. Omit anything you are not confident about rather than guessing; all enrichment fields are optional and unrecognized enum values are simply dropped, not rejected.
Inputs: url (required), name (required), email (required), tags, +12 more.
verify_mcp_claimA
Verify ownership and claim an MCP server listing by checking GitHub README badge, website badge, or DNS TXT record. Works two ways: (1) fully unattended — pass agentToken from confirm_mcp_agent (or set an Authorization: Bearer <token> header if your client supports it), no human sign-in needed; or (2) if called with neither, requires the caller to already have an active AllMCPs browser session. Unattended agents should use register_mcp_agent + confirm_mcp_agent first.
Inputs: id (required), method, agentToken, websiteUrl.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools target distinct actions, but the discovery cluster (search_mcp_servers, get_mcp_alternatives, compare_mcp_servers, recommend_mcp_stack) has some conceptual overlap that could cause misselection. The boost trio (boost_mcp_server, get_boost_pricing, get_boost_status) and the auth flow (register/confirm/verify) are clearly separated by their descriptions.
All tools follow a strict verb_noun snake_case pattern (get_, list_, search_, compare_, recommend_, submit_, register_, confirm_, verify_, boost_). No deviations or mixed conventions, making the set highly predictable.
13 tools is well within the sweet spot for a directory-plus-account server, and each tool covers a distinct capability (discovery, submission, verification, sponsorship). Nothing feels redundant or missing from a count perspective.
The surface covers discovery, comparison, recommendation, submission, verification, and boost lifecycle well. A minor gap is the absence of a generic 'get single server by ID' for full details, though get_mcp_install_config and compare_mcp_servers partially fill that role.
Maintenance
Related MCP Connectors
Publish and discover MCP servers via the official MCP Registry. Powered by HAPI MCP server.
The official e18e MCP server keeping your agent in check from installing bloated dependencies.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Related MCP Servers
- MIT
- AlicenseAqualityDmaintenanceAn MCP server for searching and exploring MCP servers from the Glama MCP directory. This server provides tools to search for MCP servers, get detailed information about specific servers, and explore available server attributes using the Glama MCP API.33MIT
- AlicenseAqualityBmaintenanceOfficial MCP server for Rendobar. Lets AI agents run serverless media processing and upload local files.983 npm1MIT
- AlicenseAqualityBmaintenanceMCP server for BrewPage, a free no-signup hosting service. Lets AI agents publish HTML, Markdown, JSON, files, or a full multi-file static site and get a public URL instantly via a REST API.325Apache 2.0