Skip to content
beeps.dev beeps.dev

MCP Server

The beeps MCP server lets you triage, fix, and resolve alerts without leaving your editor.

Setup

Section titled “Setup”
Terminal window
claude mcp add --transport http --scope user beeps https://mcp.beeps.dev/mcp

Verify:

Terminal window
claude mcp list
claude mcp get beeps

Optional: Pre-Registered OAuth Client

Section titled “Optional: Pre-Registered OAuth Client”

If your deployment disables open dynamic client registration, add a client id/secret:

Terminal window
claude mcp add --transport http --scope user --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET> beeps https://mcp.beeps.dev/mcp

Tools

Section titled “Tools”

Triage

Section titled “Triage”

beeps_list_active_alerts — List active unresolved alerts with optional severity filter.

Show me all active alerts
Are there any critical alerts right now?

beeps_list_alert_responders — List alert responders and their status.

Who's responding to alert al_abc123?

beeps_get_fix_status — Get current fix progress by alert jobs or a specific job.

What's the fix status on alert al_abc123?

Act

Section titled “Act”

beeps_on_it — Mark an alert as being worked by a responder.

I'm on it for alert al_abc123

beeps_fix_here — Load complete alert fix context for foreground remediation.

Load the fix context for alert al_abc123 and help me resolve it

Resolve

Section titled “Resolve”

beeps_update_responder_status — Mark responder as done or dropped and optionally attach a PR URL.

Mark my response to al_abc123 as done with PR https://github.com/org/repo/pull/42

beeps_resolve_alert — Resolve an alert.

Resolve alert al_abc123

Scheduling

Section titled “Scheduling”

beeps_get_on_call — Get the currently on-call user for a schedule.

Who's on call for the platform schedule?

beeps_set_override — Set a temporary schedule override.

Override the platform schedule to put me on call from now until 6pm

beeps_update_override — Update the time window or reason of an override.

Extend the current override until Monday

beeps_cancel_override — Cancel an override to restore normal rotation.

Cancel the override on the platform schedule

beeps_get_schedule_assignments — Get upcoming schedule assignments.

Show the next 5 on-call assignments for the platform schedule

Configuration

Section titled “Configuration”

beeps_list_relays — List all relays.

What relays do we have?

beeps_list_webhooks — List webhooks for a relay.

What webhook URLs does the production relay have?

beeps_create_relay — Create a new relay.

Create a relay called "staging alerts"

beeps_list_schedules — List all schedules.

Show me all schedules

beeps_create_schedule — Create a schedule.

Create a weekly schedule on the production relay, handoff Monday at 9am

beeps_list_schedule_members — List members of a schedule.

Who's in the primary on-call rotation?

beeps_add_schedule_member — Add a member to a rotation.

Add alice@example.com to the primary schedule

beeps_remove_schedule_member — Remove a member from a rotation.

Remove Bob from the primary schedule

beeps_list_relay_rules — List rules for a relay.

What rules are configured on the production relay?

beeps_create_relay_rule — Create a relay rule.

Add a schedule_notify rule to the production relay for the primary schedule

beeps_delete_relay_rule — Delete a relay rule.

Delete the webhook rule on the staging relay

beeps_assign_alert — Assign an alert to a user.

Assign alert alr_abc123 to Alice

beeps_list_integrations — List integrations.

What integrations are configured?

beeps_list_members — List organization members.

Who's in the org?

beeps_get_alert — Get full details of a specific alert.

Show me the details of alert alr_abc123

Troubleshooting

Section titled “Troubleshooting”

403 missing required scope

Section titled “403 missing required scope”

Re-run codex mcp login beeps with both beeps.tools.read and beeps.tools.write. For Claude Code, remove/re-add the server and complete OAuth consent again.

Organization context required

Section titled “Organization context required”

If the user belongs to multiple organizations, set an active org in the web app first. For Claude Code, you can also set a fixed header when adding the server:

Terminal window
claude mcp add --transport http --scope user -H "X-Organization-Id: <ORG_ID>" beeps https://mcp.beeps.dev/mcp

explicit write confirmation required

Section titled “explicit write confirmation required”

Write tools require confirmation metadata by default. Ask the agent to include MCP _meta:

{
  "beeps/confirmWrite": true
}

For self-hosted environments, this policy can be disabled with BEEPS_REQUIRE_WRITE_CONFIRMATION=false.