honeybadger-mcp-server MCP Server

An MCP (Model Context Protocol) server for Honeybadger, providing structured access to Honeybadger's API through the MCP protocol.

Local serverstdio

What is the honeybadger-mcp-server MCP Server?

honeybadger-mcp-server is an MCP project maintained in the honeybadger-io/honeybadger-mcp-server repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) server for Honeybadger, providing structured access to Honeybadger's API through the MCP protocol”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using docker. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares HONEYBADGER_PERSONAL_AUTH_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_referenceReturns Honeybadger reference documentation for LLMs, organized into non-overlapping topics: badgerql (query language), queries (Insights query…
topicsReference topics to fetch, e.g. ["badgerql", "charts"]. Use ["all"] for everything; omit for an index of topics (array of strings, optional)
list_projectsList all Honeybadger projects
account_idThe account ID to associate the project with. If omitted, the project is created in the first account your auth token has access to (string, optional)
get_projectGet detailed information for a single project by ID
idThe ID of the project to delete (number, required)
create_projectCreate a new Honeybadger project _(requires read-only=false)_
resolve_errors_on_deployWhether all unresolved faults should be marked as resolved when a deploy is recorded (boolean, optional)
disable_public_linksWhether to allow fault details to be publicly shareable via a button on the fault detail page (boolean, optional)
user_urlA URL format like 'http://example.com/admin/users/[user_id]' that will be displayed on the fault detail page (string, optional)
source_urlA URL format like 'https://gitlab.com/username/reponame/blob/[sha]/[file]L[line]' that is used to link lines in the backtrace to your git browser (string…
purge_daysThe number of days to retain data (up to the max number of days available to your subscription plan) (number, optional)
user_search_fieldA field such as 'context.user_email' that you provide in your error context (string, optional)
update_projectUpdate an existing Honeybadger project _(requires read-only=false)_
delete_projectDelete a Honeybadger project _(requires read-only=false)_
confirmConfirmation token from the preview returned by the first call (string, optional)
get_project_occurrence_countsGet occurrence counts for all projects or a specific project
project_idThe ID of the project the check-in belongs to (number, required)
periodTime period for grouping data: 'hour', 'day', 'week', or 'month'. Defaults to 'hour' (string, optional)
environmentEnvironment name to filter results (string, optional)
get_project_integrationsGet a list of integrations (channels) for a Honeybadger project
get_project_reportGet report data for a Honeybadger project
reportThe type of report to get: 'notices_by_class', 'notices_by_location', 'notices_by_user', or 'notices_per_day' (string, required)
startStart date/time in ISO 8601 format for the beginning of the reporting period (string, optional)
stopStop date/time in ISO 8601 format for the end of the reporting period (string, optional)
list_faultsGet a list of faults for a project with optional filtering and ordering. Fetch the errors reference topic (via get_reference) for the fault/notice model and…
created_afterFilter notices created after this timestamp (string, optional)
occurred_afterFilter faults that occurred after this timestamp (string, optional)
occurred_beforeFilter faults that occurred before this timestamp (string, optional)
limitMaximum number of notices to return (max 25) (number, optional)
orderOrder results by 'recent' or 'frequent' (string, optional)
pagePage number for pagination (default: 0) (number, optional)
get_faultGet detailed information for a specific fault in a project
fault_idThe ID of the fault (integer, required)
update_faultUpdate a fault's resolved, ignored, assignee, or resolve-on-deploy state. Only the provided fields are changed.
resolvedWhether the fault is resolved (boolean, optional)
ignoredWhether the fault is ignored (boolean, optional)
assignee_idPositive integer to assign that user; null to remove the current assignee; omit to leave unchanged (integer or null, optional)
resolve_on_deployMark the fault to be resolved automatically on next deploy (boolean, optional)
get_fault_countsGet fault count statistics for a project with optional filtering. Fetch the errors reference topic (via get_reference) for the q search syntax.
list_fault_noticesGet a list of notices (individual error events) for a specific fault
created_beforeFilter notices created before this timestamp (string, optional)
list_fault_affected_usersGet a list of users who were affected by a specific fault with occurrence counts
list_fault_commentsList comments on a fault. Returns the first page of comments; pagination is not currently supported.
get_fault_commentGet a single comment on a fault by ID.
comment_idThe ID of the comment (integer, required)
create_fault_commentAdd a comment to a fault.
bodyNon-blank comment text (string, required)
update_fault_commentReplace the body of an existing fault comment.
delete_fault_commentDelete an existing comment from a fault.
query_insightsExecute a BadgerQL query against Insights data
querySearch query to match against tool names and descriptions (string, required)
tsTime range - shortcuts like 'today', 'week', or ISO 8601 duration (e.g., 'PT3H'). Defaults to PT3H (string, optional)
timezoneIANA timezone identifier (e.g., 'America/New_York') for timestamp interpretation (string, optional)
stream_idsOptional JSON array of stream IDs to query (string, optional)
list_streamsList Insights data streams for a project
list_dashboardsList all Insights dashboards for a project
get_dashboardGet a single Insights dashboard by ID
dashboard_idThe ID of the dashboard to delete (string, required)
create_dashboardCreate a new Insights dashboard _(requires read-only=false)_
titleThe title of the dashboard (string, required)
widgetsJSON array of widget objects (see create_dashboard) (string, required)
default_tsDefault time range for the dashboard (string, optional)
update_dashboardUpdate an existing Insights dashboard _(requires read-only=false)_
delete_dashboardDelete an Insights dashboard _(requires read-only=false)_
list_alarmsList all Insights alarms for a project
get_alarmGet a single Insights alarm by ID
alarm_idThe ID of the alarm to get history for (string, required)
create_alarmCreate a new Insights alarm _(requires read-only=false)_. Fetch reference topics alarms, queries, and badgerql first (via get_reference) for the trigger_config
evaluation_periodHow often the alarm is evaluated (e.g., 5m, 1h, 1d). Minimum 1m (string, required)
trigger_configJSON object defining when to trigger the alarm (string, required)
lookback_lagDelay before evaluating to allow data to arrive (e.g., 1m, 0s for no lag) (string, required)
update_alarmUpdate an existing Insights alarm _(requires read-only=false)_. Fetch reference topics alarms, queries, and badgerql first (via get_reference).
delete_alarmDelete an Insights alarm _(requires read-only=false)_
get_alarm_historyGet the trigger history for an Insights alarm
list_check_insList check-ins (cron/scheduled task monitoring) for a project. Returns the first 25 check-ins; pagination is not currently supported
get_check_inGet a single check-in by ID
check_in_idThe ID of the check-in to delete (string, required)
create_check_inCreate a new check-in for a project _(requires read-only=false)_
schedule_typeThe schedule type: simple (report every fixed period) or cron (report on a cron schedule) (string, required)
slugURL-friendly identifier used to report the check-in (string, optional)
report_periodHow often the check-in is expected to report. Used by simple schedules (string, optional)
grace_periodAmount of time to allow a late report before alerting (string, optional)
cron_scheduleCron expression defining when the check-in is expected to report. Used by cron schedules (string, optional)
cron_timezoneTimezone for the cron schedule (string, optional)
update_check_inUpdate an existing check-in; only the provided fields are changed, and fields cannot be cleared once set. The schedule type cannot be changed after creation…
delete_check_inDelete a check-in and its reporting history _(requires read-only=false)_
search_toolsSearch available Honeybadger tools by name or description. Use this to discover tools before calling them. In read-only mode, only read-only tools are…

How to install the honeybadger-mcp-server MCP Server

{
  "mcpServers": {
    "honeybadger": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HONEYBADGER_PERSONAL_AUTH_TOKEN",
        "ghcr.io/honeybadger-io/honeybadger-mcp-server"
      ],
      "env": {
        "HONEYBADGER_PERSONAL_AUTH_TOKEN": "YOUR_HONEYBADGER_PERSONAL_AUTH_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HONEYBADGER_PERSONAL_AUTH_TOKENDeclared in the maintainer’s client configuration.Yes