Structured failure knowledge for AI agents — dead ends, workarounds, error chains
Connect Deadends.Dev to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Structured failure knowledge for AI agents — dead ends, workarounds, error chains. The deadends.dev mcp server is what makes that connection.
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:
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
lookup_error — Match an error message against 2000+ known patternsget_error_detail — Full canon by IDlist_error_domains — All 54 domains with countssearch_errors — TF-IDF keyword search across all domainslist_errors_by_domain — All errors in a domainlist_errors_by_country — All country-scoped dead ends for an ISO alpha-2 codeget_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 levelsget_error_chain — Traverse the error transition graphreport_outcome — Report whether a workaround worked (feeds back into success rates)Endpoint — DescriptionInstallation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Deadends.Dev's toolset — lookup_error, get_error_detail, list_error_domains and 9 more — is a fair guide to whether it matches your workflow. It is maintained by dev.deadends; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Deadends.Dev's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| 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) |
| Endpoint | Description |
{
"mcpServers": {
"deadend": {
"serverUrl": "https://deadends.dev/mcp",
"type": "http"
}
}
}Configuration as documented by the project. Restart the client after saving.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.