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 informationROLLBAR_ACCOUNT_TOKEN: Rollbar Account Access Token - Required for APIs to access account-wide project and user informationROLLBAR_PROJECT_ID: Default project ID (used when not specified in requests) - OptionalROLLBAR_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:
- Log in to your Rollbar account (https://rollbar.com/)
- For project tokens: Settings -> Project Access Tokens (for project-level access)
- For account tokens: Settings -> Account Access Tokens (for account-level access)
- 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 occurrenceslimit(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 IDenvironment(string, optional): Environment namelimit(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