readfetch_map
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. Discover a site's crawlable surface without crawling it: parse robots.txt allow/disallow rules, collect URLs from sitemap.xml and sitemap indexes, find RSS, Atom and JSON feeds, and count internal and external links on the homepage. Use the returned URLs to plan readfetch_scrape, readfetch_batch, or readfetch_crawl — not readfetch_map again on each URL. Prefer readfetch_probe on one URL before paying for bodies.
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": {
"url": "<url>"
},
"name": "readfetch_map"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public http(s) URL of the site to map. | |
| limit | No | Maximum number of URLs to return (1-1000). | |
| max_bytes | No | Abort if any single document exceeds this many bytes. | |
| timeout_s | No | Total budget for the whole call in seconds; every sitemap fetch and the browser fallback share it. 95 s is the edge ceiling (Cloudflare closes at 100 s). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| host | No | ||
| urls | No | ||
| feeds | No | ||
| links | No | ||
| billed | No | ||
| robots | No | ||
| status | No | ||
| sitemaps | No | ||
| url_count | No | ||
| status_code | No | ||
| total_found | No |