read_page
Fetch a public web page and return only the part you need instead of the raw HTML. view: markdown (main content, navigation and boilerplate removed), outline (headings), links (all links; query keeps those whose URL or text contains it), tables (one table, chosen by table, as a markdown table), find (only passages mentioning query; query required). Use this for any single page; use read_package_info for PyPI, npm and crates.io, and run_pipeline for multi-step extraction (e.g. filtering a table's rows). Reads the live page each call and doesn't run JavaScript, so pages built in the browser may come back thin. Only public http(s) addresses. Fetches are limited to 60 a minute per client. Errors (unreachable site, non-HTML content, no table at that index) come back with a suggested fix. Each call runs a built-in page recipe and is recorded in its public run statistics; otherwise nothing is kept except the result's handle, for 60 minutes.
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": "read_page"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public http(s) URL of the page. | |
| view | No | markdown | |
| query | No | find: the word or phrase to look for (required). links: keep links whose URL or text contains it. | |
| table | No | tables: which table, 0 = first, -1 = last. | |
| max_tokens | No | Most tokens to return. markdown is trimmed (and marks the cut); other views return a preview and handle instead. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | No | markdown/outline: text. links: [{href, text}]. tables: markdown table. find: [{match, context, line, offset}]. | |
| handle | No | Handle id (h_...) of the full result, for run_op or read_handle. | |
| preview | No | Instead of value, when the result is over max_tokens. | |
| warning | No | The result looks wrong for this view, e.g. empty. |