autoheal-mcp

Connect Claude Code (and any MCP-compatible AI tool) directly to your AutoHeal production error monitoring.

With this MCP server, you can ask Claude things like:

• "What production errors broke overnight?"
• "Get me the fix for error abc123"
• "Open a GitHub PR with the AI fix for that login crash"
• "Give me the copy-paste prompt so I can paste it into Lovable"

Installation

Global install (recommended for Claude Code)

npm install -g autoheal-mcp

Or use directly with npx (no install needed)

npx autoheal-mcp

Getting your API key

1. Go to autohealai.com/settings
2. Generate an API key (starts with ah_)

Claude Code setup

Add this to your Claude Code MCP configuration (~/.claude/claude_desktop_config.json or your project's .mcp.json):

{
  "mcpServers": {
    "autoheal": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "autoheal-mcp"],
      "env": {
        "AUTOHEAL_API_KEY": "ah_your_key_here"
      }
    }
  }
}

Or, if you installed globally:

{
  "mcpServers": {
    "autoheal": {
      "type": "stdio",
      "command": "autoheal-mcp",
      "env": {
        "AUTOHEAL_API_KEY": "ah_your_key_here"
      }
    }
  }
}

Available tools

autoheal_list_errors

List recent production errors from your AutoHeal project.

Parameters:

• limit (optional, number, 1–50, default 10) — how many errors to return
• status (optional, string) — filter by status: "new" | "analyzing" | "analyzed" | "fixed" | "ignored"

Example prompts:

• "Show me my 20 most recent production errors"
• "List all new errors from AutoHeal"
• "What unresolved errors do I have?"

autoheal_get_fix

Get the full AI-generated fix for a specific production error, including explanation, root cause, confidence score, suggested code diff, and the fix prompt.

Parameters:

• error_id (required, string) — the error ID

Example prompts:

• "Get the AI fix for error abc123"
• "What does AutoHeal suggest for fixing error xyz789?"
• "Show me the suggested diff for that login crash"

autoheal_apply_fix

Create a GitHub PR with the AI-generated fix for an error. AutoHeal will open a pull request directly in your repo.

Parameters:

• fix_id (required, string) — the fix ID to apply

Example prompts:

• "Apply the fix for error abc123 and open a PR"
• "Create a GitHub PR with the AutoHeal fix"

autoheal_copy_fix

Get the copy-paste fix prompt for an error — ideal for vibe coders using Lovable, Replit, v0, Cursor, Bolt, or any AI coding platform. Returns the ready-to-paste prompt plus a plain-English explanation.

Parameters:

• error_id (required, string) — the error ID

Example prompts:

• "Give me the copy-paste fix prompt for error abc123"
• "I want to paste the fix into Lovable — what's the prompt?"
• "Get me the vibe-coder fix for that checkout crash"

autoheal_project_health

Check the health and status of your AutoHeal monitoring setup — project name, errors this month, quota usage, last error time, and monitoring status.

Parameters: none

Example prompts:

• "How is my AutoHeal monitoring doing?"
• "Check my error quota"
• "Is AutoHeal still receiving errors?"

Environment variables

| Variable | Description | |---|---| | AUTOHEAL_API_KEY | Your AutoHeal API key (required) | | AUTOHEAL_API_URL | Override API base URL (default: https://autohealai.com) |

You can also pass the API key as a CLI flag:

autoheal-mcp --api-key ah_your_key_here

Local development / testing

# Clone the repo
git clone https://github.com/hankmint/autoheal-ai
cd autoheal-ai/packages/autoheal-mcp

# Install deps & build
npm install
npm run build

# Test with your API key
AUTOHEAL_API_KEY=ah_your_key node dist/index.js

License

MIT — Knod, Inc.