Pagewatch
Read a URL as clean markdown, screenshot a website, url to PDF. Web access for agents, no signup.
Open source Repository Open in the app JSON README (API)
About
Read a URL as clean markdown, screenshot a website, url to PDF. Web access for agents, no signup.
Details
- Kind
- MCP servers
- Topic
- Files & documents
- Publisher
- dev.pagelens
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.2.3
- Last push
- 2026-07-25T09:35:15Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:01:30
- Updated
- 2026-08-29 03:01:30
- Origin id
dev.pagelens/pagewatch
README
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:
```json
{
"mcpServers": {
"pagewatch": {
"command": "uvx",
"args": ["pagewatch-mcp"]
}
}
}
```
That is it. [uv](https://docs.astral.sh/uv/) fetches the package on first run, and your first tool call
returns real content.
Or install it yourself with pip:
```bash
pip install pagewatch-mcp
```
```json
{
"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
```bash
docker build -t pagewatch-mcp .
docker run --rm -i pagewatch-mcp
```
## License
MIT