readfetch_search
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. Run a web search without a separate search API subscription. Returns titles, URLs, and snippets only — not full page text; follow with readfetch_text, readfetch_probe, or readfetch_scrape on a chosen result URL. limit is 1–20 (default 5). Optional lang biases locale (e.g. en, de-DE). Optional tbs filters recency: h= past hour, d= day, w= week, m= month, y= year. Use readfetch_map/readfetch_crawl when you already know the site; readfetch_* URL tools when you have the link.
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": {
"query": "<query>"
},
"name": "readfetch_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tbs | No | Optional recency filter: h=hour, d=day, w=week, m=month, y=year. | |
| lang | No | Optional language/locale hint, e.g. en or de-DE. | |
| limit | No | Maximum number of results to return (default 5). | |
| query | Yes | Search query string. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| query | No | ||
| billed | No | ||
| status | No | ||
| results | No |