check_entitlementScope: library:readCheck Entitlement
Verify whether the authenticated user holds a valid license, previous purchase, or subscription tier allocation for a specific asset.
Description
Check Entitlement performs zero-trust license verification for a target asset ID against the caller's account record. It determines if the user has direct ownership via a previous single-item purchase, holds an active subscription (such as Pro or VIP) that grants free claims for this asset's tier, or if the asset is free for all registered users. This is an essential safety and decision-routing tool for AI agents: if isEntitled is true, the agent can immediately proceed to get_download_url. If isEntitled is false, the agent can check if the asset is eligible for claim_free_asset under an active subscription, or calculate wallet costs for purchase_asset_with_wallet.
Execute check_entitlement before calling get_download_url or purchase_asset_with_wallet. It prevents redundant wallet transactions and confirms instant download readiness.
Input Arguments
1 parameters| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| assetId | string | Required | — | The unique catalog asset identifier to verify entitlement for. |
Request Example
{
"jsonrpc": "2.0",
"id": "call_06",
"method": "tools/call",
"params": {
"name": "check_entitlement",
"arguments": {
"assetId": "ast_neon_matrix"
}
}
}Response Schema Example
{
"assetId": "ast_neon_matrix",
"isEntitled": true,
"reason": "owned_via_purchase",
"canDownload": true
}