Raw schema
{
"type": "object",
"properties": {
"subject": {
"type": "object",
"properties": {
"server_id": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"artifact": {
"type": "string",
"maxLength": 2000
},
"claimed_version": {
"type": "string",
"maxLength": 100
}
},
"required": [
"server_id"
],
"additionalProperties": false,
"description": "The spend target: server_id (required), artifact (mcpb:// | oci:// | https://), claimed_version"
},
"intent": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"params_summary": {
"type": "string",
"maxLength": 200
},
"advertised_cost_usdc": {
"type": "string",
"maxLength": 20
}
},
"required": [
"operation"
],
"additionalProperties": false,
"description": "The intended invocation: operation (required), params_summary (sha256 of canonical params), advertised_cost_usdc"
},
"policy": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 20,
"description": "Policy strings (max 20)"
},
"context": {
"type": "object",
"properties": {
"principal_wallet": {
"type": "string",
"maxLength": 100
},
"chain": {
"type": "string",
"maxLength": 30
}
},
"additionalProperties": false,
"description": "principal_wallet + chain. Optional."
},
"dry_run": {
"type": "boolean",
"description": "true = free dry-run, intercepted before the payment gate"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"subject",
"intent",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}