purpose (string, 3–500 characters) — the agent’s reason for acting, recorded in the audit log. Parameters below are in addition to purpose.
Payments
request_wallet_payment
| Parameter | Type | Required | Notes |
|---|---|---|---|
amountCents | integer | ✓ | ≥ 1. Alias: amount_cents |
recipient | string | ✓ | Wallet address, validated per chain (EIP-55 / base58) |
caip2 | string | ✓ | Network id, e.g. eip155:8453 (Base), solana:mainnet |
asset | string | — | Defaults to USDC |
idempotencyKey | string | ✓ | 8–200 chars, stable per logical payment. Alias: idempotency_key |
submit_approval_request
Same parameters as request_wallet_payment, plus:
| Parameter | Type | Required | Notes |
|---|---|---|---|
justification | string | — | Up to 500 chars, shown to the approving human |
requestId to poll via check_approval_status.
check_approval_status
| Parameter | Type | Required | Notes |
|---|---|---|---|
request_id | string (uuid) | ✓ | The requestId a payment tool returned (camelCase there, snake_case here) |
pending / approved / used / failed / denied / expired / not_found with a retry_after_seconds polling hint. See Payment Workflow for the semantics.
Balances & status
check_balance · get_agent_status · get_spending_rules · list_approved_merchants
No parameters beyond purpose.
get_wallet_addresses
| Parameter | Type | Required | Notes |
|---|---|---|---|
chain | string | — | evm or solana; omit for both |
usdc_evm, usdc_solana).
get_budget_utilization · get_spending_summary
| Parameter | Type | Required | Notes |
|---|---|---|---|
period | string | — | 24h, 7d, 30d, 90d (default 30d) |
lookback_days | integer | — | 1–90; overrides period when supplied |
History & feedback
get_transactions
| Parameter | Type | Required | Notes |
|---|---|---|---|
limit | integer | — | 1–100 (default 20) |
lookback_days | integer | — | 1–365 (default 90) |
cursor | string | — | Opaque token from the previous page |
get_denial_feedback
| Parameter | Type | Required | Notes |
|---|---|---|---|
limit | integer | — | 1–50 (default 10) |
lookback_days | integer | — | 1–365 (default 90) |
check_merchant_allowed
| Parameter | Type | Required | Notes |
|---|---|---|---|
merchant | string | ✓ | 1–200 chars |
mcc_code | string | — | Exactly 4 digits |
Rate limits
General tool calls are limited per your plan tier. The payment tools (request_wallet_payment, submit_approval_request) carry tighter caps: 10/min per key and 30/min per org. A 429 includes retry-after.