{
  "markdown": "# MCPVault MCP Server\n\nSearch, 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.\n\n[![MCPVault](https://mcpvault.io/badge/mcpvault-mcp.svg)](https://mcpvault.io/servers/mcpvault-mcp)\n\n---\n\n## Install\n\nNo installation required. Run directly with npx:\n\n```\nnpx -y mcpvault-mcp\n```\n\nOr install globally:\n\n```\nnpm install -g mcpvault-mcp\n```\n\n---\n\n## Client Configuration\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json` (typically `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"mcpvault\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcpvault-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```\nclaude mcp add mcpvault -- npx -y mcpvault-mcp\n```\n\n### Cursor\n\nAdd to your MCP configuration in Cursor settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcpvault\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcpvault-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## Tools\n\n### search_mcp_servers\n\nSearch the MCPVault directory by keyword, category, or status.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| query | string | Yes | Search term, e.g. \"postgres\", \"file system\" |\n| category | string | No | Filter by category, e.g. \"Databases\", \"DevTools\" |\n| status | string | No | Filter by status: `verified`, `claimed`, or `stale` |\n| limit | number | No | Results to return (default 10, max 30) |\n\n**Example prompts:**\n\n- \"Find me a working postgres MCP server\"\n- \"Search for MCP servers in the DevTools category with status verified\"\n- \"What MCP servers are available for file system access?\"\n\n---\n\n### get_mcp_server\n\nRetrieve full details for a specific server by its MCPVault slug.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| slug | string | Yes | MCPVault slug visible in the listing URL: `mcpvault.io/servers/<slug>` |\n\nReturns: name, description, grade, status, verification date, GitHub repo, stars, license, client compatibility, topics, tool list, and listing URL.\n\n**Example prompts:**\n\n- \"Get details for the github MCP server\"\n- \"What clients does the postgres-mcp server support?\"\n\n---\n\n### get_install_command\n\nGet the install command for a specific MCP server.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| slug | string | Yes | MCPVault slug for the server |\n\nReturns 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.\n\n**Example prompts:**\n\n- \"How do I install the github MCP server?\"\n- \"What is the install command for filesystem-mcp?\"\n\n---\n\n### submit_mcp_server\n\nSubmit 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.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| repo_url | string | Yes | Full GitHub repository URL, e.g. `https://github.com/owner/repo` |\n\n**Responses:**\n\n- Submitted successfully: returns the listing URL and a note that the owner can claim it at mcpvault.io/claim.\n- Already listed: returns the existing listing URL.\n- Not an MCP server: explains what the plausibility gate checks.\n- Rate limited: try again tomorrow.\n\n**Example prompts:**\n\n- \"If you find an MCP server on GitHub that is not in MCPVault, submit it\"\n- \"Submit https://github.com/owner/my-mcp-server to MCPVault\"\n- \"Add this MCP server to MCPVault: https://github.com/owner/repo\"\n\n---\n\n## Evidence and limitations\n\n- `verified` means MCPVault completed a live MCP handshake at the recorded time. It is not a security audit.\n- Grades summarize repository activity, maintenance, documentation, and reliability signals. They are not sold and do not guarantee safety.\n- `stale` means the maintainer has not claimed the imported record. It does not mean the software is abandoned.\n- Install commands and compatibility data come from public metadata and maintainer edits. Review the linked repository before running third-party code.\n- This server sends search and submission requests to `https://mcpvault.io`. It does not read local files, credentials, prompts, or client conversations.\n\n## Support and security\n\nFor usage help, open an issue or contact [hello@mcpvault.io](mailto:hello@mcpvault.io). For a security concern, do not include secrets in a public issue. Email the same address with `SECURITY` in the subject.\n\nSee [CHANGELOG.md](./CHANGELOG.md) for release notes.\n\n## About MCPVault\n\nMCPVault 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.\n\n<!-- mcp-name: io.github.coburn2716/mcpvault -->\n\nBrowse at [mcpvault.io](https://mcpvault.io).\n\n---\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n",
  "bytes": 5313,
  "sha": "64e3d1d014fdbb7d0c815f57295e25388a4bb2c1eee59b79ee86f7b11d95d475",
  "repo_slug": "coburn2716/mcpvault-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_coburn2716_mcpvault_ee86e8ca/readme"
}