Bugsnag MCP connector

OAuth 2.1/DCR MonitoringDeveloper ToolsAI

Connect to Bugsnag MCP. Monitor errors, releases, traces, and span groups across your projects from your AI workflows.

Bugsnag MCP connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'bugsnagmcp'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize Bugsnag MCP:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'bugsnagmcp_bugsnag_get_current_project',
25
  toolInput: {},
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "bugsnagmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Bugsnag MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="bugsnagmcp_bugsnag_get_current_project",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

Connect this agent connector to let your agent:

Update bugsnag — Update the status of an error (e.g., ignore, snooze, open, or mark as fixed)
Groupings bugsnag set network endpoint — Set network endpoint grouping rules for a project
List bugsnag — Retrieve available trace attribute fields for filtering
Get bugsnag — Retrieve all spans within a specific distributed trace

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

bugsnagmcp_bugsnag_get_build # Retrieve details for a specific build by its ID, including source control metadata. 2 params

Retrieve details for a specific build by its ID, including source control metadata.

Name Type Required Description

buildId string required Unique identifier of the app build

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_get_current_project # Retrieve the default project set for the current session. Tools use this project when no projectId is specified. 0 params

Retrieve the default project set for the current session. Tools use this project when no projectId is specified.

bugsnagmcp_bugsnag_get_error # Retrieve full details on an error, including aggregated stats across all occurrences and the latest event's stacktrace, breadcrumbs, and metadata. 3 params

Retrieve full details on an error, including aggregated stats across all occurrences and the latest event's stacktrace, breadcrumbs, and metadata.

Name Type Required Description

errorId string required Unique identifier of the error to retrieve

filters object optional Apply filters to narrow down the error list. Use the List Project Event Filters tool to discover available filter fields. Time filters support extended ISO 8601 format (e.g. 2018-05-20T00:00:00Z) or relative format (e.g. 7d, 24h).

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_get_event # Retrieve detailed information about a specific error event by its ID. 2 params

Retrieve detailed information about a specific error event by its ID.

Name Type Required Description

eventId string required Unique identifier of the event

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_get_event_details_from_dashboard_url # Retrieve event details using a Bugsnag dashboard URL. 1 param

Retrieve event details using a Bugsnag dashboard URL.

Name Type Required Description

link string required Full URL to the event details page in the BugSnag dashboard (web interface), containing project slug and event_id parameter.

bugsnagmcp_bugsnag_get_events_on_an_error # List events (occurrences) grouped under a specific error. 6 params

List events (occurrences) grouped under a specific error.

Name Type Required Description

errorId string required Unique identifier of the error

direction string optional Sort direction for ordering results

filters object optional Apply filters to narrow down the event list. Use the List Project Event Filters tool to discover available filter fields. Time filters support extended ISO 8601 format (e.g. 2018-05-20T00:00:00Z) or relative format (e.g. 7d, 24h).

nextUrl string optional URL for retrieving the next page of results. Use the value in the previous response to get the next page when more results are available. Only values provided in the output from this tool can be used. Do not attempt to construct it manually.

perPage number optional How many results to return per page.

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_get_network_endpoint_groupings # Retrieve the network endpoint grouping rules configured for a project. 1 param

Retrieve the network endpoint grouping rules configured for a project.

Name Type Required Description

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_get_release # Retrieve details for a specific release by its ID, including source control info and associated builds. 2 params

Retrieve details for a specific release by its ID, including source control info and associated builds.

Name Type Required Description

releaseId string required Unique identifier of the app release

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_get_span_group # Retrieve performance metrics for a specific span group. 3 params

Retrieve performance metrics for a specific span group.

Name Type Required Description

spanGroupId string required ID of the span group

filters object optional Apply filters to narrow down the span group list. Use the List Trace Fields tool to discover available filter fields. Time filters support extended ISO 8601 format (e.g. 2018-05-20T00:00:00Z) or relative format (e.g. 7d, 24h).

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_get_trace # Retrieve all spans within a specific distributed trace. 7 params

Retrieve all spans within a specific distributed trace.

Name Type Required Description

from string required Start time (ISO 8601 format)

to string required End time (ISO 8601 format)

traceId string required Trace ID

perPage number optional How many results to return per page.

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

targetSpanId string optional Optional target span ID to focus on

bugsnagmcp_bugsnag_list_project_errors # List and search errors in a project with filters, sorting, and pagination. 6 params

List and search errors in a project with filters, sorting, and pagination.

Name Type Required Description

direction string optional Sort direction for ordering results

perPage number optional How many results to return per page.

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

sort string optional Field to sort the errors by

bugsnagmcp_bugsnag_list_project_event_filters # Retrieve available event filter fields for a project. 1 param

Retrieve available event filter fields for a project.

Name Type Required Description

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_list_projects # List all projects in the organization the current user can access, or find a project by API key. 1 param

List all projects in the organization the current user can access, or find a project by API key.

Name Type Required Description

apiKey string optional The API key of the BugSnag project, if known.

bugsnagmcp_bugsnag_list_releases # List releases for a project with optional stage and visibility filters. 5 params

List releases for a project with optional stage and visibility filters.

Name Type Required Description

perPage number optional How many results to return per page.

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

releaseStage string optional Filter releases by this stage (e.g. production, staging), defaults to 'production'

visibleOnly boolean optional Whether to only include releases that are marked as visible in the dashboard

bugsnagmcp_bugsnag_list_span_groups # List span groups (tracked operations) for performance monitoring in a project. 7 params

List span groups (tracked operations) for performance monitoring in a project.

Name Type Required Description

direction string optional Sort direction for ordering results

perPage number optional How many results to return per page.

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

sort string optional Field to sort by

starredOnly boolean optional Show only starred span groups

bugsnagmcp_bugsnag_list_spans # List individual spans belonging to a span group. 7 params

List individual spans belonging to a span group.

Name Type Required Description

spanGroupId string required ID of the span group

direction string optional Sort direction for ordering results

perPage number optional How many results to return per page.

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

sort string optional Field to sort by

bugsnagmcp_bugsnag_list_trace_fields # Retrieve available trace attribute fields for filtering. 1 param

Retrieve available trace attribute fields for filtering.

Name Type Required Description

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_set_network_endpoint_groupings # Set network endpoint grouping rules for a project. 2 params

Set network endpoint grouping rules for a project.

Name Type Required Description

endpoints array required Array of URL patterns by which network spans are grouped. Endpoints follow OpenAPI path templating syntax (https://swagger.io/specification/#path-templating) where path parameters use curly braces (e.g., /users/{id}). If you encounter colon-prefixed parameters (e.g., :userId from Express/React Router), convert them to curly braces (e.g., {userId}). Wildcards (*) can be used in domains (e.g., https://*.example.com) to match multiple subdomains.

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

bugsnagmcp_bugsnag_update_error # Update the status of an error (e.g., ignore, snooze, open, or mark as fixed). 5 params

Update the status of an error (e.g., ignore, snooze, open, or mark as fixed).

Name Type Required Description

errorId string required Unique identifier of the error

operation string required The operation to apply to the error

issue_url string optional The URL of the issue to link to the error - required when operation is 'link_issue'

projectId string optional Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.

reopenRules object optional Reopen rules for snooze operation - required when operation is 'snooze'

Bugsnag MCP connector

Bugsnag MCP connector

Install the SDK

Set your credentials

Authorize and make your first call

What you can do

Tool list