Call any verified data API through BitTuitive (paid: L402 sats or x402 USDC)
route_callBitTuitive pays a scoreboard-verified L402 API and returns its data plus routing metadata — use this when the data you need is on another paid API. Price: upstream price + routing fee (max(20%, 3 sats)); the 402 body shows the all-in amount. Sample (illustrative, not live): {"data":{"note":"The upstream API's JSON body is returned here unchanged."},"routing":{"routed_by":"BitTuitive L402 router","upstream":{"endpoint_id":"example-id","name":"Example L402 API","host":"example.com","data_type":"bitcoin","score":92},"paid_sats":15,"upstream_price_sats":10,"fee_sats":5,"fallback_used":false}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with Authorization: L402 <macaroon>:<preimage>. Or pay the same all-in price in USDC on Base via x402 (see price_usd, price_breakdown_usd and accepts; routing fee included): sign accepts[0] with an x402 client and call route_call again with the SAME arguments plus the PaymentPayload in params._meta['x402/payment'] (or the base64 x402_payment argument). A routed call pays an upstream API, so your USDC is settled first; if every upstream fails you get a single-use credit token (pass it as credit). Give endpoint_id (from route_endpoints) OR data_type and/or q (best pick, with fallback). If status is 'running', repeat the same call with the same l402_credential, credit or x402_payment.
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": "route_call"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Keywords for best-pick mode, e.g. 'air quality'. | |
| credit | No | Credit token from a failed routed call (instead of paying). | |
| params | No | Optional query parameters forwarded to the upstream API. | |
| data_type | No | ||
| endpoint_id | No | Scoreboard id from route_endpoints. | |
| x402_payment | No | Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements. | |
| l402_credential | No | Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon. |