dbwls99706 avatar

deadends.dev

dbwls99706/deadends.dev

Exposes 11 tools that look up structured failure knowledge across 2,000+ code errors and country-specific dead ends. You get back regex-matched patterns showing what not to try (with failure rates), what works (with success rates), and error chains that predict downstream failures. Useful when you want an agent to skip known-bad fixes like sudo pip or avoid cultural missteps like tipping in Tokyo. Also includes batch lookup, domain stats, and outcome reporting to feed real results back into the dataset. The full canon pulls from government sources for country rules and community validation for code fixes. Python SDK available, or call the JSON API directly at deadends.dev/api/v1.

tools
8
transport
STDIO, HTTP
last updated
Aug 13, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

lookup_errorMatch an error message against deadends.dev's database of known errors. Returns dead ends (what NOT to try), workarounds (what works), and error chains (what comes next).1 params

Match an error message against deadends.dev's database of known errors. Returns dead ends (what NOT to try), workarounds (what works), and error chains (what comes next).

Parameters* required
error_messagestring
The full error message to look up
get_error_detailGet full details for a specific error by its ID (e.g., 'python/modulenotfounderror/py311-linux').1 params

Get full details for a specific error by its ID (e.g., 'python/modulenotfounderror/py311-linux').

Parameters* required
error_idstring
The error ID (domain/slug/env)
list_error_domainsList all error domains and counts in the deadends.dev database.1 params

List all error domains and counts in the deadends.dev database.

Parameters* required
sort_bystring
Sort domains by: 'count' (default, most errors first) or 'name' (alphabetical)
search_errorsSearch errors by keyword across all domains. Uses fuzzy keyword search.3 params

Search errors by keyword across all domains. Uses fuzzy keyword search.

Parameters* required
domainstring
Optional: filter to a specific domain (e.g., 'python', 'docker')
limitinteger
Max results to return (default: 10)
querystring
Search keywords (e.g., 'memory limit', 'timeout', 'permission denied')
list_errors_by_domainList all errors in a specific domain with their fix rates.2 params

List all errors in a specific domain with their fix rates.

Parameters* required
domainstring
The domain to list errors for (e.g., 'python', 'kubernetes')
sort_bystring
Sort by: 'fix_rate' (default), 'name', or 'confidence'
batch_lookupLook up multiple error messages at once. Returns the best match for each error.1 params

Look up multiple error messages at once. Returns the best match for each error.

Parameters* required
error_messagesarray
List of error messages to look up (max 10)
get_domain_statsGet detailed statistics for a domain: error counts, average fix rate, resolvability breakdown.1 params

Get detailed statistics for a domain: error counts, average fix rate, resolvability breakdown.

Parameters* required
domainstring
The domain to get stats for
get_error_chainTraverse the error transition graph for a specific error. Shows leads_to, preceded_by, and frequently_confused_with.1 params

Traverse the error transition graph for a specific error. Shows leads_to, preceded_by, and frequently_confused_with.

Parameters* required
error_idstring
The error ID (domain/slug/env) to get the transition graph for

Sponsors

Readme

deadends.dev

Precision@1 MRR Entries Domains Countries MCP Tools PyPI License

Stop AI agents from repeating known failures - in code AND in the real world.

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:


View the full README on GitHub

Details

Repository
github.com/dbwls99706/deadends.dev
Website
deadends.dev
Category
Documents & Knowledge
Package
deadends-dev
Transport
STDIO, HTTP
Registry
MCP registry, active

Related Documents & Knowledge MCP servers

View all
1swwyymm avatarExtractswwyymm/averra-extract-mcpURL-to-Markdown API for AI pipelines — clean markdown with metadata and caching.0stars
2capturekitdev avatarCaptureKitcapturekitdev/capturekit-mcpCapture websites as PNG, JPEG, WebP or PDF, extract their content, or analyse them with AI.0stars
3dmitry-kov avatarooxml-integritydmitry-kov/ooxml-integrityChecks .docx and .pptx files after automated editing for lost comments, tracked changes and notes.0stars
4dotnova avatarContextLayerdotnova/context-layerIntelligent context infrastructure for AI teams: knowledge graph, sessions, tasks, documents.0stars
5essatt avatarKnowman Mcpessatt/knowman-mcpKnowMan MCP server: search, ask, save and read your Knowledge Base from any MCP client.0stars
6execufunction-mcp avatarSiftableexecufunction-mcp/mcp-serverSiftable MCP server for governed work, knowledge, calendar, people, datasets, and Vault.0stars