chrome_use_read
Fetch any URL or the active browser tab as clean, agent-readable markdown, with options for raw HTML, heading outlines, links, or llms.txt content.
Instructions
Fetch a URL (or the active tab, if url is omitted) as agent-readable text/markdown.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "chrome_use_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | Return raw HTML instead of cleaned markdown. | |
| url | No | URL to read; omit to read the active tab. | |
| llms | No | Read from the site's llms.txt instead of the page itself. | |
| force | No | With tabId: act on a tab this session does not own (the user's own, or another session's), in place and in the background (--tab <handle> --force). Only when the user asked you to act on that tab; the result has forced: true and the tab's title and url. | |
| links | No | Append the page's links as absolute URLs (a `## Links` section; at most 100 unless maxLinks). | |
| tabId | No | Target tab id (e.g. t2), label, or targetId (--tab). | |
| filter | No | Literal, ASCII-case-insensitive filter for page sections, llms links/sections or outline headings. Not a regex; page reads prefer matching headings and their descendants. | |
| outline | No | Return only the heading outline instead of full content. | |
| session | No | Isolated session name (chrome-use --session <name>). Each session gets its own tab group, browser tab and element refs. Omit it unless several agents share ONE MCP server — the session is otherwise derived per agent automatically. When you do share a server with sibling agents, pass a name unique to you on every call, or you will drive their tabs and invalidate their refs. | |
| maxLinks | No | Cap for links (1-1000); implies links. | |
| requireMd | No | Fail instead of falling back to raw text if markdown conversion is unavailable. | |
| timeoutMs | No | Kill the underlying chrome-use process if it hasn't responded after this many ms (default 30000). | |
| includeHidden | No | Keep text a person can't see on the active tab (a url is fetched without rendering and is never filtered) (off-screen, transparent, clipped, zero-size). Left out by default and counted in hiddenText/a note, because pages hide instructions aimed at agents there (--include-hidden). |