Show one licence's current state
license_statusRetrieve the current computed state of a stored licence, such as valid, grace, expired, revoked, or superseded. Returns product, tier, expiry, perpetual flag, and seat count for a quick summary view.
Instructions
Show the current computed state of one stored licence: LICENSE_VALID, LICENSE_GRACE (inside the 14-day post-expiry grace), LICENSE_EXPIRED, LICENSE_REVOKED, LICENSE_SUPERSEDED, or LICENSE_UNKNOWN when the id is not the tenant's. Returns state plus product, tier, expiry, perpetual flag, and seat count -- the summary view. Use license_inspect for the full record with its journal receipts, and license_verify when an artefact string is in hand. Requires a valid _tenant_id. 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": {
"license_id": "<license_id>",
"_tenant_id": "<_tenant_id>"
},
"name": "license_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _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. | |
| license_id | Yes | Stored licence id to report on. | |
| _principal_id | No | 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 |
|---|---|---|---|
| seats | No | ||
| state | No | ||
| tier_id | No | ||
| perpetual | No | ||
| expires_at | No | ||
| license_id | No | ||
| product_id | No |