spl_agentic_run
Execute one Agent Commerce Network (ACN) run. Mutating: runs paid and unpaid steps; unpaid steps answer 402 (payment required) instead of running. Requires confirm:true plus demo:true or a Rider + Warrant pair. Use after spl_agentic_plan validates the shape; use spl_agentic_context first when the context is large.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "spl_agentic_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ops | No | Ops-feed input for the run. | |
| pay | No | True to pay for paid steps when they are reached. | |
| sku | No | SKU to buy or price; string id or object. | |
| url | No | Target URL for the run. | |
| cuni | No | CuNi program or exactness input for the run. | |
| demo | No | True to plan or run a demo with no payment and no Rider token. | |
| host | No | Target hostname for the run. | |
| paid | No | True when payment was already made for this run. | |
| rail | No | Payment rail: stripe for humans, x402 for agents. | |
| swap | No | Swap details for a cross-chain step (from/to chain, token, amount). | |
| tool | No | Tool call spec for the run. | |
| actor | No | Actor identity executing the run. | |
| agent | No | Agent spec for the run; string id or object. | |
| audit | No | Audit or audit-export input; string id or object. | |
| bytes | No | Input byte count the run will process; used for the quote. | |
| chain | No | Receipt chain for the run; array of prior receipts. | |
| rider | No | Agent-Rider JWT identifying the acting agent. Required for live runs unless demo is true. | |
| action | No | Run action or stage name, e.g. plan, compress, or a stage key. Determines which stages the plan includes. | |
| payout | No | Payout details for the run. | |
| solana | No | Solana transaction input for the run. | |
| confirm | No | True to execute the run. Required — without it the run is refused. | |
| dispute | No | Dispute details for the run. | |
| mcpTool | No | MCP tool call spec for the run. | |
| message | No | Message payload for an agent-messaging stage. | |
| sandbox | No | Sandbox spec for an isolated step. | |
| warrant | No | Warrant token authorizing the run's spending. Required for live runs unless demo is true. | |
| asyncRun | No | Async run spec for the run. | |
| crossing | No | Crossing or bridge identifier when the run moves between systems. | |
| debridge | No | deBridge swap input for a cross-chain step. | |
| x_payment | No | X-PAYMENT header value for x402 settlement. | |
| depotStore | No | Depot store input for the run. | |
| membership | No | Membership input for the run. | |
| reputation | No | Reputation input for the run; string id or object. | |
| chamberSeal | No | Chamber seal input for the run. | |
| tokenBudget | No | Token budget for the run; string id or object. | |
| depotBilling | No | Depot billing input for the run. | |
| depotReceipt | No | Depot receipt input for the run. | |
| privateBench | No | Private benchmark input for the run. | |
| conductorTask | No | Conductor task spec; string id or object. | |
| riderPaidCall | No | Paid Rider call input for the run. | |
| standingRider | No | Standing Rider credential for the run; string id or object. | |
| parent_receipt | No | Parent receipt id when this run continues another run. | |
| conductorReview | No | Conductor review input for the run. | |
| delegation_mode | No | Delegation mode for the run. | |
| warrantTemplate | No | Warrant template to apply to the run; string id or object. |