TaskFuel
TaskFuel (opens in a new tab) lets agents discover and call paid APIs through one prepaid USD balance, topped up by card, Bitcoin or stablecoins, so one agent pays for SpecStream and the 3,000+ other tools in TaskFuel's catalog (opens in a new tab) from the same balance. SpecStream's Search API and Extract API take payment per call over x402, so an agent pays for one search or one page read with no SpecStream account and no key, through TaskFuel or from its own wallet.
SpecStream for TaskFuel, API & cloud platformsWhat you need
- A TaskFuel account with a balance, and the
taskfuelCLI or TaskFuel's MCP server connected to your agent. TaskFuel's docs (opens in a new tab) cover both. - No SpecStream account or key. Each call is paid when it's made.
- 1
1. Connect TaskFuel
In a shell, install TaskFuel's CLI and check which account it spends from. If
taskfuel whoamishows no connection, runtaskfuel connectand approve the code it prints in your browser:Terminal - 2
2. Find SpecStream's endpoints
TaskFuel's gateway calls only the domains in its catalog and refuses the rest. List what it offers on
api.specstream.ai, then read the search endpoint's parameters:Terminal - 3
3. Search
Quote the search, then make the call with the quoted price as its ceiling. Send the question in
q, in everyday words. The reply'sdata.answer.valueholds a short answer when the pages give one, anddata.sourceslists each page with itstitle,urlandsnippet:Terminal - 4
4. Read the pages you need
POST /v1/extractreturns the main text of 1 to 20 pages or documents in one call, at $0.002 for each URL you send, so set--max-amountto $0.002 times the number of URLs. Each item ofdata.resultshas the page'surl, astatus, and itstextwhen the status isok:Terminal
From your app or over MCP
A server sends SpecStream's URL, method and body to TaskFuel's POST https://app.taskfuel.ai/v1/call with its own TaskFuel key and a maxAmountUsd ceiling. SpecStream's response comes back as it was sent, and the x-taskfuel-cost header holds what the call cost:
Over MCP
An agent connected to TaskFuel's MCP server at https://app.taskfuel.ai/mcp uses its discover and call tools with the same URLs and bodies, and max_amount_usd as the ceiling.
Pay with your own wallet
Any x402 v2 client pays SpecStream directly, with no TaskFuel balance in between:
- Call
GET https://api.specstream.ai/v1/web-search?q=<the question>orPOST https://api.specstream.ai/v1/extractwith{"urls": ["<url>", ...]}, with no key. - SpecStream answers
402 Payment Requiredwith aPAYMENT-REQUIREDheader: theexactscheme at the call's fixed price in USDC on Base, Arbitrum or Polygon. - Your client signs it and sends the same request again with the payment in
PAYMENT-SIGNATURE. - The answer comes back with a
PAYMENT-RESPONSEheader naming the transaction.
Machine-readable terms
Both endpoints, with their x402 terms and an example request, are at https://api.specstream.ai/.well-known/x402 (opens in a new tab). A whole list of records, every match on the live web in structured rows, is bought over x402 the same way, up to a maximum you sign for: Agent payments has the steps.
Errors
402from TaskFuel: the TaskFuel balance is empty. Top it up at app.taskfuel.ai (opens in a new tab).- A refusal above your ceiling: the price is higher than
--max-amountormaxAmountUsd. Nothing is charged. Quote again and set the ceiling to the quoted price. 429withRetry-After: the payer sent more calls in a minute than SpecStream allows, or a payment didn't settle. Wait that many seconds and send it again.- A timeout in your own client: the call still runs and is paid. Fetch the response back with
taskfuel resultinstead of calling again.
Cost
A search of up to 10 results is $0.007, or $0.002 with speed=fast, news=true or images=true. A page read is $0.002 for each URL you ask for. The price is taken when the payment settles, before the call runs, so a search with no result or a page with no text is paid. TaskFuel bills each call at that price and charges its own fee when you add credit, as its pricing page (opens in a new tab) shows. With a SpecStream API key instead, the same calls cost $5 per 1,000 searches and $0.80 per 1,000 pages. Balance, quotes, and billing has the details.
Remove
SpecStream holds no account or key for these calls, so there is nothing to remove on our side. To stop an agent paying through TaskFuel, revoke its key at app.taskfuel.ai/keys (opens in a new tab). Questions go to [email protected].
More
SpecStream for TaskFuel covers what it does in TaskFuel on one page. Every other tool has its guide in Connect your tools. You see the most a request can cost before it starts, and the matches are paid from your balance. Billing has the details. For help, email [email protected].