The Bugsnag MCP connector routes your AI agent's tool calls to Bugsnag's own MCP server through Scalekit. Each user signs in to Bugsnag once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 19 tools.
- Tools
- 19
- What they doRead · write · destructive
- 17 · 2 · 017 read2 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Bugsnag MCP connection
In AgentKit > Connections, create a Bugsnag MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for Bugsnag MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'bugsnagmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Bugsnag MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'bugsnagmcp_bugsnag_get_current_project',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "bugsnagmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Bugsnag MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="bugsnagmcp_bugsnag_get_current_project",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolbugsnagmcp_bugsnag_get_buildRetrieve details for a specific build by its ID, including source control metadata.Read-onlyGet Build
Retrieve details for a specific build by its ID, including source control metadata.
Inputs
buildIdstringrequired- Unique identifier of the app build
projectIdstring- 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_projectRetrieve the default project set for the current session.Read-onlyGet Current Project
Retrieve the default project set for the current session. Tools use this project when no projectId is specified.
Inputs
This tool takes no inputs.
bugsnagmcp_bugsnag_get_errorRetrieve full details on an error, including aggregated stats across all occurrences and the latest event's stacktrace, breadcrumbs, and metadata.Read-onlyGet Error
Retrieve full details on an error, including aggregated stats across all occurrences and the latest event's stacktrace, breadcrumbs, and metadata.
Inputs
errorIdstringrequired- Unique identifier of the error to retrieve
filtersobject- 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).
projectIdstring- 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_eventRetrieve detailed information about a specific error event by its ID.Read-onlyGet Event
Retrieve detailed information about a specific error event by its ID.
Inputs
eventIdstringrequired- Unique identifier of the event
projectIdstring- 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_urlRetrieve event details using a Bugsnag dashboard URL.Read-onlyGet Event From Dashboard URL
Retrieve event details using a Bugsnag dashboard URL.
Inputs
linkstringrequired- 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_errorList events (occurrences) grouped under a specific error.Read-onlyGet Events On Error
List events (occurrences) grouped under a specific error.
Inputs
errorIdstringrequired- Unique identifier of the error
directionstring- Sort direction for ordering resultsone of
ascdescdefaultdesc filtersobject- 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).
nextUrlstring- 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.
perPagenumber- How many results to return per page.default
30 projectIdstring- 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_groupingsRetrieve the network endpoint grouping rules configured for a project.Read-onlyGet Network Endpoint Groupings
Retrieve the network endpoint grouping rules configured for a project.
Inputs
projectIdstring- 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_releaseRetrieve details for a specific release by its ID, including source control info and associated builds.Read-onlyGet Release
Retrieve details for a specific release by its ID, including source control info and associated builds.
Inputs
releaseIdstringrequired- Unique identifier of the app release
projectIdstring- 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_groupRetrieve performance metrics for a specific span group.Read-onlyGet Span Group
Retrieve performance metrics for a specific span group.
Inputs
spanGroupIdstringrequired- ID of the span group
filtersobject- 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).
projectIdstring- 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_traceRetrieve all spans within a specific distributed trace.Read-onlyGet Trace
Retrieve all spans within a specific distributed trace.
Inputs
fromstringrequired- Start time (ISO 8601 format)
tostringrequired- End time (ISO 8601 format)
traceIdstringrequired- Trace ID
nextUrlstring- 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.
perPagenumber- How many results to return per page.default
30 projectIdstring- 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.
targetSpanIdstring- Optional target span ID to focus on
bugsnagmcp_bugsnag_list_project_errorsList and search errors in a project with filters, sorting, and pagination.Read-onlyList Project Errors
List and search errors in a project with filters, sorting, and pagination.
Inputs
directionstring- Sort direction for ordering resultsone of
ascdescdefaultdesc filtersobject- 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).
nextUrlstring- 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.
perPagenumber- How many results to return per page.default
30 projectIdstring- 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.
sortstring- Field to sort the errors byone of
first_seenlast_seeneventsusersunsorteddefaultlast_seen
bugsnagmcp_bugsnag_list_project_event_filtersRetrieve available event filter fields for a project.Read-onlyList Project Event Filters
Retrieve available event filter fields for a project.
Inputs
projectIdstring- 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_projectsList all projects in the organization the current user can access, or find a project by API key.Read-onlyList Projects
List all projects in the organization the current user can access, or find a project by API key.
Inputs
apiKeystring- The API key of the BugSnag project, if known.
bugsnagmcp_bugsnag_list_releasesList releases for a project with optional stage and visibility filters.Read-onlyList Releases
List releases for a project with optional stage and visibility filters.
Inputs
nextUrlstring- 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.
perPagenumber- How many results to return per page.default
30 projectIdstring- 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.
releaseStagestring- Filter releases by this stage (e.g. production, staging), defaults to 'production'default
production visibleOnlyboolean- Whether to only include releases that are marked as visible in the dashboarddefault
false
bugsnagmcp_bugsnag_list_span_groupsList span groups (tracked operations) for performance monitoring in a project.Read-onlyList Span Groups
List span groups (tracked operations) for performance monitoring in a project.
Inputs
directionstring- Sort direction for ordering resultsone of
ascdescdefaultdesc filtersobject- 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).
nextUrlstring- 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.
perPagenumber- How many results to return per page.default
30 projectIdstring- 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.
sortstring- Field to sort byone of
total_spanslast_seennamedisplay_namenetwork_http_methodrendering_slow_frame_span_percentagerendering_frozen_frame_span_percentageduration_p50duration_p75duration_p90duration_p95duration_p99system_metrics_cpu_total_mean_p50system_metrics_cpu_total_mean_p75system_metrics_cpu_total_mean_p90system_metrics_cpu_total_mean_p95system_metrics_cpu_total_mean_p99system_metrics_memory_device_mean_p50system_metrics_memory_device_mean_p75system_metrics_memory_device_mean_p90system_metrics_memory_device_mean_p95system_metrics_memory_device_mean_p99rendering_metrics_fps_mean_p50rendering_metrics_fps_mean_p75rendering_metrics_fps_mean_p90rendering_metrics_fps_mean_p95rendering_metrics_fps_mean_p99http_response_4xx_percentagehttp_response_5xx_percentage starredOnlyboolean- Show only starred span groups
bugsnagmcp_bugsnag_list_spansList individual spans belonging to a span group.Read-onlyList Spans
List individual spans belonging to a span group.
Inputs
spanGroupIdstringrequired- ID of the span group
directionstring- Sort direction for ordering resultsone of
ascdescdefaultdesc filtersobject- 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).
nextUrlstring- 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.
perPagenumber- How many results to return per page.default
30 projectIdstring- 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.
sortstring- Field to sort byone of
durationtimestampfull_page_load_lcpfull_page_load_fidfull_page_load_clsfull_page_load_ttfbfull_page_load_fcprendering_slow_frame_percentagerendering_frozen_frame_percentagesystem_metrics_cpu_total_meansystem_metrics_memory_device_meanrendering_metrics_fps_meanrendering_metrics_fps_minimumrendering_metrics_fps_maximumhttp_response_code
bugsnagmcp_bugsnag_list_trace_fieldsRetrieve available trace attribute fields for filtering.Read-onlyList Trace Fields
Retrieve available trace attribute fields for filtering.
Inputs
projectIdstring- 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_groupingsSet network endpoint grouping rules for a project.WriteSet Network Endpoint Groupings
Set network endpoint grouping rules for a project.
- Idempotent
Inputs
endpointsarrayrequired- 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.
projectIdstring- 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_errorUpdate the status of an error (e.g., ignore, snooze, open, or mark as fixed).WriteUpdate Error
Update the status of an error (e.g., ignore, snooze, open, or mark as fixed).
Inputs
errorIdstringrequired- Unique identifier of the error
operationstringrequired- The operation to apply to the errorone of
override_severityopenfixignorediscardundiscardsnoozelink_issueunlink_issue issue_urlstring- The URL of the issue to link to the error - required when operation is 'link_issue'
projectIdstring- 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.
reopenRulesobject- Reopen rules for snooze operation - required when operation is 'snooze'
No tools match.
