How do I install Shotanvil?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Shotanvil need an API key?

No required environment variable is listed on this record.

What transport does Shotanvil use?

Shotanvil is reached over HTTP.

When was Shotanvil last checked?

Last checked 2026-11-08. Screenshot/PDF/HTML rendering API. API key or x402 required — keyless access disabled.

Shotanvil MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.shotanvil.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.shotanvil.api-shotanvil https://api.shotanvil.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.shotanvil.api-shotanvil": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.shotanvil.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

shotanvil-examples

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-Payment header (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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Shotanvil?

Does Shotanvil need an API key?

What transport does Shotanvil use?

When was Shotanvil last checked?

Documentation

shotanvil-examples

Access paths

Quickstart

Common GET /take parameters

Rate limits

Keeping openapi.json in sync

License

Common `GET /take` parameters

Keeping `openapi.json` in sync