igorsaevets/page2ai-mcp

No downloads badge on purpose: npm download counts are dominated by registry mirrors and
bots, and this README only shows numbers a human can trust.
> One-click webpage-to-Markdown MCP server for ChatGPT, Claude, and Gemini.
> Preserves code blocks with language hints, tables, and reading structure.
> Fetch, extract, convert — one tool, one command, entirely on your machine.
> No API key, no account, no telemetry; the only network requests are to the URLs you pass it.
Companion to the Page2AI Chrome & Firefox extensions;
both share the same @page2ai/core extraction library.
Quick start
This starts the stdio MCP server — it waits silently for a client, so wire it into one of
the clients below rather than running it bare. Requires **Node.js 20+**. No API key. If
npx ever serves you a stale cached version, run npx -y page2ai-mcp@latest once.
page2ai-mcp is a thin unscoped wrapper around @page2ai/mcp;
since 0.2.5 it follows the latest server automatically via a ^ range.
Hosted endpoint (beta) — no install at all
For clients that only accept a remote MCP server URL (Streamable HTTP):
Same tool, same code (see remote/), rate-limited per IP.
**Privacy trade-off:** URLs sent to the hosted endpoint are fetched *from that
server*, so they transit infrastructure operated by the author (on Vercel).
Running locally via npx keeps everything on your machine — prefer it when you
can.
Claude Code
Claude Desktop
One-click bundle: download page2ai-mcp- .mcpb from the
latest release, then in
Claude Desktop open **Settings → Extensions → Advanced settings → Install Extension…**
and pick the file.
Or add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/,
Windows: %APPDATA%\Claude\), then fully quit and restart Claude Desktop:
Cursor
Or add to ~/.cursor/mcp.json (global) / .cursor/mcp.json (project):
VS Code (GitHub Copilot)
Or add to .vscode/mcp.json:
Codex CLI
Gemini CLI
Antigravity
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json (macOS/Linux) or
%USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):
Zed
Add to settings.json (zed: open settings file):
Other MCP clients
Any client that speaks MCP over stdio works — Cline, Continue, JetBrains AI Assistant,
LM Studio and others. Point their MCP server settings at the same command:
npx -y page2ai-mcp.
Letting an AI agent install it
If an AI agent (Cline, Claude Code, Codex, …) is doing the setup for you, point it at
llms-install.md — a machine-oriented install guide with the exact
command per client and a verification step.
Tools
| Tool | Description | Read-only | Example |
|------|-------------|-----------|---------|
| page_to_markdown | Fetch a web page URL and convert to clean Markdown | ✅ | page_to_markdown(url="https://docs.anthropic.com/en/api/messages") |
Example prompts
**1. Fetch documentation and answer questions:**
> "Use page_to_markdown to fetch https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking and summarize the three main use cases for extended thinking."
**2. Extract API reference into a code snippet:**
> "Fetch https://ai.google.dev/gemini-api/docs/thinking with page_to_markdown, then generate a Python code sample using the thinking budget parameter."
**3. Compare two documentation pages:**
> "Fetch both https://docs.anthropic.com/en/docs/prompt-engineering and https://platform.openai.com/docs/guides/prompt-engineering with page_to_markdown, then summarize the differences in approach."
What a call returns
Verbatim output of page_to_markdown(url="https://docs.anthropic.com/en/api/messages"),