MCP Toolclaim_free_assetScope: library:claim

Claim Free Asset

Grant instant commercial library ownership for zero-cost community assets or tier-included subscription catalog items.

Description

Claim Free Asset permanently adds a qualifying asset to the user's Krafto library without debiting their wallet balance or requiring payment gateway checkout. It validates that the asset is either classified as 100% free by the creator or included within the user's active subscription tier (e.g. Pro or VIP quota). Once claimed, the server registers a commercial license record for the user, increments their monthly quota usage counter, and makes the asset immediately available for signed URL generation via get_download_url.

AI Agent Guidance & Best Practices

Use this tool whenever an asset is marked isFree: true or is included in the user's active plan. Inform the user that the asset was added to their library at ₹0 cost.

Input Arguments

1 parameters

Parameter	Type	Required	Default	Description
assetId	string	Required	—	The unique catalog asset ID to claim into the user's library.

Request Example

{
  "jsonrpc": "2.0",
  "id": "call_07",
  "method": "tools/call",
  "params": {
    "name": "claim_free_asset",
    "arguments": {
      "assetId": "ast_free_iconpack"
    }
  }
}

Response Schema Example

application/json

{
  "success": true,
  "assetId": "ast_free_iconpack",
  "message": "Asset added to library under your Pro plan quota.",
  "remainingQuota": 98
}

Check Entitlement

Get Download URL