hackerdogs/sentry-mcp repository overview

⁠

⁠Sentry MCP Server

MCP server wrapper for Sentry⁠ — query issues, stack traces, release health, and Seer AI analysis from Sentry directly within AI coding assistants.

⁠What is Sentry?

Sentry is an application monitoring platform that captures errors, performance bottlenecks, and crashes from production software. The official @sentry/mcp-server package exposes Sentry's API as MCP tools, enabling AI assistants to list and search issues, fetch full stack traces, review release health, assign and resolve issues, and invoke Sentry's Seer AI for root-cause analysis. See getsentry/sentry-mcp⁠ for full documentation.

Auth token required — create a user auth token at Sentry under Settings → Account → API → Auth Tokens and set it as SENTRY_AUTH_TOKEN.

⁠Tools Reference

⁠Example Prompts

Here are example prompts you can use with Claude (or any MCP client) when this tool is connected:

• "Show me all unresolved Sentry issues in the 'backend-api' project with more than 100 occurrences."
• "Fetch the full stack trace for Sentry issue PROJ-1234 and explain what caused the error."
• "List the 10 most frequent errors in production this week and group them by type."
• "Check the release health for version 2.5.0 of my app and report the crash-free session rate."
• "Use Sentry's Seer AI to analyze issue PROJ-5678 and suggest a fix."
• "Mark all issues tagged 'low-priority' in the 'frontend' project as resolved."

⁠Deploy

⁠Docker Compose (recommended)

docker-compose up -d

⁠Docker Run (stdio mode)

docker run -i --rm \
  -e SENTRY_AUTH_TOKEN \
  hackerdogs/sentry-mcp:latest

⁠Docker Run (HTTP streamable mode)

docker run -d -p 8665:8665 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8665 \
  -e SENTRY_AUTH_TOKEN \
  hackerdogs/sentry-mcp:latest

⁠MCP Client Configuration

⁠Stdio mode (default)

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "sentry-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "SENTRY_AUTH_TOKEN",
        "hackerdogs/sentry-mcp:latest"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "SENTRY_AUTH_TOKEN": ""
      }
    }
  }
}

⁠HTTP mode (streamable-http)

First, start the server using Docker Compose or docker run with HTTP mode (see Deploy⁠ above), then point your MCP client at the running server:

{
  "mcpServers": {
    "sentry-mcp": {
      "url": "http://localhost:8665/mcp"
    }
  }
}

⁠Environment Variables

⁠Installing in Hackerdogs

The fastest way to get started is through Hackerdogs⁠:

1. Log in to your Hackerdogs account.
2. Go to the Tools Catalog.
3. Search for the tool by name.
4. Expand the tool card and click Install — you're ready to go.

1. Vendor API key required? Add your key in the config environment variable field before clicking Install. Your key will be encrypted at rest.
2. Enable / Disable the tool anytime from the Enabled Tools page.
3. Need to update a key or parameter? Go to My Tools → toggle Show Decrypted Values → edit → Save.

⁠Build

docker build -t hackerdogs/sentry-mcp:latest .

⁠Testing

⁠Automated tests

./test.sh

⁠Test directly with Docker

1. Start the server in HTTP mode:

docker run -d --rm --name sentry-mcp-test -p 8665:8665 \
  -e MCP_TRANSPORT=streamable-http \
  -e SENTRY_AUTH_TOKEN \
  hackerdogs/sentry-mcp:latest

2. Initialize the MCP session:

SESSION_ID=$(curl -s -D - -X POST http://localhost:8665/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' \
  2>&1 | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r\n')

curl -s -X POST http://localhost:8665/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

3. List available tools:

curl -s -X POST http://localhost:8665/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

4. Clean up:

docker stop sentry-mcp-test