Submit purchase intent
submit_purchase_intentDeclare a planned purchase before buying so policy can auto-approve, pause for human review, or deny; repeat submissions return the original intent.
Instructions
Declare a purchase before making it. Policy decides: auto-approve, pause for a human (Slack/Discord), or deny. Submitting the same agent_id + task_id + vendor + amount again inside the idempotency window returns the original intent instead of creating a second one.
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": {
"agent_id": "<agent_id>",
"task_id": "<task_id>",
"task_goal": "<task_goal>",
"vendor_domain": "<vendor_domain>",
"amount": "<amount>",
"is_recurring": "<is_recurring>"
},
"name": "submit_purchase_intent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount to spend, in major units of the currency (e.g. 15.00). | |
| task_id | Yes | Identifier of the task this purchase serves, e.g. '102'. | |
| agent_id | Yes | Stable identifier of the calling agent, e.g. 'invoice-bot'. | |
| currency | No | ISO 4217 currency code. | USD |
| reasoning | No | Optional step-by-step reasoning that led to this purchase. Stored in the audit log. | |
| task_goal | Yes | What the agent is trying to accomplish and why this purchase is needed. | |
| is_recurring | Yes | True if this creates a subscription, trial that auto-renews, or any repeat charge. | |
| vendor_domain | Yes | Merchant domain, e.g. 'pdfocr.io'. | |
| alternatives_attempted | No | Free or already-owned options the agent tried first, and why they failed. |