rasterly
Web toolkit for AI agents: read any URL as Markdown, screenshot, extract data, or crawl a site.
Open source Open in the app JSON README (API)
About
Web toolkit for AI agents: read any URL as Markdown, screenshot, extract data, or crawl a site.
Details
- Kind
- MCP servers
- Topic
- Web search, scraping & browser
- Publisher
- rasterly-dev
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.2.1
- Last push
- 2026-08-26T11:08:45Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:16
- Updated
- 2026-08-29 04:01:16
- Origin id
io.github.rasterly-dev/rasterly-mcp
README
# rasterly-mcp
Give any AI agent **eyes and a reader for the live web.** An MCP server that lets
your agent turn a URL into clean Markdown, a screenshot it can actually see, or a PDF —
backed by [rasterly](https://rasterly.dev), a real headless-Chromium rendering API.
Works in any MCP client: Claude Desktop, Claude Code, Cursor, Windsurf, and others.
## Tools
| Tool | What the agent gets |
|------|---------------------|
| `read_url` | The page's main content as **clean, LLM-ready Markdown** — JS is rendered, nav/ads/boilerplate stripped. Use it to *read* a URL. |
| `capture_url` | A **screenshot** returned as an image, so the agent can *see* the page (layout, charts, anything visual). `full_page` optional. |
| `url_to_pdf` | A print-ready **PDF** of the page (base64 resource). |
Why an agent wants this: a plain `fetch()` gets you raw HTML that a modern, JS-rendered
site won't even populate. `read_url` runs a real browser and hands back just the article —
far fewer tokens, far more signal.
## Install
Get a key at **[rasterly.dev](https://rasterly.dev)** (free tier: 100 renders/month), then add
the server to your MCP client.
**Claude Desktop / Claude Code / Cursor** — add to your MCP config
(`claude_desktop_config.json`, `.mcp.json`, or the client's MCP settings):
```json
{
"mcpServers": {
"rasterly": {
"command": "npx",
"args": ["-y", "rasterly-mcp"],
"env": { "RASTERLY_API_KEY": "sk_live_your_key" }
}
}
}
```
Restart the client. Your agent now has `read_url`, `capture_url`, and `url_to_pdf`.
## Try it
Ask your agent things like:
- *"Read https://news.ycombinator.com and summarize the top 3 posts."*
- *"Screenshot stripe.com and tell me what the hero section says."*
- *"Turn this docs page into a PDF."*
## Config
| Env var | Default | Notes |
|---------|---------|-------|
| `RASTERLY_API_KEY` | – | Your rasterly key (sent as `X-Api-Key`). |
| `RASTERLY_API_URL` | `https://rasterly-production.up.railway.app` | Override to point at a self-hosted rasterly. |
## Run standalone
```bash
RASTERLY_API_KEY=sk_live_… npx -y rasterly-mcp
```
MIT · built on [rasterly](https://rasterly.dev)