Teardrop

Agent tools with a track record.

Call tools over MCP and A2A. Pay per call in USDC on Base.

  • MCP
  • A2A
  • AG-UI
  • x402
agent trace example

Example agent flow: fetch the agent card, call a marketplace tool over MCP, pay per call in USDC on Base with x402, and stream the result over AG-UI.

Agent endpoints
tools listed
32
healthy now
32/32
from, per call
$0.0050
USDC settlement
Base

Live from the public catalog.

Under the hood

Infrastructure for agents
that pay their own way.

Each panel shows the wire format. Steps marked live were captured from api.teardrop.dev; steps marked docs follow the documented exchange.

01 / Discover

Price and contract,
before the first call.

A public tools/list gives every tool its input schema, output schema, and per-call price. No account, no second request.

  • _meta["teardrop/price"] on every tool, in atomic USDC (5000 = $0.005)
  • Each tool ships use-when, limitations, and alternatives guidance to steer planners away from redundant calls
  • Observed-quality _meta attaches only once a tool is rated; absence means unrated, not zero
tools/list · get_gas_price captured 2026-10-16
  1. 01 POST /tools/mcp tools/list 200 live
    {
      "name": "get_gas_price",
      "annotations": { "readOnlyHint": true },
      "inputSchema": { "properties": {
        "chain_id": { "type": "integer", "default": 1 },
        "include_usd_estimate": { "type": "boolean" } } },
      "outputSchema": { "properties": {
        "gas_price_gwei": …, "next_base_fee_gwei": …,
        "gas_used_ratio": …, … } },
      "description": "… Alternatives: get_block, get_dex_quote",
      "_meta": {
        "teardrop/price": { "cost_usdc": 5000, "unit": "call" }
      }
    }

02 / Pay per call

HTTP 402,
answered in-band.

An unpaid tools/call returns x402 payment terms instead of a dead end. The agent signs a USDC authorization on Base, retries with it in _meta, and gets the result with its settlement receipt.

  • Calls that return isError or a JSON-RPC error are never settled
  • The replay guard keys on the signed authorization (payer + nonce)
  • Plain HTTP clients get 402 with a PAYMENT-REQUIRED header instead
tools/call · x402 over MCP captured 2026-10-16
  1. 01 POST /tools/mcp tools/call get_gas_price 200 live
    "result": {
      "isError": true,
      "structuredContent": {
        "x402Version": 2,
        "accepts": [{
          "scheme": "exact",
          "network": "eip155:8453",
          "asset": "0x8335…2913",
          "amount": "5000",
          "maxTimeoutSeconds": 300
        }]
      }
    }
  2. 02 POST /tools/mcp + _meta["x402/payment"] 200 docs
    "result": {
      "content": [ … ],
      "_meta": { "x402/payment-response": { … } }
    }
    PAYMENT-RESPONSE: <base64 SettleResponse>

03 / Bootstrap

No signup form.
The 401 explains itself.

Protected endpoints tell an agent how to get credentials. One x402 payment to /token provisions a machine org, issues a bearer token, and lands as prepaid credit.

  • First success returns a one-time client_secret; no refresh token is issued
  • Credit callers can bound any call with _meta["teardrop/max_cost_usdc"]
  • Org and principal pause and 24-hour caps apply to every credit charge
machine org bootstrap captured 2026-10-16
  1. 01 GET /agent/tools 401 live
    WWW-Authenticate: Bearer realm="teardrop",
      bootstrap_uri="/token", bootstrap_grant="x402"
  2. 02 POST /token {"grant_type":"x402"} 402 live
    "resource": { "url": "https://api.teardrop.dev/token" },
    "accepts": [{ "scheme": "exact",
      "network": "eip155:8453", "amount": "50000" }]
  3. 03 POST /token + Payment-Signature 200 docs
    { "access_token": "…", "org_id": "…",
      "client_id": "…", "client_secret": "…" }

04 / Run

One agent loop,
streamed as typed events.

POST /agent/run plans, runs tool calls concurrently, and renders structured UI, streaming every step over AG-UI. Conversation state is checkpointed in Postgres, so threads resume across turns.

  • planner → tool_executor → ui_generator, looping until the final turn
  • A2UI components: text, table, columns, rows, form, button, progress
  • At capacity, an instance answers 503 + Retry-After instead of queueing in memory
  • Runs that end in a platform error are not billed
AG-UI event stream
  1. 01 POST /agent/run SSE docs
    RUN_STARTED
    TOOL_CALL_START
    TOOL_CALL_END
    SURFACE_UPDATE       A2UI components
    USAGE_SUMMARY        {"tokens_in":1500,"tokens_out":800,
                          "tool_calls":3,"cost_usdc":15000,
                          "delegation_cost_usdc":52500}
    BILLING_SETTLEMENT   {"amount_usdc":67500,"network":"credit"}
    RUN_FINISHED
    DONE

05 / Delegate

Hand off a task.
Pay, poll, or don’t wait.

Any A2A agent can send Teardrop a task over /message:send with a bearer token or a per-request x402 payment. One header switches to async: take a task ID now, poll for the result later.

  • An x402-paid task that completes but fails to settle is withheld and never charged later
  • A full async queue answers 503 with Retry-After: 1
  • Event triggers start runs from webhooks, authenticated with X-Teardrop-Trigger-Secret
A2A inbound captured 2026-10-16
  1. 01 GET /.well-known/agent-card.json 200 live
    "asyncTasks": {
      "enabled": true,
      "request_header": "Prefer: respond-async",
      "status_endpoint": "/message:status/{task_id}",
      "max_concurrency": 8, "queue_size": 100
    }
  2. 02 POST /message:send 402 live
    "resource": { "url": "https://api.teardrop.dev/message:send" },
    "accepts": [{ "scheme": "exact",
      "network": "eip155:8453", "amount": "10000" }]
  3. 03 POST /message:send Prefer: respond-async 202 docs
    Location: …
    "metadata": { "statusPath": "…" }
  4. 04 GET /message:status/{task_id} 200 docs
    submitted → working → terminal task projection