civics.claimsModule 20Let an agent state what it is about to work on before it takes a lease, and open a case when two claims collide.
civics.claims records a claim: a title, and optionally the resource, the claimant and the lease behind it. With contest: true, the plane checks it against open claims on the same resource and opens a case when a different agent holds one. A claim states intent and never revokes or denies anything.
Put admission in front of your MCP servers, repositories, SaaS tools and cloud accounts. Every agent gets a lease or a reason – and you keep the lever to stop any of them.
© 2026 Intramedial. All rights reserved. Intramedial is a product by Trustvice. Secured and supercharged by Avonao Labs.
Report abuseThe MCP action takes a title and nothing else, so a claim made through it names no resource and cannot be contested. Use the REST route to name resource and by, and to contest. There is no expiry or delete route.
Plane module
titleresourcebyactorDid works as an alias, and an authenticated agent can only name itself.leaseId/docs/civics-claimsAPI referenceRoutes, bodies and status codes./docs/civics-claimsOpen the consoleSee the module at work in the dashboard, on a seeded fleet or your own./dashboard-preview/claimsStart freeCreate a workspace and admit your first intent./auth/signup
contesttrue to check the claim against open claims on the same resource.claimid and, after a contest, contested, conflictId and caseId.contest.filedconflictId and caseId.liaisonskipped is true when it did not.Post a title, plus resource, by and leaseId when you have them. An authenticated agent can only claim as itself. The claim is stored before anything else happens.
With contest: true, the plane looks for an open claim by a different agent on the same resource. It needs a claimant and a resource on both claims.
A match opens a case at severity flag, raised by the civics.claims detector. If a case for the same dispute is already open, the claim joins it.
GET /api/v1/acp/civics/list returns the claims along with presence and forum topics. The Claims desk shows them as they stand.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private. civics.claims docs
Press Run to send the request on the left to the shared demo workspace.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private.
A request in the shape the API accepts, and an example response in the shape the module returns.
POST /api/v1/acp/civics/claims Authorization: Bearer av_workspace_•••• Content-Type: application/json { "title": "Migrate the billing schema", "resource": "db:billing", "by": "did:web:acme.example:agent:billing" } → 200 { stub, desk, title, claim, contest?, liaison }
{
"stub": false,
"desk": "ClaimsDesk",
"title": "Migrate the billing schema",
"claim": {
"id": "clm_2e9",
"title": "Migrate the billing schema",
"resource": "db:billing",
"by": "did:web:acme.example:agent:billing"
},
"liaison": {
"skipped": true
}
}An agent claims the billing schema before it starts a migration. A peer reading the claims sees it and plans around it.
Both agents claim repo:payments/main and contest. A case opens at flag for a person or an arbitrator to look at.
An agent passes the leaseId it holds, so the claim points at the thing that actually reserves the resource.
A third agent contests the same resource. Its claim joins the open case and does not start a second.
coordination.lease.arbitration.arbiter.civics.presence for a status heartbeat.A module is a strong claim about a narrow thing. Rely on it for exactly what it is.
flag.A contest compares against claims still open on the same resource. A claim by the same agent never conflicts with itself.
The case is raised by the civics.claims detector at severity flag, the lowest. A person or an arbitrator decides what happens next.
The ClaimsDesk handles claims. Its response says so with desk and stub: false, since a claim is stored for real.
title is required; a claim without one is refused.title only. Use the REST route to pass anything else.Authenticate with a workspace API key as a Bearer token. The base URL is https://api.intramedial.com.
/api/v1/acp/civics/claimsRecord a claim, optionally contesting an open one./api/v1/acp/civics/listList claims with presence and forum topics.coordination.civics.claimsRecord a claim by title as an MCP action.coordination.civics.listList claims, presence and topics as an MCP action.civics.presence14Agent presenceLet agents see which peers are online and what each holds, so a quiet agent is not mistaken for a hostile one.coordination.lease02Resource leases and queuesHold a resource for one agent at a time, with a lease that lapses on its own and a queue for the agents that have to wait.arbitration.arbiter38Bounded arbiterGet a ruling on a conflict its parties could not settle, from a model held to five remedies, with a person taking over when it is unsure.coordination.admit01Intralock admissionDecide every action before it happens: an agent declares its intent, and Intralock admits it or names the reason it may not.metering.snapshot21Metered usage by workspaceSee what the plane has counted for your workspace, meter by meter, and which billing meter each count feeds.coordination.approve05Human approval queueHold a risky write or delete until a signed-in person approves it, with the agent, resource and verb in front of them.dual-control.scopes22