# AllMCPs Server [Verified] [Health: Active]

**Category:** 🔗 Aggregators  
**Repository:** https://github.com/Jackalope-Dev/allmcps-server  
**GitHub Stars:** 4  
**npm Downloads (last month):** 276  
**Views:** 87  
**Installs:** 20  
**Upvotes:** 1  
**Directory Page:** https://allmcps.com/mcp/allmcps-server

## Description
The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

## Tools
Capabilities this server exposes over MCP:

- **search_mcp_servers** — Search the AllMCPs directory for Model Context Protocol (MCP) servers by keyword or category.
- **get_mcp_install_config** — 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.
- **get_mcp_alternatives** — List alternative MCP servers to a given server ID — same category, ranked by fit and evidence that they work.
- **compare_mcp_servers** — 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.
- **recommend_mcp_stack** — 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.
- **list_mcp_categories** — List all categories available in the AllMCPs directory along with server counts.
- **get_boost_pricing** — Get pricing and features for boosting / featuring an MCP server on AllMCPs.com.
- **boost_mcp_server** — Initiate a sponsorship / boost order for an MCP server by ID, returning a Stripe checkout session URL and x402 invoice.
- **get_boost_status** — Check current boost status, verified badge level, and sponsorship expiration for an MCP server by ID.
- **submit_mcp_server** — 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. Submit each server once, on behalf of the person authorised to list it; bulk or unattended submissions are not allowed (see https://allmcps.com/terms#prohibited-conduct).
- **verify_mcp_claim** — 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.
- **register_mcp_agent** — 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.
- **confirm_mcp_agent** — 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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "allmcps-server": {
    "command": "npx",
    "args": ["-y","allmcps-server"],
    "env": {
      "ALLMCPS_MCP_URL": ""
    }
  }
}
```

**Requires environment variables:** `ALLMCPS_MCP_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What AllMCPs Server does

AllMCPs Server gives MCP-compatible clients access to the AllMCPs.com directory and its listing-management operations. Agents can search servers by keyword or category, filter results by transport or verification status, inspect categories and server details, and retrieve installation configurations for supported clients.

The server also supports evaluation and selection workflows. An agent can compare two to four listings using factors such as transport, installation command, tool count, operational evidence, health, GitHub activity, and quality score. It can find alternatives within a category or request a small group of complementary servers for a role such as data science, DevOps on AWS, or full-stack web development.

Listing owners can use the management tools to submit a repository, check boost pricing and status, start a sponsorship order, or verify ownership. Unattended agents can register by email, confirm a six-digit code, and use the resulting bearer token for claim verification.

## How it works

With no subcommand, `npx allmcps-server` starts a local stdio MCP process. The package forwards MCP requests to `https://allmcps.com/api/mcp`, so the tool implementation and available tool set are maintained by the remote service. Clients communicate with the local process using their normal MCP configuration.

The package also accepts CLI subcommands instead of starting an MCP server. Commands such as `search postgres`, `categories`, and `server <id>` call the public AllMCPs REST API and print JSON to standard output. This makes the CLI usable from shell scripts and composable with tools such as `jq`.

## Setup and configuration

Node.js 18 or newer is required. Add the following server entry to an MCP client's configuration:

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

The `ALLMCPS_MCP_URL` environment variable changes the remote MCP endpoint used by the local bridge. It defaults to `https://allmcps.com/api/mcp`.

For shell use, invoke the package with a supported subcommand, for example `npx allmcps-server search postgres` or `npx allmcps-server categories`.

## Tools and capabilities

- Search by keyword or category, with optional remote/stdio and verified-only filters.
- Retrieve installation configuration for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Zed, Codex, Gemini CLI, JetBrains, Roo Code, Continue, or LM Studio.
- Compare listings, find same-category alternatives, and recommend complementary server stacks.
- List directory categories and their server counts.
- Submit a repository for indexing and review, with optional enrichment fields.
- Start and inspect listing boosts, including Stripe checkout and x402 invoice details.
- Verify ownership through a GitHub README badge, website badge, or DNS record.

Submissions enter a pending review queue. A submission response includes a claim URL and badge Markdown. The unattended claim flow uses `register_mcp_agent`, `confirm_mcp_agent`, and then `verify_mcp_claim` with the returned token.

## Limitations and notes

The local package is a bridge rather than an independent directory database; requests depend on the configured remote endpoint. Its default behavior is MCP stdio, while CLI mode uses the public REST API. Submission and claim operations have authorization and usage requirements, including submitting a server on behalf of the person authorized to list it and avoiding bulk or unattended submissions.

_Full upstream README: https://allmcps.com/mcp/allmcps-server/readme_