@rustrak/mcp

@rustrak/mcp is a Model Context Protocol server for Rustrak. Connect it to Claude Desktop, Cursor, Continue.dev, or any MCP-compatible AI assistant and get 27 tools to manage your error tracking without leaving your AI tool.


npx @rustrak/mcp   # run directly with npx (no install needed)
# or install globally
npm install -g @rustrak/mcp

Requirements: Node.js ≥ 18

How It Works

The server runs as a local stdio process — no open network port, no daemon. Your AI client starts it automatically when needed and communicates via JSON-RPC over stdin/stdout. The Rustrak API token is loaded from environment variables and never exposed as a tool argument.


AI Client (Claude / Cursor / Continue)
        │  stdio (JSON-RPC)
        ▼
┌─────────────────────┐
│   @rustrak/mcp      │
│   ├── projects      │
│   ├── issues        │
│   ├── events        │
│   ├── tokens        │
│   ├── alerts        │
│   └── team          │
└──────────┬──────────┘
           │  HTTP via @rustrak/client
           ▼
    Rustrak Server

Setup

1. Create an API token

In the Rustrak web UI: Settings → Tokens → Create token. Save the full token value — it is shown only once.

2. Configure your AI client

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json:


{
  "mcpServers": {
    "rustrak": {
      "command": "npx",
      "args": ["-y", "@rustrak/mcp"],
      "env": {
        "RUSTRAK_API_URL": "https://your-rustrak-instance.example.com",
        "RUSTRAK_API_TOKEN": "your-40-char-hex-token"
      }
    }
  }
}

Cursor — .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):


{
  "mcpServers": {
    "rustrak": {
      "command": "npx",
      "args": ["-y", "@rustrak/mcp"],
      "env": {
        "RUSTRAK_API_URL": "https://your-rustrak-instance.example.com",
        "RUSTRAK_API_TOKEN": "your-40-char-hex-token"
      }
    }
  }
}

Continue.dev — ~/.continue/config.json:


{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@rustrak/mcp"],
          "env": {
            "RUSTRAK_API_URL": "https://your-rustrak-instance.example.com",
            "RUSTRAK_API_TOKEN": "your-40-char-hex-token"
          }
        }
      }
    ]
  }
}

Environment Variables

Variable	Required	Description
`RUSTRAK_API_URL`	✅	Base URL of your Rustrak server
`RUSTRAK_API_TOKEN`	✅	40-char hex API token

The server exits immediately with a clear error message if either variable is missing.

Available Tools (27)

Projects

Tool	Description
`list_projects`	List all projects
`get_project`	Get project details including DSN
`create_project`	Create a new project

Issues

Tool	Description
`list_issues`	List issues with filters (open / resolved / muted / all)
`get_issue`	Get a single issue with full details
`resolve_issue`	Mark an issue as resolved
`unresolve_issue`	Re-open a resolved issue
`mute_issue`	Mute an issue (silences future alerts)
`delete_issue`	⚠️ Permanently delete an issue and all its events

Events

Tool	Description
`list_events`	List raw events for an issue (cursor pagination)
`get_event`	Get a single event with full Sentry envelope data

Tokens

Tool	Description
`list_tokens`	List API tokens (masked)
`create_token`	Create a new API token (full value shown once)
`revoke_token`	⚠️ Permanently revoke an API token

Alerts

Tool	Description
`list_alert_channels`	List notification channels (Slack, email, webhook)
`test_alert_channel`	Send a test notification to a channel
`list_alert_rules`	List alert rules for a project

Team & Access

Managing the team and invitations requires the API token to belong to an admin user (or be a legacy full-access token). Project-member tools require global-admin or project-admin access. See Team & Access.

Tool	Description
`list_team_members`	List instance users with their global role and status
`update_member_role`	Change a user’s global role (admin / member)
`remove_team_member`	⚠️ Permanently remove a user from the instance
`create_invitation`	Invite a person by email; returns a single-use invite token
`list_invitations`	List invitations (pending / accepted / revoked)
`revoke_invitation`	⚠️ Revoke a pending invitation
`list_project_members`	List a project’s members and their per-project roles
`set_project_member`	Add a user to a project or change their role (viewer / editor / admin)
`remove_project_member`	⚠️ Remove a user’s access to a project

Tools marked ⚠️ are annotated with destructiveHint — supported clients will prompt for confirmation before executing.

Example Prompts

Once connected, you can ask things like:

“List all unresolved issues in project 1”
“Show me the full stack trace for issue abc-123”
“Resolve all TypeError issues from the last deployment”
“Create a token called ‘CI pipeline’ and give me the value”
“How many events does issue xyz have?”
“Mute all database timeout issues”
“Invite alice@example.com as a member and give me the invite link”
“Add user 5 to project 1 as an editor”
“Who has access to project 3?”

Security Notes

The API token is loaded exclusively from RUSTRAK_API_TOKEN — it is never accepted as a tool argument
All tool errors are returned as isError: true content rather than exceptions, so your AI can see and handle them
The server uses stdio transport — it never opens a network port

@rustrak/client — The TypeScript HTTP client that powers this MCP server
API Tokens — How to create and manage tokens in the web UI
API Reference — Full REST API documentation