MCP tool catalog
The Metriq MCP server exposes 44 tools (14 read, 30 write). Connect any MCP-compatible agent (Claude Desktop, Claude Code, or your own runtime) and it can read your board's flow analytics and drive work items. Each tool is team-scoped: the team is derived from the API key, so a call can never address another team's data.
This page is generated from the server source. For setup, the auth model, workflow recipes, and the agent end-of-turn contract, see the MCP reference.
Read tools
Read tools never mutate the board and never broadcast updates.
| Tool | Summary |
|---|---|
get_bless_telemetry | Bless-latency (p50/p90/max in ms) and acceptance-rate (blessed / decided) for agent-Done blessing requests in a window. |
get_blockers | Currently blocked work items (with how long each has been blocked) plus the per-week count of new blocked events over the last 4 weeks. |
get_board | Get the full board state with all columns (Backlog, Ready, In Progress, Done) and their work items. |
get_cost_leverage_telemetry | Internal/admin instrumentation read (no user-facing billing). |
get_dispatch_journey | Reconstruct the full ordered lifecycle of a SINGLE dispatch by its dispatch_id (the same id wait_for_assignment returns and claim_assigned_task takes). |
get_dispatch_telemetry | Dispatch funnel telemetry over a window: time_to_first_claim p50/p95 (delivered_at - created_at), time_to_first_artifact p50/p95 (artifact.posted_at - claimed_at), dispatch_to_blessing_request p50/p95 (review_requested - created_at), plus counters dispatched_total / claimed_total / artifact_reported_total / redelivered_total / stuck_total / superseded_total. |
get_flow_summary | Headline flow-health digest: WIP per column, throughput trend, cycle time percentiles, SLE state, blockers, stale items. |
get_forecast | Monte Carlo forecast based on the team's throughput history. |
get_item | Get detailed information about a single work item, including its full event history. |
get_pending_input | Read the human↔agent conversation thread for a work item the agent asked about. |
list_active_dispatches | Enumerate dispatches that are currently in flight or were recently completed for the actor's team. |
list_labels | List all labels for the team. |
list_members | List all members of the team. |
request_human_input | Explicitly request human input on a work item the agent is working on. |
Write tools
Write tools mutate the board; on success they broadcast a live update to any open Metriq tab.
| Tool | Summary |
|---|---|
add_checklist_item | Add a checklist item under a work item. |
archive_item | Archive a work item. |
assign_item | Set the assignees for a work item. |
block_item | Toggle the blocked status of a work item. |
claim_assigned_task | Atomically claim a delivered dispatch for a specific agent_session_id. |
clear_item_outcome | Remove the outcome a work item serves (if any). |
clear_label_outcome | Demote an outcome label back to a regular label, clearing its problem statement. |
create_item | Create a new work item in the Backlog column. |
create_label | Create a new label scoped to the actor's team. |
delete_checklist_item | Remove a checklist item from a work item. |
delete_item | Permanently delete a work item. |
demote_epic | Demote an epic back to a regular label. |
edit_checklist_item | Change the text of a checklist item. |
end_agent_session | Graceful shutdown of an agent session: sets agent_sessions.ended_at = now(). |
move_item | Move a work item to a different column. |
post_agent_comment | Post an agent self-narration comment on a work item. |
promote_label_to_epic | Promote a label to epic status. |
register_agent_session | Register or rejoin an agent session for the actor's team. |
report_artifact | Report a URL pointing at a reviewable artifact (PR, branch, commit, diff, Loom, gist — anything that returns a URL). |
report_token_usage | Report the LLM token usage for the most recent agent round-trip. |
set_item_labels | Replace the label set on a work item with exactly these labelIds. |
set_item_outcome | Set the single outcome a work item serves, REPLACING any outcome already on the card (a card serves at most one outcome). |
set_label_as_outcome | Promote a label into the 'outcome' kind and set its one-line problem/opportunity statement. |
set_learning_outcome | Record whether a shipped (Done) card moved the outcome it served: validated | invalidated | inconclusive | unset. |
set_outcome_metric | Set the ONE metric on an outcome label: a metricName plus a baseline and a current numeric value, all entered manually (there is no automatic ingestion). |
toggle_checklist_item | Flip the checked state of a checklist item. |
unarchive_item | Restore an archived work item to its previous state. |
update_item | Edit a work item's title, description, type, or priority. |
update_outcome_current | Update ONLY the current value of an outcome's metric (the baseline is fixed). |
wait_for_assignment | Long-poll for the next pending dispatch assigned to this team's agent fleet. |