shotanvil-examples
MCP serverDocs & knowledgeshotanvil lets your AI capture screenshots and generate PDFs from web pages and HTML. Once added, your AI can turn online content or HTML into finished images and documents on demand. An API key or x402 is required, as keyless access is disabled.
Available today. Use it from your connected AI after setup.
No other account needed.
After adding it, set up an API key or x402 since it cannot be used without one. You can find usage examples in the repository at github.com/Psykepro/shotanvil-examples.
Then ask your AI: use shotanvil-examples
What your AI can do with it
- Capture screenshots of web pages
- Render HTML into images
- Generate PDF documents from web pages or HTML
From the project's README
As published by psykepro/shotanvil-examples in README.md.
Usage examples and a live-synced OpenAPI spec copy for the shotanvil
screenshot API — 1 screenshot = 1 request, a free tier that's actually free, from $9/mo.
Base URL: https://api.shotanvil.com
Access paths
GET /take and POST /render-html accept three access paths, checked in this order:
- x402 — send an
X-Paymentheader (pay-per-call, no signup, testnet-settled). - API key — send
X-Api-Key: <key>or?access_key=<key>. - Keyless — no credential, IP-rate-limited, only when the operator has keyless access enabled.
An invalid API key always fails with 401 and never falls through to keyless, even when keyless
is enabled — a typo'd paying key never silently downgrades to a lower tier.
Get an API key at shotanvil.com.
Quickstart
Take a screenshot:
curl "https://api.shotanvil.com/take?url=https://example.com" \
-H "X-Api-Key: $SHOTANVIL_API_KEY" \
-o screenshot.png
Get text + metadata as JSON instead of raw bytes:
curl "https://api.shotanvil.com/take?url=https://example.com&response_format=json" \
-H "X-Api-Key: $SHOTANVIL_API_KEY"
Render inline HTML:
curl -X POST https://api.shotanvil.com/render-html \
-H "Content-Type: application/json" \
-H "X-Api-Key: $SHOTANVIL_API_KEY" \
-d '{"html": "<html><body><h1>Hello</h1></body></html>"}' \
-o out.png
More runnable examples: examples/curl.sh,
examples/node/screenshot.mjs.
Common GET /take parameters
| Param | Type | Notes |
|---|---|---|
url | string, required | Target page URL, http/https only. |
format | string | png (default), jpeg, webp, or pdf. |
full_page | bool | Capture the full scrollable page height, not just the viewport. |
viewport_width / viewport_height | int | 320–3840 / 240–2160. |
cache_ttl | int | Seconds to cache this exact render, 0–86400. |
fresh | bool | Bypass the cache read for this request. |
block_ads | bool | Block ad-network requests via an EasyList-derived blocklist. |
block_cookie_banners | bool | Inject a CSS kill-list that hides common cookie-consent banners. |
dark_mode | bool | Emulate prefers-color-scheme: dark before navigation. |
response_format | string | binary (default) returns raw bytes; json wraps image (base64) + extracted text/metadata. |
Full parameter reference, request/response schemas, and every field's worked example live in
openapi.json — open it in any OpenAPI viewer (e.g.
editor.swagger.io) for the browsable version.
Rate limits
Each API key has a per-second rate limit and a daily call cap. GET /usage reports the current
key's usage for the day. Exceeding either returns 429 with a retry_after_s field.
Keeping openapi.json in sync
openapi.json in this repo is a point-in-time copy, fetched from the live
GET https://api.shotanvil.com/openapi.json endpoint — it is not hand-written and will drift as
the API evolves.
Before relying on it for anything beyond casual browsing, or before any future update to this repo, re-fetch and diff:
curl -sS https://api.shotanvil.com/openapi.json -o /tmp/openapi.latest.json
diff openapi.json /tmp/openapi.latest.json
If they differ, review the diff, replace openapi.json with the fresh copy, and commit — do not
hand-edit openapi.json directly.
License
Examples in this repo are MIT-licensed — copy and adapt freely. openapi.json describes the
shotanvil API and is provided for reference only.
Signals
- Last commit
- Aug 2026
Advanced
- Delivery
- shotanvil MCP server → your ahel gateway (mcp.ahel.ai) → every connected AI client.
- Catalog kind
- mcp-server
- Gateway key
com-shotanvil-api-shotanvil- Source
- github.com/psykepro/shotanvil-examples
- Hosted endpoint
https://api.shotanvil.com/mcp