Bugsnag MCP connector

OAuth 2.1/DCRMonitoringDeveloper 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.

NameTypeRequiredDescription

buildIdstringrequiredUnique identifier of the app build

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

errorIdstringrequiredUnique identifier of the error to retrieve

filtersobjectoptionalApply 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).

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

eventIdstringrequiredUnique identifier of the event

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

linkstringrequiredFull 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.

NameTypeRequiredDescription

errorIdstringrequiredUnique identifier of the error

directionstringoptionalSort direction for ordering results

filtersobjectoptionalApply 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).

nextUrlstringoptionalURL 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.

perPagenumberoptionalHow many results to return per page.

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

releaseIdstringrequiredUnique identifier of the app release

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

spanGroupIdstringrequiredID of the span group

filtersobjectoptionalApply 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).

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

fromstringrequiredStart time (ISO 8601 format)

tostringrequiredEnd time (ISO 8601 format)

traceIdstringrequiredTrace ID

perPagenumberoptionalHow many results to return per page.

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

targetSpanIdstringoptionalOptional 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.

NameTypeRequiredDescription

directionstringoptionalSort direction for ordering results

perPagenumberoptionalHow many results to return per page.

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

sortstringoptionalField 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.

NameTypeRequiredDescription

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

apiKeystringoptionalThe 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.

NameTypeRequiredDescription

perPagenumberoptionalHow many results to return per page.

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

releaseStagestringoptionalFilter releases by this stage (e.g. production, staging), defaults to 'production'

visibleOnlybooleanoptionalWhether 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.

NameTypeRequiredDescription

directionstringoptionalSort direction for ordering results

perPagenumberoptionalHow many results to return per page.

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

sortstringoptionalField to sort by

starredOnlybooleanoptionalShow 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.

NameTypeRequiredDescription

spanGroupIdstringrequiredID of the span group

directionstringoptionalSort direction for ordering results

perPagenumberoptionalHow many results to return per page.

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

sortstringoptionalField to sort by

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

Retrieve available trace attribute fields for filtering.

NameTypeRequiredDescription

projectIdstringoptionalUnique 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.

NameTypeRequiredDescription

endpointsarrayrequiredArray 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.

projectIdstringoptionalUnique 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).

NameTypeRequiredDescription

errorIdstringrequiredUnique identifier of the error

operationstringrequiredThe operation to apply to the error

issue_urlstringoptionalThe URL of the issue to link to the error - required when operation is 'link_issue'

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

reopenRulesobjectoptionalReopen 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