Page Map MCP Server - install, status & alternatives [2026]

01 · Install Page Map

Claude Code

claude mcp add retio-ai-retio-pagemap -- uvx retio-pagemap

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "retio-ai-retio-pagemap": {
      "command": "uvx",
      "args": [
        "retio-pagemap"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license no standard license detected - usage rights unclear; check the repo before commercial use

pypi package retio-pagemap - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.Retio-ai is GitHub-verified and matches the repo owner

03 · What Page Map can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can start here. Navigate to a URL and get a full structured map with numbered refs, click, type, select, or hover using a ref number from the last get_page_map, fill multiple form fields in one call. More efficient than sequential execute_action calls, and check current URL and title without a full rebuild. Use after actions that may navigate.

Capability map

Tools grouped from the project's README - what Page Map lets an agent do.

read & search

3 tools - e.g. Start here. Navigate to a URL and get a full structured map with numbered refs.; Check current URL and title without a full rebuild. Use after actions that may navigate.; List all open tabs with their…

get_page_map · get_page_state · list_tabs

run & execute

1 tool - e.g. Click, type, select, or hover using a ref number from the last get_page_map.

execute_action

Fill

1 tool - e.g. Fill multiple form fields in one call. More efficient than sequential execute_action calls.

fill_form

Scroll

1 tool - e.g. Scroll to reveal lazy-loaded content before calling get_page_map again.

scroll_page

Wait

1 tool - e.g. Wait for dynamic content to appear (e.g. after a search or form submit).

wait_for

Take

1 tool - e.g. Capture the visual state when the PageMap alone is ambiguous.

take_screenshot

Navigate

1 tool - e.g. Go back one step in browser history.

navigate_back

Open

1 tool - e.g. Open a new browser tab and navigate to a URL.

open_tab

Latest releases

v1.1.1 · 2026-05-21

Release retio-pagemap v1.1.1. Includes the Delta Intelligence evidence packet serializer and refreshes vulnerable dependency floors so the trusted-publishing release passes audit. PyJWT advisory PYSEC-2025-183 is…

v1.1.0 · 2026-05-21

Release retio-pagemap v1.1.0. Adds Delta Intelligence evidence packet output via pagemap.delta_serializer with digest-bound evidence units, claim candidates, provenance, and closed authority flags for downstream…

v1.0.0 · 2026-03-10

PageMap v1.0.0 - First Public Release · The browsing MCP server that fits in your context window. Compresses ~100K-token HTML into a 2-5K-token structured map while preserving every actionable element. · Highlights…

04 · Who maintains Page Map

PageMap is maintained by retio-ai. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/retio-ai/retio-pagemap
category: browser automation - ranked #121 of 196 actively-maintained browser automation servers as of 2026-08-25.
registry: io.github.Retio-ai/pagemap (active, first published 2026-02-17 · 7 versions)
packages: pypi:retio-pagemap · oci:docker.io/retio1001/pagemap:0.7.3

06 · Page Map FAQ

Is Page Map still maintained?

Yes - as of 2026-08-25, its last commit was 2026-05-21. We re-verify nightly.

What can Page Map do?

With this server connected, an agent can start here. Navigate to a URL and get a full structured map with numbered refs, click, type, select, or hover using a ref number from the last get_page_map, fill multiple form fields in one call. More efficient than sequential execute_action calls, and check current URL and title without a full rebuild. Use after actions that may navigate.

How do I install Page Map?

Run `uvx retio-pagemap`. You can also paste the ready-made client config above.

Does Page Map run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Page Map

Alternatives to Page Map

Maintained browser automation servers if Page Map isn't the fit.

Pairs well with

Servers that cover what Page Map doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · Cochlea · Fenestra MCP · IDA Pro MCP Fusion · Browser Agent · Mobile Device MCP

More Python MCP servers · PSX MCP · Linux MCP Server · Prolog Reasoner · TractorBeeam365 MCP · Projectmem · see all