← FailMemory home · Dashboard · Quickstart

Install the FailMemory MCP Server

fail-memory-mcp is the official MCP server for FailMemory. It exposes one tool:

• fail_memory_lookup — ask the shared cache whether a given request is known to fail.

v1.0.0 is lookup-only. To contribute failure reports today, use the raw HTTP API with a signing wallet — see ./api-reference.md. MCP-native contribution (fail_memory_report) ships in v1.1.0.

Every configuration below points at the canonical URL https://failmemory.dev.

Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the fail-memory entry under mcpServers:

{
  "mcpServers": {
    "fail-memory": {
      "command": "npx",
      "args": ["-y", "fail-memory-mcp"],
      "env": {
        "FAILMEMORY_URL": "https://failmemory.dev"
      }
    }
  }
}

Fully quit and relaunch Claude Desktop. The fail_memory_lookup tool should appear in the tool list for any new chat.

Cursor

Open the Cursor settings and edit the MCP config (Settings → Features → Model Context Protocol), or edit ~/.cursor/mcp.json directly. Add:

{
  "mcpServers": {
    "fail-memory": {
      "command": "npx",
      "args": ["-y", "fail-memory-mcp"],
      "env": {
        "FAILMEMORY_URL": "https://failmemory.dev"
      }
    }
  }
}

Restart Cursor. Confirm the tool is wired in by asking the Cursor agent to list available tools.

Cline

In VS Code with the Cline extension installed, open the Cline MCP settings (command palette → "Cline: Open MCP Settings") and add:

{
  "mcpServers": {
    "fail-memory": {
      "command": "npx",
      "args": ["-y", "fail-memory-mcp"],
      "env": {
        "FAILMEMORY_URL": "https://failmemory.dev"
      }
    }
  }
}

Reload the window. Cline will pick up fail_memory_lookup on the next agent run.

Tool reference

fail_memory_lookup

Ask the shared cache whether a request is known to fail.

Input:

• method (string, required) — HTTP method, case-insensitive.
• url (string, required) — full URL. Normalized server-side per ./normalization.md.
• payload_hash (string, optional) — sha256 of the request payload if the client wants to scope the lookup to a specific body shape.

Output: a JSON object identical to the HTTP GET /v1/lookup response shape. See ./api-reference.md#get-v1lookup.

Each call costs $0.0005 against the configured credit balance, regardless of hit or miss. See ./credits.md.

Funding the agent's credit balance

The MCP server is a thin client; it does not hold any funds. Before the first lookup, deposit prepaid credits via x402/MPP. Full flow in ./credits.md.

v1.1.0 roadmap

fail_memory_report is not shipping in v1.0.0 (D-061). A safe signing story for MCP hosts is being designed — candidates include capability-based delegation to a wallet provider, a browser-assisted signing handoff, and a deposit-and-scoped-API-key flow for contributors without crypto tooling. Until then, the HTTP API at POST https://failmemory.dev/v1/report accepts signed reports from any caller who brings an x402/MPP wallet.