MCP tools
The agent-facing twin of the REST reference. Every tool maps to an endpoint;
the repository is fixed by the server's --repo scope, so no tool takes a
repo argument.
activity_check, notable_list, and
session_summary only read and are safe to auto-approve. The
*_create and *_update tools write.
activity_check
Compare a proposed branch and paths against all active work without creating anything. Returns any overlaps with a severity so the agent can decide whether to proceed, wait, or coordinate.
Parameters
branch required string paths required string[] tags optional string[] risk optional enum > activity_check { branch: "feat/auth-refresh", paths: ["src/auth/**"] } ⚠ 1 overlap found • "Refactor auth middleware" severity: high branch: feat/auth-middleware → Draft PR #482
activity_create
Log a new unit of active work. The activity starts active and expires
after 24 hours unless it's archived or renewed first.
Parameters
branch required string paths required string[] task optional string risk optional enum draft_pr_url optional string > activity_create { branch: "feat/auth-refresh", paths: ["src/auth/**"], risk: "high" } ✓ created act_9Fq0Zt4 expires in 24h
activity_update
Keep a log current as scope grows or the Draft PR opens — or set status to
archived to mark the work done. Only the fields you pass change.
Parameters
id required string paths optional string[] risk optional enum draft_pr_url optional string status optional enum > activity_update { id: "act_9Fq0Zt4", paths: ["src/auth/**", "src/auth/tokens.ts"] } ✓ updated act_9Fq0Zt4 scope: +src/auth/tokens.ts
notable_list
List active Notables for the repo, optionally filtered by category or minimum severity.
Parameters
category optional string severity optional enum status optional enum > notable_list { category: "migration" } ▲ not_2Bd8Xk "Payments v2 migration in progress" severity: high expires in 5d
notable_create
Raise a new alignment signal. Include a doc_url whenever the underlying
knowledge is durable enough to live in real docs.
Parameters
title required string body required string category required string severity optional enum doc_url optional string > notable_create { title: "Flaky checkout e2e", body: "checkout.e2e is intermittently red; retry is not a real failure", category: "flaky-test" } ✓ created not_7Qm1Rp expires in ~7d
session_summary
What changed since a timestamp: new Notables, high-risk active work, and recently merged PRs. This is what the Claude Code session-start hook consumes.
Parameters
since optional timestamp > session_summary { since: "2026-07-02T09:00:00Z" } ▲ 2 new notables ⚠ 1 high-risk activity ✓ 2 PRs merged