readfetch_batch
Paid routes require a funded Base USDC wallet. Use readfetch-client / @readfetch/client or the MCP signing proxy (@readfetch/mcp-x402-proxy). Direct calls without a signing client will stop at 402. Read a fixed list of public HTML pages in one call—the same article extraction as POST /v1/text for each URL (Markdown or plain text plus title and metadata). One x402 payment covers the batch (minimum 3 pages quoted; URLs deduped, max 50). Returns results in input order: each item has url, status_code, text, billed, and hint when undelivered, plus batch-level delivered, failed, billed_pages, and optional credit for unused pages. Undelivered pages are not billed. Use readfetch_text for one URL, readfetch_map then readfetch_crawl to discover and walk a site, readfetch_scrape when JavaScript is required. Read-only; 402 without PAYMENT-SIGNATURE like other paid tools.
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": {
"urls": "<urls>"
},
"name": "readfetch_batch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | Yes | URLs to read, deduped before quoting. | |
| format | No | Per-item output flavour, same as /v1/text: markdown (default) or plain text. | markdown |
| pipeline | No | text (default) = HTTP-first per URL, same as readfetch_text; use render when probe reported challenge:true or items need JavaScript — bills like scrape per undelivered page, not like plain text. | text |
| timeout_s | No | Total budget for the whole batch in seconds; every item shares it and no item restarts it. | |
| accept_language | No | Accept-Language header for every item, e.g. 'de-DE,de;q=0.9'. Defaults to en-US when omitted. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| credit | No | ||
| failed | No | ||
| status | No | ||
| results | No | ||
| delivered | No | ||
| billed_pages | No |