Log inSubmit server
Pagemap logo

Pagemap

by Retio-ai

Compresses web pages into structured maps for token-efficient browsing, interaction, navigation, and form automation.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Pagemap

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "retio-ai-pagemap": {
      "command": "uvx",
      "args": [
        "retio-pagemap"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

uvx retio-pagemap

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

Retio-ai/pagemap MCP server turns web pages into compact, structured maps with numbered references for agent interaction. It exposes tools for reading pages, clicking, typing, selecting, filling forms, scrolling, waiting, taking screenshots, and managing tabs. Use it when browser tasks need actionable page context without passing large raw HTML or accessibility trees through the model.

Use cases

  • Browse product pages and extract purchase options
  • Fill and submit multi-field web forms
  • Compare several URLs with parallel page-map requests
  • Navigate authenticated or multi-step browser workflows
  • Inspect dynamic pages after scrolling or waiting

Key features

  • Token-reduced structured page maps
  • Reference-based browser actions
  • Multi-tab session management
  • Dynamic-content and barrier handling
  • E-commerce metadata extraction
  • Parallel URL mapping

Tools13

What Pagemap lets your agent do. Expand a tool for its parameters.

Self-reported~236 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

20/21 checks healthy over the last 91d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · retio-pagemap (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars36Stargazers on the source repository.
Last commit5mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed13Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Pagemap works

What Retio-ai/pagemap does

Retio-ai/pagemap is a Browser Automation server that uses Chromium to give MCP clients a compact representation of web pages. Instead of returning the full HTML, it builds structured maps generally sized at 2–5K tokens from pages that may contain 100K or more tokens of markup. Maps include numbered references that agents can use for subsequent actions.

The Retio-ai/pagemap MCP server supports 16 detected page types, including product pages, search results, articles, forms, checkouts, dashboards, documentation, and error pages. It also provides structured e-commerce data such as prices, options, ratings, availability, descriptions, and images. Built-in coverage includes more than 30 named e-commerce sites, including Amazon, eBay, Walmart, Nike, Coupang, ZOZO, Tmall, and Taobao.

How it works

Start with get_page_map to navigate to a URL and obtain the current page structure. Use the returned reference numbers with execute_action to click, type, select, or hover. fill_form handles several fields in one request, while scroll_page and wait_for help expose lazy-loaded or delayed content. After an action that may change the page, get_page_state reports the current URL and title without rebuilding the complete map.

The server maintains browser sessions and supports multiple tabs through open_tab, switch_tab, list_tabs, and close_tab. navigate_back moves through browser history, and batch_get_page_map retrieves several URLs in parallel. Screenshots are available when the structured map does not provide enough visual context.

PageMap includes handling for cookie consent dialogs, promotional overlays, login barriers, bot-detection pages, and stale references. It can identify several common CAPTCHA and bot-protection providers and report barriers with suggested next steps. Content is treated as untrusted input, with SSRF controls, prompt-injection defenses, resource limits, robots.txt compliance, and isolated session storage.

Setup and configuration

Install the Python package with pip install retio-pagemap. The local MCP process can run through uvx retio-pagemap, and Chromium is installed automatically on first use. Python 3.11 or newer is required. If automatic browser installation fails, Chromium can be installed manually with playwright install chromium.

The Retio-ai/pagemap MCP server runs in STDIO mode by default. Docker is also supported through the published image, using HTTP transport with a command such as docker run -p 8000:8000 retio1001/pagemap --transport http. For Claude Desktop on macOS, the configuration may need an absolute path to uvx; VS Code uses servers rather than mcpServers in its MCP configuration file.

Private IP addresses are blocked by default. Local targets require the --allow-local option or PAGEMAP_ALLOW_LOCAL=1.

Tools and capabilities

  • Build compact page maps with numbered interactable references.
  • Click, type, select, hover, and fill multiple form fields.
  • Scroll, wait for dynamic content, inspect page state, and capture screenshots.
  • Open, switch, list, and close tabs, or navigate backward.
  • Fetch page maps for multiple URLs in parallel.
  • Extract supported metadata and JSON-LD types, including products, articles, videos, FAQs, events, local businesses, breadcrumbs, and item lists.
  • Produce agent-oriented text, JSON, or optional delta evidence packets through the Python API.

Limitations and notes

The first browser navigation can take roughly 10–30 seconds while Chromium starts; later pages are expected to load faster. The server does not bypass website access controls, and users remain responsible for complying with target-site terms and applicable law. Localhost and other private targets need explicit permission. The package is licensed under AGPL-3.0.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pagemap

Retio-ai/pagemap is an MCP server that connects AI agents to web pages through Chromium browser automation. Its main tools build compact page maps, perform clicks and form actions, inspect page state, handle scrolling and waits, capture screenshots, and manage tabs. It is designed for actionable browsing with reduced token usage.

Install it with `pip install retio-pagemap` or run it through `uvx retio-pagemap` in an MCP client configuration. Chromium is installed automatically on first use, and Python 3.11 or newer is required. Docker deployment is also available with the published `retio1001/pagemap` image.

Yes, Retio-ai/pagemap works with Cursor through an MCP configuration using the `uvx` command and `retio-pagemap` argument. The same setup pattern is documented for Claude Code, Windsurf, and Claude Desktop.

Enable local access with the `--allow-local` option or set `PAGEMAP_ALLOW_LOCAL=1`. Private IP addresses and localhost are blocked by default as part of the server's SSRF protections.

Related MCP servers

All in Browser Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPagemap AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/retio-ai-pagemap?style=directory)](https://allmcps.com/mcp/retio-ai-pagemap)
HTML Embed
<a href="https://allmcps.com/mcp/retio-ai-pagemap"><img src="https://allmcps.com/api/badge/retio-ai-pagemap?style=directory" alt="Pagemap on AllMCPs" /></a>