# Agent402.tools Execute-Plus (Pay-Per-Call Tool Router)

> Agent402.tools Execute-Plus (Pay-Per-Call Tool Router) is a paid API for AI agents from agent402.tools, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Resolves a plain-language task or slug to the best-matching tool in a 525-tool catalog (or the open x402 index), executes it, pays the underlying provider on your behalf, and returns the result with a verifiable receipt — all in one $0.05 USDC call.

## Facts

- Endpoint: POST https://agent402.tools/api/route/execute-plus
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-execute-plus-pay-per-call-tool-router-f405e3d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Lgk1Wlw_mQWuO1aRj_TL1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-tools-execute-plus-pay-per-call-tool-router-f405e3d8 -d '<json body>'
```

Example prompt: Research the current financials and analyst sentiment for NVDA stock — use the agent402 execute-plus router with task 'research a stock', params set to ticker NVDA, and keep the underlying tool price under $0.04.

## When to prefer this

Use execute-plus when you want to dispatch a natural-language task or a known tool slug and get a complete result plus a verifiable payment receipt in a single call, without pre-registering or holding an API key. It is the right choice when you need smart routing (the ranker picks the best tool), optional external x402 marketplace routing, a hard USD price cap, and cryptographic auditability via the callRef hash. Prefer it over the bare /api/find endpoint when you want execution, not just discovery, and over building your own tool-dispatch loop when the 525-tool catalog is likely to have coverage.

## Known failure modes

- Tool not found for the given task or slug — ranker returns no match above threshold
- maxUsd cap too low — the resolved tool's price exceeds the caller's budget cap ($0.04 ceiling enforced)
- Payment failure — insufficient USDC balance or unsupported chain
- External routing unavailable — no matching x402 seller found in the open index for the task
- Invalid params — tool inputSchema validation fails for the provided params object
- Both task and slug provided or neither provided — input schema requires exactly one
- External tool returns untrusted or malformed content — relayed as-is with untrustedContent flag
- Rate limiting or tool-side timeout on the underlying provider

## How this service works

Describe a task (or name a slug) and the Smart Order Router resolves the best-matching tool and RUNS it in the same call - flat $0.05 covering any tool listed at $0.04 or less, from THIS host's catalog or any external seller in the open index - x402 sellers, or MPP sellers on Tempo (paid on your behalf over x402 or MPP, result relayed). One payment, one request, result + receipt. /api/route quotes which tier a task needs; pricier tools return a self-correcting 409 with their direct route.

## Output

A JSON object with two top-level keys: 'result' (the raw output of the resolved and executed tool, shape varies by tool) and 'receipt' (a structured audit record containing timestamp, tool slug, route, seller, call reference with recomputable sha256 hash, amount paid in USD, how it was resolved, routing fee, and the underlying tool price).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "slug": {
   "type": "string",
   "description": "Exact tool slug to execute (skips ranking). Provide task OR slug."
  },
  "task": {
   "type": "string",
   "description": "Plain-language task, e.g. \"sha256 hash of a string\" - resolved via the same ranker as /api/find. Provide task OR slug."
  },
  "maxUsd": {
   "type": "number",
   "description": "Refuse tools listed above this underlying price (default and ceiling: $0.04)"
  },
  "params": {
   "type": "object",
   "description": "Input for the resolved tool, matching its inputSchema (default {})"
  },
  "include": {
   "type": "string",
   "description": "Where to route: default runs a tool from THIS host's catalog; \"external\" routes to the best-matching x402 seller in the OPEN index and pays it on your behalf (result relayed, marked untrustedContent). Requires task (not slug)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "hex": "…",
   "algo": "sha256",
   "base64": "…"
  },
  "receipt": {
   "ts": "2026-07-10T00:00:00.000Z",
   "slug": "hash",
   "route": "POST /api/hash",
   "seller": "internal",
   "callRef": "sha256:…  (recomputable: sha256 of {\"nonce\":<payment authorization nonce>,\"slug\":…,\"ts\":…} - null on nonce-less calls)",
   "paidUsd": 0.05,
   "resolvedBy": "slug",
   "routingFeeUsd": 0.009,
   "underlyingPriceUsd": 0.001
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-execute-plus-pay-per-call-tool-router-f405e3d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)