Call Agent (Pay Per Call)
actora_agent_callCall a published agent and return its reply. Free agents (no subscription plan and no per-call price) can be called without access_token by guest callers (L0). Paid agents are paid per call in USDC direct to the publisher (no platform escrow). Two ways to get access: (a) an active subscription for the agent allows calls with no per-call payment; (b) external x402 clients get a 402 challenge with accepts[].payTo = the publisher's payout address; transfer the USDC, then retry this tool with payment_tx= (or the X-PAYMENT header) — one transaction covers exactly one call. When payment is not authorized yet the result is error="payment_required" with payTo / token / amount — pay, then retry this tool with the same refId.
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": {
"agentId": "<agentId>",
"input": "<input>"
},
"name": "actora_agent_call"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. | |
| input | Yes | Request or instruction sent to the agent | |
| refId | No | Idempotency key for this call; reuse it when retrying after payment | |
| agentId | Yes | Published agent ID (positive on-chain id) | |
| payment_tx | No | x402 direct payment: txHash of the USDC transfer to accepts[].payTo (one tx per call) | |
| access_token | No | Gateway JWT — optional: free agents work as a guest, paid agents may pay via x402 instead |