DebugAI
About
MCP server that gives coding agents root cause and ready-to-apply fixes for any error, with a verified flag showing which fixes were mechanically checked.
Details
- Author
- 1shizaan
- Categories
- Developer Tools
Jump to
Setup
Install DebugAI in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/1shizaan/debugai-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Give your coding agent a debugger instead of a grep loop.
Your agent hands an error todebug_errorand gets back the root cause, the exact file and line, and up to 3 ranked fixes as ready-to-apply edits. Each fix is labeled with whether a mechanical check actually passed, so the agent knows which ones were checked and which are the model's own estimate.
Auto-configures Claude Code, Claude Desktop, Cursor, Windsurf, Zed, Gemini CLI, and Cline. Works in any other MCP client with a manual entry. Node 18 or later.
That is the whole thing. It signs you in through your browser (no key to find or copy), writes the config for every MCP client it finds on this machine, then checks that all of it actually works.
Restart the clients it names and your agent has the tools.
Prefer to read first?debugai.io/start?src=npmwalks the same thing per client.
Worth knowing before you run something that edits your editor config:
- Signs you in with a short code you confirm in the browser. Free account, 10 debugs a day, no card.
- Stores your key in~/.debugai/config.jsonwith0600permissions. That is the only file that ever holds it.
- Adds adebugaientry to the config of each MCP client it detects. Every file is backed up first (<file>.debugai-backup-<timestamp>), every other setting in the file is preserved, and a file it cannot parse is left alone and reported instead. One caveat stated plainly: if your config contains comments, the rewrite drops them, because JSON has nowhere to put them. You get a warning before it happens and the backup still has them.
- Skips VS Code by default, because theDebugAI extensionalready registers this server there and a second entry would show every tool twice.install --client=vscodedoes it anyway if you want the server without the extension.
- Never writes your key into a client config. Client configs get committed to repos. Keys should not.
npx -y @debugai/mcp uninstall # removes the entry from every client config npx -y @debugai/mcp logout # removes the stored key
npx -y @debugai/mcp install --listprints every supported client, where its config lives on your OS, and whether DebugAI is already in it.
If your agent calls a DebugAI tool before you have signed in, the tool answers with a short code and a URL instead of an error. Confirm it in the browser, tell the agent to try again, and the call goes through. No config editing, and no client restart, because the key is re-read on every call.
Returns the root cause, up to 3 fixes ranked by confidence, the detected framework, and whether the answer came from cache. Since 2.0 each fix also carries, where derivable:edits(exact old/new strings your agent's edit tool can apply directly),unified_diff, andverify_with(a syntax-level check command to run after applying). Read-only: it never touches your files. Applying a fix is your agent's call, and yours.
Every fix is labeled with its verification state, and there are three of them, not two:verified(a mechanical check passed, currently parse and import classes),failed check(confidence capped hard), ornot verified(the confidence number is the model's own estimate, nothing checked it). We label the third case instead of hiding it.
Tell DebugAI whether an applied fix actually worked.
Confirmed rank-1 fixes are remembered per project, so the next hit on the same error starts from the confirmed fix. Failed-fix follow-ups are the feedback that improves future answers. Agents are asked to call this once per applied fix, through the same pipeline human feedback flows through in the VS Code extension.
Paste a traceback and ask "why is this failing?". Claude callsdebug_errorand gets back something like:
Root cause:db.sessionis used after the request context closed.Fix 1 (94% confidence):move the query inside the request handler...
The server tells connecting agents what it is for, but a rule in your project file is the deterministic version. Add this toCLAUDE.md,.cursorrules, or whatever your agent reads:
On any runtime error, exception, or failing test, call the debugai debug_error tool before attempting your own fix. After applying a fix, call report_outcome so the project's error memory stays accurate.
You do not need this package. TheDebugAI extensionregisters the MCP server automatically (VS Code 1.101+) and adds one-click fix apply, proactive scan, and codebase indexing on top. It is onOpen VSXtoo, for Cursor, Windsurf, and VSCodium.
setupcovers this, andinstall --client=<id>covers the case where a client is installed somewhere unusual. If you would still rather edit the file yourself, the entry is the same everywhere:
{ "mcpServers": { "debugai": { "command": "npx", "args": ["-y", "@debugai/mcp"] } } }
Zed uses a different key and a nested command:
{ "context_servers": { "debugai": { "source": "custom", "command": { "path": "npx", "args": ["-y", "@debugai/mcp"] } } } }
Then runnpx -y @debugai/mcp loginonce to store your key. If you would rather set the key per client,DEBUGAI_API_KEYin that client'senvblock still works and still wins over the stored one.
- Free tier: 10 debugs/day. Pro ($12/mo): 1,000/mo soft cap, never hard-blocked at it.
- When you hit the daily cap the tool says so and stops. It will not silently retry.
- Simple errors route to a fast model. Ugly cross-file ones route to a stronger one on paid tiers. TheModel:badge in each response tells you which one answered.
- Analyses run on DebugAI's servers. The error text and any snippet you pass are sent there, and Claude (Anthropic) does the analysis. Privacy policy:debugai.io/privacy.
Runnpx -y @debugai/mcp doctorfirst. It checks your Node version, whether a key is stored and where it came from, whether that key still authenticates against the API, the permissions on the config file, and which detected clients are missing the DebugAI entry. Most answers are in that output.
- "authentication failed": the key was rotated or revoked. Runnpx -y @debugai/mcp login --force.
- Tools do not appear in the client: the client was not restarted, or it reads a different config file.install --listshows which file was written.
- Nothing happens onnpx @debugai/mcp: correct. It is a stdio server waiting for an MCP client to speak first. Use--helpto verify the install.
- Timeouts: deep analyses can take up to 90s. If your client has its own tool timeout, raise it above that.
2.1.1: metadata only. AddsmcpNamefor official MCP registry ownership verification, fixes the npm package page's repository link.
2.1.0: one-command setup. Browser sign-in over a device link (no key pasting), automatic client config writing with backups,doctorfor diagnosing a broken setup, and in-conversation sign-in when an agent calls a tool before you have an account.
2.0.0:report_outcometool, ready-to-applyeditsper fix, and the three-state verification label.
npm install npm test # builds, then runs unit + spawned-process e2e tests
The client is MIT and complete: the stdio server, the device-link sign-in, the config writer, and the tests are all here. The analysis itself runs on DebugAI's servers and is not part of this package.
Issues and pull requests are welcome on that repository.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





