# AllMCPs Server [Verified] [Health: Active]

**Category:** 🔗 Aggregators  
**Repository:** https://github.com/Jackalope-Dev/allmcps-server  
**GitHub Stars:** 4  
**npm Downloads (last month):** 531  
**Views:** 15  
**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 the exact claude_desktop_config.json setup snippet and documentation for a specific MCP server by ID.
- **recommend_mcp_stack** — Recommend a curated multi-tool MCP server stack for a specific developer role or workflow (e.g. "fullstack", "data science", "devops").
- **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.
- **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 the AllMCPs Server MCP server does

The AllMCPs Server MCP server exposes the AllMCPs directory through MCP tools and a command-line interface. Agents can search listings by keyword or category, retrieve installation configuration and documentation for a server ID, and list directory categories with their server counts.

It also supports listing-management workflows. A user can submit a repository for indexing and review, verify ownership of an existing listing, inspect its boost and verified-badge status, or retrieve pricing and features for listing promotion. Boost initiation returns a Stripe checkout URL and an x402 invoice, according to the provided tool description.

## How it works

The package is a local stdio bridge rather than a standalone directory database. It forwards MCP requests to the live remote endpoint at `https://allmcps.com/api/mcp`, and the remote service supplies the current tool behavior. This means new or changed tools can become available without a package upgrade, although the remote endpoint controls what is exposed at runtime.

With no subcommand, `npx allmcps-server` starts the MCP stdio process. When given a CLI subcommand, the package instead calls the public REST API and prints JSON to standard output. Supported examples include searching with `search`, listing categories with `categories`, retrieving one listing with `server <id>`, and displaying usage help with `help`. The JSON output can be combined with shell tools such as `jq`.

## Setup and configuration

The AllMCPs Server MCP server requires Node.js 18 or newer. For a local MCP client, configure the command as `npx` with `-y allmcps-server` as its arguments. The documented configuration is suitable for Claude Desktop, and the package description also names Cursor, Windsurf, and other MCP-compatible agents.

`ALLMCPS_MCP_URL` optionally replaces the default remote endpoint. Set it when the bridge must target a different MCP URL; no other environment variables are documented.

## Tools and capabilities

The available tools are:

- `search_mcp_servers` searches by keyword and/or category.
- `get_mcp_install_config` returns an installation snippet and documentation for a listing ID.
- `list_mcp_categories` returns categories and server counts.
- `get_boost_pricing` returns boost pricing and features.
- `boost_mcp_server` starts a boost order for a listing ID.
- `get_boost_status` reports boost and verified-badge status.
- `submit_mcp_server` submits a name, URL, and email, with optional schema fields available at runtime.
- `verify_mcp_claim` verifies ownership through a GitHub README badge, website badge, or DNS record.

Submissions enter a pending review queue. The response includes a claim URL and badge Markdown that can be added to a repository README to verify the listing.

## Limitations and notes

The AllMCPs Server MCP server depends on the remote AllMCPs MCP or REST endpoint for its behavior and data. The README does not document offline operation, authentication requirements, rate limits, or guarantees about endpoint availability. Version 2 replaced the older `submit_mcp` tool with `submit_mcp_server`; clients depending on the old name should use version 1 instead. The package is released under the MIT license.

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