capsid_admin_read_claims
Read claims, on Capsid Admin. Needs the admin identity and the read grant.
What it does
What agents said they did, beside what the Worker verified. Read-only, and admin only.
Claims apart from verified outcomes: what each agent said at complete, fail and block (job_claims), each check of that claim against what the Worker verified (job_evaluations), and every human touch on a job (job_touches). Admin only, every action. It reads and never writes. A field an agent did not state is null, never 0.
action "aggregate" (the default) returns, per agent and namespace, jobs and claims, each evaluation's agree, disagree, unclaimed and unchecked counts, and the touches by kind and actor kind with the total and median wait; filter with namespace, agent (an actor string such as agent:sample-driver), since and until (ISO times).
action "job" takes id and returns the job, its job_outcomes row, and its claims, evaluations and touches, oldest first.
action "export" takes table (job_claims | job_evaluations | job_touches | job_outcomes), after (the cursor, 0 to start) and limit (at most 500), and returns rows as stored with next_after, the cursor for the next page, or null at the end. The cursor is id, or rowid for job_outcomes.
What a client is told
The MCP hints it carries, so a client can ask before it acts (src/tool-annotations.ts).
- Reads only: no action changes anything.
- Never overwrites or removes.
- Repeating a call changes nothing further.
- Stays inside Capsid.
Arguments
| Argument | Type | Needed | What it is |
|---|---|---|---|
action | one of: job, aggregate, export | no | aggregate (default) | job | export. |
id | string | no | For job: the job id. |
namespace | string | no | For aggregate: only this namespace. |
agent | string | no | For aggregate: only this agent's claims, by actor string. |
since | string | no | For aggregate: rows recorded at or after this ISO time. |
until | string | no | For aggregate: rows recorded before this ISO time. |
table | one of: job_claims, job_evaluations, job_touches, job_outcomes | no | For export: job_claims | job_evaluations | job_touches | job_outcomes. |
after | whole number | no | For export: the cursor from the last page's next_after. 0 or omitted starts at the beginning. |
limit | whole number | no | For export: rows per page, at most 500, the default. |