failmodes-mcp

MCP serverDocs & knowledge

Gives 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

Details

Available today. Use it from your connected AI after setup.

Add the integration, then ask your AI about failure modes — for example, which ones could apply to a system you are building.

failmodes-mcpStart free

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/mcp

    Add 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/mcp

    In 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

ToolDescription
search_failure_modesSearch by symptom text or keyword phrase. Returns ranked matches.
get_failure_modeRetrieve the full structured record for a failure mode by ID slug.
list_categoriesList all taxonomy categories with descriptions and mode counts.
list_modesList 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

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_modes
  • get_failure_mode
  • list_categories
  • list_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