trust.graduate · Cortex MCP Docs

Description

Promotes a (action class × counterparty) pair from its current level to level 2 or 3. Demotion is automatic on user reversal — there is no `trust.demote` tool by design.

Input schema

Field	Type	Required	Description
`action_class`	`string`	yes	Action class to graduate.
`counterparty_id`	`string`	no	Optional counterparty identifier.
`to_level`	`2 \| 3`	yes	Target autonomy level.
`reason`	`string`	no	Optional graduation reason.

Output shape

typescript

{
  ok: boolean;
  new_level: number;
  error?: string;
}

Example call

JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):

jsontools/call params

{
  "name": "trust.graduate",
  "arguments": {
    "action_class": "communicate",
    "counterparty_id": "entity_01HXSARAH",
    "to_level": 3,
    "reason": "30 days of clean Level 2 history"
  }
}

Example response

Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):

jsonparsed result body

{
  "ok": true,
  "new_level": 3
}

Errors this tool can return

Code	Meaning
`invalid_arguments`	Tool input failed Zod validation.
`unauthorized`	Missing or invalid bearer token.
`trust_insufficient`	The current autonomy level for this (action class × counterparty) is too low for direct execution.

See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).