How do I install the deadends.dev mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Deadends.Dev MCP Server

Structured failure knowledge for AI agents — dead ends, workarounds, error chains

Local serverstdioPython

What is the Deadends.Dev MCP Server?

Structured failure knowledge for AI agents — dead ends, workarounds, error chains

What the server does

AI assistants reliably fumble two kinds of problems: known-failed code fixes, and country-specific real-world rules they've never been exposed to in training. deadends.dev now covers both:

Deterministic — Same query → same answer, every time. No hallucination
Country-scoped — ID format {domain}/{slug}/{env} - env holds the country
Primary-sourced — Every country canon cites government sites, embassies,
Community-validated — Fix success rates updated from real outcome reports
Sub-millisecond — Local regex matching, no API roundtrip

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
lookup_error	Match an error message against 2000+ known patterns
get_error_detail	Full canon by ID
list_error_domains	All 54 domains with counts
search_errors	TF-IDF keyword search across all domains
list_errors_by_domain	All errors in a domain
list_errors_by_country	All country-scoped dead ends for an ISO alpha-2 code
get_country_summary	Country-level summary (entries, fix rate, domain mix)
batch_lookup	Look up multiple errors at once (max 10)
get_domain_stats	Domain quality metrics and confidence levels
get_error_chain	Traverse the error transition graph
report_outcome	Report whether a workaround worked (feeds back into success rates)

How to install the Deadends.Dev MCP Server

{
  "mcpServers": {
    "deadend": {
      "serverUrl": "https://deadends.dev/mcp",
      "type": "http"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

“Use Deadends.Dev to lookup error.”
“Use Deadends.Dev to get error detail.”
“Use Deadends.Dev to list error domains.”

Frequently asked questions

Structured failure knowledge for AI agents — dead ends, workarounds, error chains Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.