Buy an appraisal: enrolled agent card ($5)
buy_appraisal_agent_cardRAIL: AGENT CARD. Buy a fresh appraisal of one domain, computed on this server, for $5, charged unattended to a card your operator enrolled once for you (card-agent-1). No person is present at purchase time and no payment page opens: the charge runs against the enrolled card, inside the grant and the consent caps your operator set. Requires your agent token on this MCP connection, plus grantId and cardRef from your operator. Pass a stable operationId of your own: repeating this call with the same operationId and the same request returns the stored charge and never charges twice; the same operationId with a different request is refused operation_id_conflict. Returns the appraisal in the same call when the engine delivers at once; otherwise poll appraisal_card_order_status with the same operationId. A charge the engine cannot deliver is refunded automatically and in full. Not this rail when a person will pay at a checkout page: buy_appraisal is the human card rail (same $5, orderId + orderToken). Not this rail when your operator funded a prepaid balance instead of enrolling a card: purchase_appraisal draws $0.03 from that balance.
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": {
"domain": "<domain>",
"grantId": "<grantId>",
"cardRef": "<cardRef>",
"operationId": "<operationId>"
},
"name": "buy_appraisal_agent_card"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | The domain to appraise, e.g. brightcargo.com. | |
| cardRef | Yes | The enrolled card handle (acr_...) from enrollment. | |
| grantId | Yes | The purchase grant id your operator issued you. | |
| maxSpendUsd | No | Your hard ceiling for this charge. Defaults to the price, $5. | |
| operationId | Yes | Your idempotency key for this purchase, 8 to 128 characters. Reuse it verbatim on any retry. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||