# deadends.dev

Error knowledge database for AI coding agents. 2002 verified error patterns across 43 domains. Returns dead ends (what NOT to try) and workarounds (what works) for any error message. Covers Python, N…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add deadend/deadends-dev

# Browse available tools
npx -y @smithery/cli@latest tool list deadend/deadends-dev

# Get full schema for a tool
npx -y @smithery/cli@latest tool get deadend/deadends-dev lookup_error

# Call a tool
npx -y @smithery/cli@latest tool call deadend/deadends-dev lookup_error '{}'
```

## Direct MCP Connection

Endpoint: `https://deadends-dev--deadend.run.tools`

**Optional config:**
- `verbose` (query) — Include full workaround details and error chain info in responses
- `max_results` (query) — Maximum number of results per query (1-20)
- `preferred_domains` (query) — Comma-separated list of domains to prioritize (e.g. python,docker,node)

## Tools (8)

- `lookup_error` — Match an error message against deadends.dev's database of known errors. Returns dead ends (what NOT to try), workaround…
- `get_error_detail` — Get full details for a specific error by its ID (e.g., 'python/modulenotfounderror/py311-linux').
- `list_error_domains` — List all error domains and counts in the deadends.dev database.
- `search_errors` — Search errors by keyword across all domains. Uses fuzzy keyword search.
- `list_errors_by_domain` — List all errors in a specific domain with their fix rates.
- `batch_lookup` — Look up multiple error messages at once. Returns the best match for each error.
- `get_domain_stats` — Get detailed statistics for a domain: error counts, average fix rate, resolvability breakdown.
- `get_error_chain` — Traverse the error transition graph for a specific error. Shows leads_to, preceded_by, and frequently_confused_with.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get deadend/deadends-dev <tool-name>
```

## Resources

- `deadends://domains` — All 20 error domains with error counts and coverage statistics
- `deadends://index` — Complete index of all error patterns with IDs, signatures, domains, and fix rates

## Prompts (2)

- `debug_error` (error_message) — Get a structured debugging plan for an error, including dead ends to avoid and proven workarounds.
- `domain_overview` (domain) — Get an overview of error patterns, fix rates, and common pitfalls for a specific technology domain.