Airbrake MCP Server

🚀 Airbrake MCP Server

The Model Context Protocol (MCP) server for Airbrake. It enables you to query errors, manage deploys, and fetch project stats directly from your MCP client.

🚀 Quick Start

The Airbrake MCP Server allows you to interact with Airbrake's services through the MCP client. Before starting, ensure you meet the requirements and complete the installation and configuration steps.

✨ Features

• Query errors, including listing recent errors, getting error details, and searching for errors.
• Manage deploys, such as listing recent deploys and creating deploy notifications.
• Fetch project stats to monitor project health.
• Support for various error management operations like resolving, ignoring, and reopening errors.

📦 Installation

Requirements

• Node.js 18+ (recommended 20+)
• Airbrake API key with read/write permissions
• Airbrake Project ID

Steps

npm install
npm run build

💻 Usage Examples

These depend on your MCP client, but typical prompts look like:

List the last 20 Airbrake errors
Get details for error 123456
Search errors for "NoMethodError"
Resolve error 123456

📚 Documentation

Configuration

Set the following environment variables:

export AIRBRAKE_API_KEY="your_api_key"
export AIRBRAKE_PROJECT_ID="your_project_id"
export AIRBRAKE_HOST="https://api.airbrake.io"  # optional

Where to get credentials

1. Open your project in Airbrake.
2. Go to Settings → API Keys.
3. Create a new API key with read/write permissions.
4. Your Project ID is in the project URL.

Configure in Cursor

Edit your global MCP config: /Users/<your-username>/.cursor/mcp.json

Example:

{
  "mcpServers": {
    "airbrake": {
      "command": "/absolute/path/to/node", // which node
      "args": ["/absolute/path/to/airbrake-mcp-server/dist/index.js"],
      "env": {
        "AIRBRAKE_API_KEY": "your_api_key",
        "AIRBRAKE_PROJECT_ID": "your_project_id"
      }
    }
  }
}

Notes

• Use absolute paths for command and args. Relative paths may fail because MCP is started from a different working directory.
• If you use a version manager (mise, nvm, asdf), point command to the actual Node binary shown by which node.
• If you want logs during startup, set AIRBRAKE_MCP_DEBUG=1 in env.

Tools (Available Commands)

Error Queries

• list_errors: List recent errors (pagination supported)
• get_error_details: Full details for a specific error group
• get_error_notices: All occurrences (notices) for an error group
• get_notice_details: Full details of a single notice

Search & Filter

• search_errors: Text search across errors
• filter_errors_by_status: Filter by open, resolved, or ignored
• get_error_trend: Occurrence trend over time

Error Management

• resolve_error: Mark error as resolved
• ignore_error: Mark error as ignored
• reopen_error: Reopen a resolved/ignored error

Deploys

• list_deploys: List recent deploys
• create_deploy: Create a deploy notification

Stats

• get_project_stats: Project health and statistics

🔧 Technical Details

Development

npm run watch
npm run dev

📄 License

This README does not contain license information, so this section is skipped.

Resources

• Airbrake API docs: https://airbrake.io/docs/api/
• MCP: https://modelcontextprotocol.io/