MCP tools reference

Once your agent is connected, it can call these tools. They're scoped automatically to the project the API key belongs to. Most agents orchestrate them for you from a heal prompt — this reference is for when you want to know exactly what's available.

Traces & analytics

Everything the dashboard shows, your agent can fetch — so it can investigate on its own, not just act on heal cards. All read-only.

list_traces

Recent traces with their diagnosis (the Trace Explorer, for agents).

• limit (int, default 20, max 200).
• since_days (number, default 7) — look back this many days.
• failure_cell (string, optional) — only this cell, e.g. complete_ungrounded.
• only_failures (bool, optional) — exclude healthy (complete_grounded) traces.

get_trace

Full detail for one trace: query, response, retrieved chunks, per-claim diagnosis and scores.

• trace_id (string, required) — UUID of the trace.

get_stats

Headline health for a window — total traces, healthy rate, average sufficiency/faithfulness, breakdown by failure cell.

• since_days (number, default 7).

get_failure_distribution

Trace count and share per failure cell for a window (the Failure Cells page, for agents).

• since_days (number, default 7).

Reading (heal cards)

list_heal_cards

List heal cards for the project.

• status (string, default open) — filter by card status.
• limit (int, default 50).

list_pending_work

List pending work items waiting for an agent.

• limit (int, default 20).

get_work_item

Fetch the full details of a work item — the diagnosis, the recommended fix, and the evidence.

• action_id (string, required) — UUID of the pending action.

Acting

start_heal

Begin working a heal card. Moves it to in_progress and creates a work item. Idempotent — calling it again returns the existing work item.

• heal_card_id (string, required) — UUID of the heal card.

claim_work_item

Claim a work item so other agents don't pick it up.

• action_id (string, required).

mark_pr_raised

Report that you opened a pull request for the fix. Moves the card to pr_raised.

• action_id (string, required).
• pr_url (string, required) — the PR URL.
• summary (string, optional) — one-line description of the change.

mark_failed

Report that the attempt failed (retryable).

• action_id (string, required).
• reason (string, required) — short human-readable explanation.
• patch (string, optional) — a unified diff of what you tried.

mark_pr_closed

Report that a raised PR was closed without merging.

• action_id (string, required).

Learning

save_repo_context

Store what the agent learned about the repo, so future recommendations are architecture-aware. See Repo context.

• summary (string) — one line: what the app/repo is.
• architecture (string) — stack, RAG pipeline, data sources, key files, constraints.
• recommendations (string) — repo-specific guidance for future fixes.

The same operations are also available over a plain HTTP shim under /mcp/* for non-MCP clients. For sending traces (not healing), use the REST ingest API.