allmcps-server
The official local MCP server **and CLI** for [AllMCPs.com](https://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](https://allmcps.com/api/mcp). 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`):
```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](https://allmcps.com/docs/api) — no MCP client needed:
```bash
npx allmcps-server search postgres # search the directory
npx allmcps-server categories # list every category
npx allmcps-server server # 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](https://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`](https://allmcps.com/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](https://registry.modelcontextprotocol.io) as `io.github.Jackalope-Dev/allmcps-server`, [Glama](https://glama.ai/mcp/servers/Jackalope-Dev/allmcps-server), and the [LobeHub Marketplace](https://lobehub.com/mcp/jackalope-dev-allmcps-server)
## License
MIT © [Jackalope Digital](https://jackalope.digital) — see [LICENSE](LICENSE).