# Bugsnag — how to use (mcp.ai)

Connect your Bugsnag account and use 60 tools for developer tools straight from your AI agent. Connect with your own API key. Bugsnag is an error monitoring and stability management platform that helps developers identify, prioritize, and fix software bugs.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bugsnag?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `bugsnag_add_organization_collaborator_team_memberships`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bugsnag`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/bugsnag/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/bugsnag/add/organization/collaborator/team/memberships` — Tool to add a collaborator to a group of teams in a Bugsnag organization. Use when you need to assign a collaborator to specific teams or all teams. Requires admin permissions on the organization.
  - body: { team_ids?: string[], add_all_teams?: boolean, collaborator_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/add/organization/team/memberships` — Tool to add collaborators to a team in a Bugsnag organization. Use when you need to add specific collaborators or all organization collaborators to a team. Requires admin permissions on the organizati
  - body: { id: string, organization_id: string, collaborator_ids?: string[], add_all_collaborators?: boolean }
- `POST https://api.mcp.ai/api/bugsnag/bulk/update/errors` — Bulk update multiple errors in a Bugsnag project. Applies the same operation to all specified errors. Note: The actual API implementation returns only the operation name in the response, not per-error
  - body: { severity?: string, error_ids: string[], issue_url?: string, operation: string, project_id: string, issue_title?: string, reopen_rules?: object, notification_id?: string, assigned_team_id?: string, verify_issue_url?: boolean, assigned_collaborator_id?: string }
- `POST https://api.mcp.ai/api/bugsnag/configure/integration` — Tool to configure a new integration for a Bugsnag project. Use after selecting integration key and preparing credentials.
  - body: { label?: string, project_id: string, configuration: object, integration_key: string, issue_automation?: object, disable_severities?: string[], disable_release_stages?: string[], disable_unhandled_states?: string[] }
- `POST https://api.mcp.ai/api/bugsnag/confirm/project/event/data/deletion` — Confirms a project event data deletion request in Bugsnag. Use this action after creating a deletion request to confirm and proceed with the actual deletion of event data. The deletion request must be
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/create/collaborator` — Invites a new collaborator to a Bugsnag organization by email. Use this action to grant a user access to the organization. Optionally specify project_ids to restrict access to specific projects, or se
  - body: { admin?: boolean, email: string, project_ids?: string[], organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/create/custom/event/field` — Creates a custom event field for a Bugsnag project, enabling filtering and pivoting on custom metadata. Use this tool when you need to create a new searchable/filterable field from event metaData. Req
  - body: { path: string, reindex?: boolean, display_id: string, project_id: string, pivot_options?: object, filter_options: object }
- `POST https://api.mcp.ai/api/bugsnag/create/org/data/deletion` — Tool to create an event data deletion request for GDPR/CCPA compliance. Use when you need to delete event data matching specific criteria (e.g., user email, error class, device info). Specify filters 
  - body: { filters?: object, filter_groups?: object, organization_id: string, skip_confirmation?: boolean, filter_groups_join?: string }
- `POST https://api.mcp.ai/api/bugsnag/create/org/data/request` — Tool to create an event data request for a Bugsnag organization (GDPR/CCPA compliance). Use when you need to export event data for a specific user or set of conditions to comply with data access reque
  - body: { filters?: object, report_type?: string, filter_groups?: object, organization_id: string, filter_groups_join?: string }
- `POST https://api.mcp.ai/api/bugsnag/create/organization/project` — Tool to create a new project in a Bugsnag organization. Use when you need to set up a new project for error tracking under a specific organization. Requires organization_id, project name, and platform
  - body: { name: string, type: string, organization_id: string, ignore_old_browsers?: boolean }
- `POST https://api.mcp.ai/api/bugsnag/create/organization/team` — Tool to create a new team in a Bugsnag organization. Use when you need to organize collaborators into teams for better access management. The team name must be unique within the organization.
  - body: { name: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/create/project/data/deletion` — Tool to create an event data deletion request for a specific project. Use when you need to delete event data matching specific criteria (e.g., error class, severity, user email) within a project. Spec
  - body: { filters?: object, project_id: string, filter_groups?: object, skip_confirmation?: boolean, filter_groups_join?: string }
- `POST https://api.mcp.ai/api/bugsnag/create/project/event/data/request` — Tool to create an event data request for a Bugsnag project. Use when you need to export event data matching specific filters. The request is processed asynchronously - check the returned status and us
  - body: { filters?: object, project_id: string, report_type?: string, filter_groups?: object, filter_groups_join?: string }
- `POST https://api.mcp.ai/api/bugsnag/create/saved/search` — Creates a saved search (filterset) for a Bugsnag project that persists filter and sort configurations. Use this to save frequently used error filters for quick access in the dashboard. Requires a vali
  - body: { name: string, sort?: string, shared?: boolean, filters?: object, project_id: string, project_default?: boolean }
- `POST https://api.mcp.ai/api/bugsnag/delete/all/errors/in/project` — Permanently deletes all errors and event data from a Bugsnag project. WARNING: This action is IRREVERSIBLE. All error and event data will be permanently removed. Requirements: - User must have Project
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/delete/collaborator` — Removes a collaborator from a Bugsnag organization. This action permanently revokes the user's access to all projects within the organization. Before using, obtain the organization_id from List Organi
  - body: { collaborator_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/delete/configured/integration` — Tool to delete a configured integration. Use when you need to remove an existing integration from a project after confirming the integration ID. This action cannot be undone and requires Organization 
  - body: { id: string }
- `POST https://api.mcp.ai/api/bugsnag/delete/event/field` — Deletes a custom event field from a Bugsnag project. Use this tool when you need to remove a custom event field that was previously created via BUGSNAG_CREATE_CUSTOM_EVENT_FIELD. This action only work
  - body: { display_id: string, project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/delete/organization` — Permanently deletes a Bugsnag organization. This action is irreversible and removes all organization data including projects, collaborators, and settings. Use BUGSNAG_LIST_ORGANIZATIONS to find the or
  - body: { organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/delete/organization/team` — Tool to delete a team from a Bugsnag organization. Use when you need to permanently remove a team. Requires organization admin permissions.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/delete/project` — Permanently deletes a Bugsnag project. This action is irreversible and removes all project data including errors, events, and settings. Use BUGSNAG_LIST_PROJECTS to find the project_id. Requires admin
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/delete/saved/search` — Permanently deletes a saved search (filterset) from a Bugsnag project. Use this to remove saved searches that are no longer needed. Requires the saved_search_id which can be obtained from list_saved_s
  - body: { saved_search_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/configured/integration` — Tool to retrieve details of a specific configured integration by its ID. Returns configuration details, status, automation settings, and usage information. Use 'List Configured Integrations for Projec
  - body: { id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/org/data/deletion` — Tool to check the status of an organization event data deletion request in Bugsnag. Use this to monitor deletion requests including their current status (PREPARING, AWAITING_CONFIRMATION, ACCEPTED, IN
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/organization/by/id` — Tool to view an organization by its ID. Use when you need to retrieve detailed information about a specific Bugsnag organization.
  - body: { id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/organization/collaborator/project/access/counts` — Tool to view the project count of collaborators in an organization. Use when you need to retrieve project access counts for specific collaborators.
  - body: { organization_id: string, collaborator_ids: string[] }
- `POST https://api.mcp.ai/api/bugsnag/get/organization/collaborator/projects` — Tool to view projects a collaborator has access to in an organization. Use when you need to list all projects that a specific user can access within an organization.
  - body: { q?: string, sort?: string, per_page?: integer, direction?: string, collaborator_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/organization/event/data/request` — Tool to check the status of an organization event data request. Use when you need to monitor the progress of a data export or GDPR request.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/organization/team` — Tool to show the details of a team in an organization. Use when you need to retrieve information about a specific team including its name, collaborator count, and project count.
  - body: { id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/pivot/values/on/a/project` — List pivot values for a project, showing how events are distributed across different values of a field. Use this to analyze event distribution by release stage, app version, user, device type, or othe
  - body: { base?: string, sort?: string, filters?: object, per_page?: integer, project_id: string, filter_groups?: object, filter_groups_join?: string, event_field_display_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/project/data/deletion` — Tool to check the status of a project event data deletion request in Bugsnag. Use this to monitor deletion requests including their current status (PREPARING, AWAITING_CONFIRMATION, ACCEPTED, IN_PROGR
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/project/event/data/request` — Tool to check the status of a project event data request. Use when you need to monitor the progress of a data export or GDPR request for a specific project.
  - body: { id: string, project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/project/network/grouping/ruleset` — Tool to retrieve a project's network grouping ruleset. Use when you need to view the URL patterns used to group network spans for performance monitoring in a project.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/saved/search` — Retrieves the details of a specific saved search by its unique ID. Returns comprehensive information about the saved search including its name, filters, sharing status, inclusion criteria for differen
  - body: { id: string }
- `POST https://api.mcp.ai/api/bugsnag/get/saved/search/usage/summary` — Retrieves usage statistics for a saved search, showing how it is being used across the project. Returns counts of project notifications, collaborator email notifications, and performance monitors that
  - body: { id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/collaborator/access/details/for/projects` — Tool to list summary details of the projects a collaborator has access to. Use when reviewing a collaborator's access across an organization.
  - body: { q?: string, offset?: string, per_page?: integer, inaccessible?: boolean, collaborator_id: string, individual_only?: boolean, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/collaborators` — Tool to list collaborators in an organization. Use when you need to retrieve all collaborators for a specified organization. Example: "List collaborators for organization 515fb9337c1074f6fd000001".
  - body: { offset?: string, per_page?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/collaborators/on/project` — Tool to list collaborators on a project. Use when you need to retrieve all users with access to a given project after confirming its ID. Example: "List collaborators for project 515fb9337c1074f6fd0000
  - body: { offset?: string, per_page?: integer, project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/configured/integrations/for/project` — Retrieves all configured integrations for a Bugsnag project. Returns details about each integration including its type (e.g., Slack, Jira, Asana), configuration, status, and trigger settings. Use BUGS
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/errors/on/project` — List all errors in a Bugsnag project with optional filtering and sorting. Use this to retrieve error summaries including error class, message, severity, status, occurrence counts, and affected users. 
  - body: { base?: string, sort?: string, per_page?: integer, direction?: string, project_id: string, version_seen_in?: object[] }
- `POST https://api.mcp.ai/api/bugsnag/list/event/fields/for/project` — Lists all event fields available for filtering and pivoting in a Bugsnag project. Use this action to discover which fields can be used to filter events in the project's error inbox. Common fields incl
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/events/for/error` — Lists individual error event occurrences for a specific error group. Use this after identifying an error_id via BUGSNAG_LIST_ERRORS_ON_PROJECT to retrieve detailed stack traces, metadata, and context 
  - body: { base?: string, sort?: string, filters?: object, error_id: string, per_page?: integer, direction?: string, project_id: string, full_reports?: boolean }
- `POST https://api.mcp.ai/api/bugsnag/list/events/on/project` — List all error events for a Bugsnag project. Events are individual occurrences of errors. Use this tool when you need to: - Retrieve all error occurrences (events) for a given project - Analyze indivi
  - body: { base?: string, sort?: string, filters?: object, per_page?: integer, direction?: string, project_id: string, full_reports?: boolean }
- `POST https://api.mcp.ai/api/bugsnag/list/organization/teams` — Tool to list teams in an organization. Use when you need to retrieve teams for a specified Bugsnag organization, optionally filtered by team name.
  - body: { q?: string, offset?: string, per_page?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/organizations` — Tool to list organizations for the authenticated user. Use after validating the API token when you need to retrieve all organizations the current user has access to. Always resolve organization_id val
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/bugsnag/list/pivots/on/project` — Lists all pivot field definitions for a Bugsnag project. Pivots are customizable fields used for filtering and grouping errors in Bugsnag dashboards. Use this to discover available pivot fields that c
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/project/feature/flag/summaries` — List feature flag summaries for a Bugsnag project with optional search filtering. Use this to retrieve feature flags that have been associated with errors in the project. Requires a valid project_id w
  - body: { q?: string, offset?: string, per_page?: integer, project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/project/feature/flags` — List feature flags on a Bugsnag project for a specific release stage. Use this to retrieve feature flags including their names, activity status, first seen timestamps, and optional variant summaries. 
  - body: { q?: string, sort?: string, per_page?: integer, direction?: string, first_seen?: string, project_id: string, starred_at_top?: boolean, include_inactive?: boolean, release_stage_name: string, include_variant_summary?: boolean }
- `POST https://api.mcp.ai/api/bugsnag/list/projects` — Tool to list projects in an organization. Use when you need to retrieve all projects under a specified Bugsnag organization after confirming the organization ID. Results may be paginated; iterate thro
  - body: { offset?: string, per_page?: integer, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/release/groups` — Tool to list release groups for a project. Use when you need to retrieve all release groups of a specific Bugsnag project after confirming the project ID.
  - body: { offset?: string, per_page?: integer, project_id: string, release_stage_name: string }
- `POST https://api.mcp.ai/api/bugsnag/list/releases` — List all releases (deployed versions) of a Bugsnag project. Releases track application versions, deployment stages, and associated source control information. Use this after obtaining a project_id fro
  - body: { after?: string, limit?: integer, before?: string, offset?: integer, project_id: string, release_stage?: string }
- `POST https://api.mcp.ai/api/bugsnag/list/saved/searches/on/project` — Lists all saved searches for a Bugsnag project. Saved searches are predefined filter configurations that help users quickly access specific error views. Use this to retrieve saved searches before gett
  - body: { offset?: string, shared?: boolean, per_page?: integer, project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/list/supported/integrations` — Tool to list all supported integrations. Use when discovering available integration services before configuring a project.
- `POST https://api.mcp.ai/api/bugsnag/list/trends/for/project/buckets` — Retrieves time-segmented event counts (trend buckets) for a Bugsnag project. Use this to analyze error/event occurrence patterns over time by splitting the data into configurable time buckets. Require
  - body: { filters?: object, project_id: string, buckets_count?: integer }
- `POST https://api.mcp.ai/api/bugsnag/regenerate/project/api/key` — Regenerates a Bugsnag project's notifier API key. This action invalidates the old API key and generates a new one. Use this when you need to rotate API keys for security purposes. WARNING: After regen
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/bugsnag/show/collaborator/access/details/for/project` — Tool to show a collaborator's access details for a project. Use after confirming organization, collaborator, and project IDs have been obtained and you have access rights.
  - body: { project_id: string, collaborator_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/show/collaborator/on/organization` — Tool to show a collaborator in an organization. Use after confirming organization and collaborator IDs; requires Organization Administrator access.
  - body: { collaborator_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/bugsnag/show/collaborator/on/project` — Tool to show a collaborator in a project. Use when you need detailed information about a specific collaborator after confirming both project and collaborator IDs.
  - body: { project_id: string, collaborator_id: string }
- `POST https://api.mcp.ai/api/bugsnag/test/integration` — Tool to test an integration configuration before deploying it. Use when validating credentials and connection parameters for integrations like Jira, Slack, or Asana before creating a configured integr
  - body: { key: string, configuration: object }
- `POST https://api.mcp.ai/api/bugsnag/update/collaborator/permissions` — Tool to update a collaborator's project access permissions. Use when you need to change which projects a collaborator can access or their roles within each project. Supply only project_ids or project_
  - body: { project_ids?: string[], project_roles?: object, collaborator_id: string, organization_id: string }

## Example prompts
- "What can I do in Bugsnag?"
- "Show me a summary of my Bugsnag account"

## More
- Page: https://mcp.ai/bugsnag
- Agent spec (llms.txt): https://mcp.ai/bugsnag/llms.txt
- Postman collection: https://mcp.ai/bugsnag/postman.json