{
  "markdown": "# failmodes-mcp\n\nMCP server for the [Fail Modes](https://www.failmodes.com) taxonomy — a machine-readable knowledge base of AI system failure modes.\n\nProvides four tools over 100+ canonical failure mode records spanning factuality, alignment, planning, code generation, instruction following, and more.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_failure_modes` | Search by symptom text or keyword phrase. Returns ranked matches. |\n| `get_failure_mode` | Retrieve the full structured record for a failure mode by ID slug. |\n| `list_categories` | List all taxonomy categories with descriptions and mode counts. |\n| `list_modes` | List all modes, optionally filtered by category ID. |\n\n## Quick Start\n\nNo installation required — run directly with `npx`:\n\n```bash\nnpx failmodes-mcp\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"failmodes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"failmodes-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor / VS Code\n\nAdd to your MCP settings file:\n\n```json\n{\n  \"mcpServers\": {\n    \"failmodes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"failmodes-mcp\"]\n    }\n  }\n}\n```\n\n### Remote (no install required)\n\nA hosted Streamable HTTP version is also available — no npm package needed:\n\n```json\n{\n  \"mcpServers\": {\n    \"failmodes\": {\n      \"url\": \"https://www.failmodes.com/api/mcp\"\n    }\n  }\n}\n```\n\n## How It Works\n\nOn first tool call, the server fetches current taxonomy data from [failmodes.com](https://www.failmodes.com) and caches it in memory for the duration of the session. Requires internet access.\n\nThe stdio transport makes this compatible with any MCP client that supports running local processes (Claude Desktop, Cursor, VS Code, etc.).\n\n## Links\n\n- Taxonomy source: [github.com/elyngved/failmodes-taxonomy](https://github.com/elyngved/failmodes-taxonomy)\n- Website: [failmodes.com](https://www.failmodes.com)\n- Remote MCP manifest: [failmodes.com/server.json](https://www.failmodes.com/server.json)\n\n## License\n\nMIT\n",
  "bytes": 2148,
  "sha": "66815c21750f5c57491c74caf8df1eb462419d86a5291e55d9e9804734f9ff24",
  "repo_slug": "elyngved/failmodes-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_elyngved_failmodes_1b5b68cf/readme"
}