@hiyorineko/mcp-rollbar-server

Rollbar MCP Server

A dynamic MCP server implementation for Rollbar API integration, enabling LLMs to interact with Rollbar error tracking data.

Features

• List and filter error items
• Get detailed error information
• View error occurrences
• Access project and environment details
• Track deployments
• List users and teams

Configuration

Environment Variables

• ROLLBAR_PROJECT_TOKEN: Rollbar Project Access Token - Required for APIs to retrieve project error and deployment information
• ROLLBAR_ACCOUNT_TOKEN: Rollbar Account Access Token - Required for APIs to access account-wide project and user information
• ROLLBAR_PROJECT_ID: Default project ID (used when not specified in requests) - Optional
• ROLLBAR_PROJECT_NAME: Default project name for reference - Optional

Note: Depending on the features you use, you'll need either ROLLBAR_PROJECT_TOKEN, ROLLBAR_ACCOUNT_TOKEN, or both. For full functionality, it's recommended to configure both tokens, but the service will work with only the relevant token for specific APIs.

Required Tokens and API Correspondence Table

API	Required Token
rollbar_list_items	ROLLBAR_PROJECT_TOKEN
rollbar_get_item	ROLLBAR_PROJECT_TOKEN
rollbar_get_item_by_counter	ROLLBAR_PROJECT_TOKEN
rollbar_list_occurrences	ROLLBAR_PROJECT_TOKEN
rollbar_get_occurrence	ROLLBAR_PROJECT_TOKEN
rollbar_list_environments	ROLLBAR_PROJECT_TOKEN
rollbar_list_deploys	ROLLBAR_PROJECT_TOKEN
rollbar_get_deploy	ROLLBAR_PROJECT_TOKEN
rollbar_list_projects	ROLLBAR_ACCOUNT_TOKEN
rollbar_get_project	ROLLBAR_ACCOUNT_TOKEN
rollbar_list_users	ROLLBAR_ACCOUNT_TOKEN
rollbar_get_user	ROLLBAR_ACCOUNT_TOKEN

You can obtain Rollbar access tokens as follows:

1. Log in to your Rollbar account (https://rollbar.com/)
2. For project tokens: Settings -> Project Access Tokens (for project-level access)
3. For account tokens: Settings -> Account Access Tokens (for account-level access)
4. Create a new token with "read" scope

How to use

Cursor Integration

Add to your ~/.cursor/mcp.json:

{
    "mcpServers": {
      "rollbar-mcp": {
        "command": "npx",
        "args": ["-y", "@hiyorineko/mcp-rollbar-server"],
        "env": {
          "ROLLBAR_PROJECT_TOKEN": "YOUR_PROJECT_ACCESS_TOKEN",
          "ROLLBAR_ACCOUNT_TOKEN": "YOUR_ACCOUNT_ACCESS_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

Locally

After cloning this repository, follow these steps to set up the MCP client:

$ cd mcp-rollbar-server
$ npm install
$ npm run build

Add to your ~/.cursor/mcp.json:

{
    "mcpServers": {
      "rollbar-mcp": {
        "command": "YOUR_NODE_PATH",
        "args": ["YOUR_PROJECT_PATH/mcp-rollbar-server/dist/src/index.js"],
        "env": {
          "ROLLBAR_PROJECT_TOKEN": "YOUR_PROJECT_ACCESS_TOKEN",
          "ROLLBAR_ACCOUNT_TOKEN": "YOUR_ACCOUNT_ACCESS_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

To find the value for "YOUR_NODE_PATH", run which node in your terminal.

Usage Examples

List the most recent errors in my production environment.

View Error Details

Get detailed information for error item with ID 12345, including stack trace and recent occurrences.

Track Deployments

Show me the recent deployments for project 67890.

Filter Errors by Level

List all critical errors that occurred in the last week.

Tools

rollbar_list_items

List items (errors) from Rollbar

• Input:
  • status (string, optional): Filter by status (active, resolved, muted, etc.)
  • level (string, optional): Filter by level (critical, error, warning, info, debug)
  • environment (string, optional): Filter by environment (production, staging, etc.)
  • limit (number, optional): Maximum number of items to return (default: 20)
  • page (number, optional): Page number for pagination (default: 1)
• Returns: List of error items with details such as counter, level, total occurrences, etc.

rollbar_get_item

Get a specific item (error) from Rollbar using the internal item ID maintained by Rollbar's system.

• Input:
  • id (number): Item ID
• Returns: Detailed information about a specific error item

rollbar_get_item_by_counter

Get a specific item by project counter from Rollbar. The counter is the visible ID that appears in the Rollbar UI.

• Input:
  • counter (number): Project counter for the item
• Returns: Detailed information about a specific error item identified by its project counter

rollbar_list_occurrences

List occurrences of errors from Rollbar

• Input:
  • itemId (number, optional): Item ID to filter occurrences
  • limit (number, optional): Maximum number of occurrences to return (default: 20)
  • page (number, optional): Page number for pagination (default: 1)
• Returns: List of error occurrences with detailed information

rollbar_get_occurrence

Get a specific occurrence of an error from Rollbar

• Input:
  • id (string): Occurrence ID
• Returns: Detailed information about a specific error occurrence

rollbar_list_projects

List projects from Rollbar

• Input: None
• Returns: List of projects with their IDs, names, and statuses

rollbar_get_project

Get a specific project from Rollbar

• Input:
  • id (number): Project ID
• Returns: Detailed information about a specific project

rollbar_list_environments

List environments from Rollbar

• Input:
  • projectId (number): Project ID
• Returns: List of environments for the specified project

rollbar_list_users

List users from Rollbar

• Input: None
• Returns: List of users with their IDs, usernames, emails, and access levels

rollbar_get_user

Get a specific user from Rollbar

• Input:
  • id (number): User ID
• Returns: Detailed information about a specific user

rollbar_list_deploys

List deploys from Rollbar

• Input:
  • projectId (number): Project ID
  • environment (string, optional): Environment name
  • limit (number, optional): Maximum number of deploys to return (default: 20)
  • page (number, optional): Page number for pagination (default: 1)
• Returns: List of deploys for the specified project and environment

rollbar_get_deploy

Get a specific deploy from Rollbar

• Input:
  • deployId (number): Deploy ID
• Returns: Detailed information about a specific deployment