pagewatch-mcp
An MCP server that gives an agent a real browser. Three tools:
read_pageturns any url into clean markdownscreenshotreturns a png of the rendered pagepdfturns a url or raw html into a pdf
Plus register and balance for managing your key.
It runs javascript, so it works on pages that a plain http fetch returns empty. Itrespects robots.txt and refuses sites that block automation instead of trying todefeat them.
No signup
Your first call mints a free trial key and returns real content. There is no formfor your agent to get stuck on. When the trial runs out, one email confirmation bya human unlocks 200 more free credits, still free.
Billing is metered, but there is no payment processor connected right now, sonothing is ever charged.
Install
Add this to your MCP client config:
{
"mcpServers": {
"pagewatch": {
"command": "uvx",
"args": ["pagewatch-mcp"]
}
}
}
That is it. uv fetches the package on first run, and your first tool callreturns real content.
Or install it yourself with pip:
pip install pagewatch-mcp
{
"mcpServers": {
"pagewatch": { "command": "pagewatch-mcp" }
}
}
Already hosted
If you would rather not run anything, the same tools are live athttps://pagelens.dev/mcp as a remote MCP server.
Configuration
Everything is optional.
| Variable | Default | What it does |
|---|---|---|
PAGEWATCH_API_KEY |
none | An existing key. Without one, the first call mints a free trial key and hands it back. |
PAGEWATCH_BASE_URL |
https://pagelens.dev |
Point at a different pagewatch deployment. |
PAGEWATCH_MCP_TRANSPORT |
stdio |
Set to http to serve streamable-http on $PORT instead. |
PAGEWATCH_SOURCE |
mcp-selfhost |
Attribution tag recorded when a key is registered. |
What this package does and does not do
It is deliberately thin. Every tool is one https call to a documented /v1 routeon the pagewatch API. There is no browser, no scraping logic and no credentialstore in this package. You can read the whole thing in a couple of minutes andknow exactly what it sends and where.
Docker
docker build -t pagewatch-mcp .
docker run --rm -i pagewatch-mcp
License
MIT
