Manage principals and mandates
principal_manageCreate tenant principals and grant or revoke product-scoped mandates with expiries, giving tenant owners the only journaled path to control who can issue, renew, or revoke licences.
Instructions
Administer the tenant's principals and mandates -- the only path that creates either. Tenant_owner only; grants and revocations are journalled. action create_principal registers a principal (principal_id + principal_class: tenant_owner, issuer, support_reader, auditor). action grant_mandate gives a principal a mandate scoped to products and operation classes until expires_at, and returns the mandate_id. action revoke_mandate revokes a mandate by id, effective immediately. There is deliberately no self-service mandate escalation: mandate_self_grant is denylisted and does not exist as a tool.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "principal_manage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name for create_principal. | |
| action | Yes | One of create_principal, grant_mandate, revoke_mandate (required). | |
| products | No | For grant_mandate: product ids the mandate covers ('*' covers all). | |
| _tenant_id | Yes | Tenant the call acts for. The tenant must exist; an unknown tenant is refused with state LICENSE_UNKNOWN. Transport authentication is a deployment concern -- this parameter scopes the call, it does not authenticate it. | |
| expires_at | No | For grant_mandate: ISO-8601 mandate expiry (required). | |
| mandate_id | No | For revoke_mandate: mandate to revoke (required). | |
| op_classes | No | For grant_mandate: operation classes covered, e.g. issue, renew, revoke, supersede, transfer, deactivate, reclaim. | |
| principal_id | No | Principal the action targets (required for create_principal and grant_mandate). | |
| _principal_id | Yes | Acting principal inside the tenant. Principal-gated tools refuse unknown principals and principals of the wrong class; executions (tier T2) additionally require a live, unexpired mandate covering the product and the operation class. | |
| principal_class | No | Class for create_principal: tenant_owner, issuer, support_reader, or auditor. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| receipt | No | ||
| mandate_id | No | ||
| principal_id | No | ||
| principal_class | No |