List the tenant's licences
license_listList all licences stored for a tenant, optionally filtered by product or computed state, to audit licence status in bulk. Read-only and role-gated; licensee data is masked for support readers.
Instructions
List every licence stored for the caller's tenant, optionally filtered by product_id or by computed state (for example LICENSE_REVOKED). Caller must be a principal of class tenant_owner, issuer, support_reader, or auditor. On the support surface (support_reader) licensee details are masked; other classes see the full record. Use license_inspect for one licence with its receipts; this tool returns the same per-licence view in bulk plus a count and the surface served. Read-only.
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": {
"_tenant_id": "<_tenant_id>",
"_principal_id": "<_principal_id>"
},
"name": "license_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Optional filter: only licences whose computed state equals this value (e.g. LICENSE_VALID). | |
| _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. | |
| product_id | No | Optional filter: only licences for this product. | |
| _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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| surface | No | ||
| licenses | No |