The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the MCPVault listing page.
Search, inspect, and submit MCP servers from your AI agent. MCPVault exposes more than 18,000 records with evidence-labelled grades, freshness, verification, install, and compatibility data.
No installation required. Run directly with npx:
Or install globally:
Add to claude_desktop_config.json (typically ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Add to your MCP configuration in Cursor settings:
Search the MCPVault directory by keyword, category, or status.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Search term, e.g. "postgres", "file system" |
| category | string | No | Filter by category, e.g. "Databases", "DevTools" |
| status | string | No | Filter by status: verified, claimed, or stale |
| limit | number | No | Results to return (default 10, max 30) |
Example prompts:
Retrieve full details for a specific server by its MCPVault slug.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | Yes | MCPVault slug visible in the listing URL: mcpvault.io/servers/<slug> |
Returns: name, description, grade, status, verification date, GitHub repo, stars, license, client compatibility, topics, tool list, and listing URL.
Example prompts:
Get the install command for a specific MCP server.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | Yes | MCPVault slug for the server |
Returns the recorded install command and a link to the listing page. If no install command is on record, points to the listing for manual setup instructions.
Example prompts:
Submit a GitHub repository to MCPVault as a new MCP server listing. If you find an MCP server on GitHub that is not yet in MCPVault, use this tool to add it. The repository is validated against the MCPVault plausibility gate (the repo name, description, or topics must mention "mcp" or "model context protocol"). Rate limited to 5 submissions per client per day.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| repo_url | string | Yes | Full GitHub repository URL, e.g. https://github.com/owner/repo |
Responses:
Example prompts:
verified means MCPVault completed a live MCP handshake at the recorded time. It is not a security audit.stale means the maintainer has not claimed the imported record. It does not mean the software is abandoned.https://mcpvault.io. It does not read local files, credentials, prompts, or client conversations.For usage help, open an issue or contact hello@mcpvault.io. For a security concern, do not include secrets in a public issue. Email the same address with SECURITY in the subject.
See CHANGELOG.md for release notes.
MCPVault is an independent directory of more than 18,000 MCP server records. Public evidence is labelled by source and timestamp. Claimed records are maintainer-controlled; verified records have passed a live MCP handshake.
Browse at mcpvault.io.
MIT. See LICENSE.