PageMap — Claude Code MCP server: what it does, how to install
Compiles heavy HTML into lightweight maps of 2-5K tokens so autonomous agents can navigate websites, submit forms, and click elements.
claude mcp add pagemap -- uvx retio-pagemapWhat PageMap does
Accessibility trees quickly exhaust context windows during multi-step browser tasks. PageMap solves this bottleneck. It strips bloated raw markup down to structured page maps, cutting token usage by 97%. The tool classifies 16 distinct page layouts, handling product listings, authentication screens, and articles.
Web control relies on 13 dedicated tools, including get_page_map, fill_form, and multi-tab actions. Chromium downloads automatically on initial launch. Built-in heuristics detect bot challenges like Cloudflare and dismiss cookie banners using a privacy-first rejection strategy.
What it helps with
- shrink raw page markup down to 2-5K tokens
- interact with web forms, buttons, and multiple tabs
- dismiss cookie consent popups using reject policies
- identify anti-bot barriers like Turnstile or Cloudflare
Example prompts for the agent
- Inspect the shopping cart page and extract item totals
- Submit the login form and switch to the second tab
- Capture a screenshot after scrolling to the footer
How to install PageMap
Platform CLI
claude mcp add pagemap -- uvx retio-pagemapuvx runs the command named after the package; if the README names another one, use uvx --from retio-pagemap <command>
Platform CLI
codex mcp add pagemap -- uvx retio-pagemapuvx runs the command named after the package; if the README names another one, use uvx --from retio-pagemap <command>
Config file
{
"mcpServers": {
"pagemap": {
"command": "uvx",
"args": [
"retio-pagemap"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from retio-pagemap <command>
Config file
{
"servers": {
"pagemap": {
"type": "stdio",
"command": "uvx",
"args": [
"retio-pagemap"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from retio-pagemap <command>
Platform CLI
gemini mcp add pagemap uvx retio-pagemapuvx runs the command named after the package; if the README names another one, use uvx --from retio-pagemap <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PageMap
How to install PageMap in Claude Code?
Run claude mcp add pagemap -- uvx retio-pagemap in your terminal. The tool configures itself via uvx without manual browser setup.
What does PageMap do?
It turns dense HTML into small 2-5K token structures. Agents use these maps to read content and interact with web pages across long browsing sessions.
Do I need to install Chromium or Playwright manually?
No extra setup is required. PageMap installs Chromium in the background upon its first execution.
