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

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.