PageMap MCP Server

Structured web page representation for AI agents — 97% HTML token reduction

Remote serverstreamable-httpPython

What is the PageMap MCP server?

PageMap MCP server is a hosted integration for AI assistants that speak the Model Context Protocol. Structured web page representation for AI agents — 97% HTML token reduction.

What you get

PageMap converts raw HTML (100K+ tokens) into structured, AI-readable page maps (2-5K tokens) — a 97% token reduction. It works as an MCP server, Python SDK, and CLI, supporting 16 page types and 30+ e-commerce sites. Agents can read, click, type, and navigate any web page.

What the assistant can call

Once PageMap is connected, these are the calls the assistant has available:

  • get_page_mapStart here. Navigate to a URL and get a full structured map with numbered refs
  • execute_action — Click, type, select, or hover using a ref number from the last get_page_map
  • fill_form — Fill multiple form fields in one call. More efficient than sequential execute_action calls
  • get_page_state — Check current URL and title without a full rebuild. Use after actions that may navigate
  • scroll_page — Scroll to reveal lazy-loaded content before calling get_page_map again
  • wait_for — Wait for dynamic content to appear (e.g. after a search or form submit)
  • take_screenshot — Capture the visual state when the PageMap alone is ambiguous
  • navigate_back — Go back one step in browser history
  • open_tab — Open a new browser tab and navigate to a URL
  • switch_tab — Switch to a different open tab by index
  • list_tabs — List all open tabs with their URLs and titles
  • close_tab — Close a tab by index

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Configuration and credentials

  • Python 3.11+ - Chromium (auto-installed on first use)

Choosing this one

Among the browser automation options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. PageMap's toolset — get_page_map, execute_action, fill_form and 11 more — is a fair guide to whether it matches your workflow. It is maintained by Retio-ai; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch PageMap.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the pagemap mcp server does with a few real requests.

Available tools

ToolWhat it does
get_page_map**Start here.** Navigate to a URL and get a full structured map with numbered refs.
execute_actionClick, type, select, or hover using a ref number from the last get_page_map.
fill_formFill multiple form fields in one call. More efficient than sequential execute_action calls.
get_page_stateCheck current URL and title without a full rebuild. Use after actions that may navigate.
scroll_pageScroll to reveal lazy-loaded content before calling get_page_map again.
wait_forWait for dynamic content to appear (e.g. after a search or form submit).
take_screenshotCapture the visual state when the PageMap alone is ambiguous.
navigate_backGo back one step in browser history.
open_tabOpen a new browser tab and navigate to a URL.
switch_tabSwitch to a different open tab by index.
list_tabsList all open tabs with their URLs and titles.
close_tabClose a tab by index.
batch_get_page_mapFetch multiple URLs in parallel. Use for comparison tasks.
DisclaimerUsers are responsible for complying with the terms of service of target websites and all applicable laws when using PageMap.

How to install the PageMap MCP server

{
  "mcpServers": {
    "pagemap": {
      "command": "uvx",
      "args": ["ENOENT"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.11+ - Chromium (auto-installed on first use)

Example prompts to try

  • Use PageMap to get page map.
  • Use PageMap to execute action.
  • Use PageMap to fill form.

Frequently asked questions

It connects PageMap to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (get_page_map, execute_action, fill_form, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with PageMap directly.