failmodes-mcp
MCP serverDocs & knowledgeGives your AI access to the Fail Modes taxonomy, a knowledge base of known AI system failure modes. Once added, your AI can look up documented failure modes and use that knowledge when you are designing, reviewing, or discussing AI systems.
Use failmodes-mcp in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add failmodes-mcp and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use failmodes-mcp to search failure modes
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
Details
Available today. Use it from your connected AI after setup.
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
Add the integration, then ask your AI about failure modes — for example, which ones could apply to a system you are building.
What your AI can do with it
- Look up known AI system failure modes in the taxonomy
- Answer questions about how AI systems commonly fail
- Reference documented failure modes when reviewing a design or plan
- Find failure modes that may apply to a system you describe
Install failmodes-mcp
The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.
Claude Code
claude mcp add --transport http --scope user failmodes-mcp 'https://www.failmodes.com/api/mcp'Run it once in your project, then open /mcp to approve any sign-in the server asks for.
Claude Desktop
https://www.failmodes.com/api/mcpAdd a custom connector in Settings, paste this address, and approve the sign-in.
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=failmodes-mcp&config=eyJ1cmwiOiJodHRwczovL3d3dy5mYWlsbW9kZXMuY29tL2FwaS9tY3AifQ==Open the link and Cursor adds the server at that address.
ChatGPT
https://www.failmodes.com/api/mcpIn Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.
Codex
codex mcp add failmodes-mcp --url 'https://www.failmodes.com/api/mcp'Run it once, then sign in with codex mcp login failmodes-mcp if the server asks for an account.
From the project's README
As published by elyngved/failmodes-mcp in README.md.
MCP server for the Fail Modes taxonomy — a machine-readable knowledge base of AI system failure modes.
Provides four tools over 100+ canonical failure mode records spanning factuality, alignment, planning, code generation, instruction following, and more.
Tools
| Tool | Description |
|---|---|
search_failure_modes | Search by symptom text or keyword phrase. Returns ranked matches. |
get_failure_mode | Retrieve the full structured record for a failure mode by ID slug. |
list_categories | List all taxonomy categories with descriptions and mode counts. |
list_modes | List all modes, optionally filtered by category ID. |
Quick Start
No installation required — run directly with npx:
npx failmodes-mcp
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"failmodes": {
"command": "npx",
"args": ["-y", "failmodes-mcp"]
}
}
}
Cursor / VS Code
Add to your MCP settings file:
{
"mcpServers": {
"failmodes": {
"command": "npx",
"args": ["-y", "failmodes-mcp"]
}
}
}
Remote (no install required)
A hosted Streamable HTTP version is also available — no npm package needed:
{
"mcpServers": {
"failmodes": {
"url": "https://www.failmodes.com/api/mcp"
}
}
}
How It Works
On first tool call, the server fetches current taxonomy data from failmodes.com and caches it in memory for the duration of the session. Requires internet access.
The stdio transport makes this compatible with any MCP client that supports running local processes (Claude Desktop, Cursor, VS Code, etc.).
Links
- Taxonomy source: github.com/elyngved/failmodes-taxonomy
- Website: failmodes.com
- Remote MCP manifest: failmodes.com/server.json
License
MIT
Tools it offers (4)
What this server listed when Ahel dialed its public endpoint in Sep 2026, with no key and no account of yours. The names are the server’s own.
search_failure_modesget_failure_modelist_categorieslist_modes
Signals
- Last commit
- Jul 2026
- Weekly downloads
- 39
Advanced
- Delivery
- failmodes MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
- Item type
- mcp-server
- Key
io-github-elyngved-failmodes- Source
- github.com/elyngved/failmodes-mcp
- Hosted endpoint
https://www.failmodes.com/api/mcp
github.com/elyngved/failmodes-mcp
More in Docs & knowledge
MCP server · dat999zx
More in Docs & knowledgeagent-native-slides
MCP server · builderio
More in Docs & knowledgemcp-memory-server
MCP server · mnemoverse
More in Docs & knowledgedatasinking
MCP server · heubme2020
More in Docs & knowledgespoken
MCP server · spokenmd
More in Docs & knowledgeemailmd
MCP server · anypost
More in Docs & knowledge