Skip to main content

mcp-name: dev.pagelens/pagewatch

pagewatch-mcp

An MCP server that gives an agent a real browser. Three tools:

  • read_page turns any url into clean markdown
  • screenshot returns a png of the rendered page
  • pdf turns 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. It respects robots.txt and refuses sites that block automation instead of trying to defeat them.

No signup

Your first call mints a free trial key and returns real content. There is no form for your agent to get stuck on. When the trial runs out, one email confirmation by a human unlocks 200 more free credits, still free.

Billing is metered, but there is no payment processor connected right now, so nothing 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 call returns 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 at https://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 route on the pagewatch API. There is no browser, no scraping logic and no credential store in this package. You can read the whole thing in a couple of minutes and know exactly what it sends and where.

Docker

docker build -t pagewatch-mcp .
docker run --rm -i pagewatch-mcp

License

MIT

Release files for pagewatch-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pagewatch-mcp 0.1.1
File Size Uploaded
pagewatch_mcp-0.1.1.tar.gz 5.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pagewatch-mcp 0.1.1
File Interpreter ABI Platform
pagewatch_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 12.5 kB

Release files / pagewatch_mcp-0.1.1.tar.gz

Download URL pagewatch_mcp-0.1.1.tar.gz
Size 5.6 kB
Tags Source
SHA-256 checksum
How to use checksums
fe34987026d45eaebb760488dd8b1370220d2971c0cca88d5dc850eb9aa50a60
BLAKE2b-256 checksum
How to use checksums
95f3dc0c9bc9db6dc60c40e9dabd163470020e05c99fd82bed6a501813a9bb96
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / pagewatch_mcp-0.1.1-py3-none-any.whl

Download URL pagewatch_mcp-0.1.1-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7bba80ceffe6baeb2bca7ab9ebb59753d49cf3ffe878590b28223272b72c5144
BLAKE2b-256 checksum
How to use checksums
021b7941f158699219f9fafd7e3be973733a76f3d40a5e7d7701fec5aa0e5ce6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page