MCP Tools & Live Widgets Reference
9 TOOLSFirebreak exposes 9 typed operational tools and 3 interactive React widgets within the Model Context Protocol runtime.
4 min read
•Production Verified
Master Tool Reference Table
| Tool Name | Scope Required | Type | Attached Widget | Description |
|---|---|---|---|---|
| list_services | services:read | Read-only | — | Lists all protected services, GitHub repos, Vercel projects, and active health status. |
| list_incidents | incidents:read | Read-only | — | Lists open and resolved incidents for the workspace. Primary entry point when asking what broke. |
| get_incident | incidents:read | Read-only | incident-card | Retrieves incident details, broken vs. healthy deployments, top suspect, and status. |
| get_suspects | incidents:read | Read-only | suspect-list | Returns candidate commits ranked by deterministic blame score with file/symbol evidence. |
| get_analysis | incidents:read | Read-only | — | Returns advisory AI narrative explaining the failure mechanism and suggested code fix. |
| get_timeline | incidents:read | Read-only | — | Returns chronological audit trail of alerts, ranking, actions, approvals, and probe events. |
| propose_rollback | actions:propose | Idempotent | action-status | Runs 6 safety checks and stages a rollback to the last-good deployment. |
| get_action_status | incidents:read | Read-only | action-status | Tracks live status of a rollback: awaiting approval, executing, verifying, or completed. |
| approve_action | actions:approve | Destructive | action-status | Human/authorized sign-off that triggers live Vercel rollback and canary verification. |
The Three Interactive React Widgets
When invoked, tools attach rich interactive micro-frontends exported as static bundles from apps/mcp/src/widgets/out/:
| Widget | Triggering Tool | Visual Elements Rendered |
|---|---|---|
| /incident-card | get_incident | Pulsing red severity badge, broken production SHA vs. recovery SHA, top suspect commit message, and deep-link button. |
| /suspect-list | get_suspects | Vertical leaderboard of candidate commits sorted by rank (#1, #2), blame score percentage (92%), and code diff tags. |
| /action-status | propose_rollback, approve_action | 6 Preflight Safety Gate checkmarks, 15-minute countdown timer, and an animated Canary Progress Bar. |