Skip to main content
Glama

screenshotty-mcp

Model Context Protocol server for the Screenshotty screenshot API. Lets Claude, Cursor, Cline, and any other MCP client capture web pages — or render HTML — as images or PDFs, and see the result, since images come back inline.

Get an API key

Sign up at https://screenshotty.link/sign-up?utm_source=mcp (250 screenshots/month free, no credit card) and copy a key from Dashboard → API Keys.

Related MCP server: Screenshot API

Configure your client

Claude Code

claude mcp add screenshotty --env SCREENSHOTTY_API_KEY=your_key -- npx -y screenshotty-mcp

Claude Desktop / Cursor / Cline

{
  "mcpServers": {
    "screenshotty": {
      "command": "npx",
      "args": ["-y", "screenshotty-mcp"],
      "env": {
        "SCREENSHOTTY_API_KEY": "your_key"
      }
    }
  }
}

Claude Desktop config lives at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Tools

Tool

What it does

screenshot_url

Screenshot a page (PNG, JPEG, WebP). Returns the hosted URL, plus the image inline when it is 2 MB or smaller. Options: viewport, full page, CSS selector, wait, ad blocking, cookie-banner blocking, light/dark mode, device scale factor.

screenshot_html

Render an HTML document (inline CSS/JS; public http(s) assets only) to PNG, JPEG, or WebP — social cards, charts, email previews. Returns the URL plus the image inline.

generate_pdf

Render a page (url) or an HTML document (html) to PDF. Returns the hosted PDF URL.

Example prompts: "Screenshot https://example.com on a 390px-wide viewport and tell me what's broken on mobile", "Save our pricing page as a PDF", "Design a 1200×630 Open Graph card for this blog post and render it".

Environment variables

Variable

Required

Default

SCREENSHOTTY_API_KEY

yes

—

SCREENSHOTTY_API_URL

no

https://api.screenshotty.link

Development

npm install
npm run build
SCREENSHOTTY_API_KEY=your_key npx @modelcontextprotocol/inspector node dist/index.js

License

MIT

Available Tools

3 tools
generate_pdfConvert a web page or HTML to PDFA

Render a web page (url) or an HTML document (html) to a PDF. Returns the hosted PDF URL.

Inputs: url, html, adblock, printed, +5 more.

screenshot_htmlRender HTML to an imageA

Render an HTML document (inline CSS/JS allowed, public http(s) assets only) to an image — e.g. social cards, charts, email previews. Returns the hosted image URL and the image itself when it is 2 MB or smaller.

Inputs: html (required), format, adblock, wait_ms, +8 more.

screenshot_urlScreenshot a web pageB

Capture a screenshot of a web page. Returns the hosted image URL and, for images up to 2 MB, the image itself so you can see the page.

Inputs: url (required), format, adblock, wait_ms, +7 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct output type and input: screenshot_url captures web pages as images, screenshot_html renders HTML to images, and generate_pdf produces PDFs from either URL or HTML. The names unambiguously indicate the result format, so an agent can easily select the right tool.

    Naming Consistency5/5

    All three tools use a consistent snake_case verb_noun pattern. The slight variation between 'screenshot' and 'generate' verbs is natural and does not break the predictable structure.

    Tool Count5/5

    Three tools cover the core purpose without redundancy: two input types for images and one combined tool for PDF output. This minimal set is well-scoped and each tool earns its place.

    Completeness5/5

    The surface covers all key combinations: URL to image, HTML to image, and URL/HTML to PDF. No obvious operations are missing for a screenshot and PDF generation service.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to capture screenshots, run visual diffs, accessibility audits, and batch sweep plans for web pages via MCP tools.
      25 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to capture any public URL as PNG, JPEG, or PDF via REST API or MCP tools, including screenshot capture, page description, and PDF rendering.
      18 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients to render any URL or raw HTML into PDF files or PNG/JPEG/WebP screenshots over MCP stdio or Streamable HTTP. Output stays in memory with SSRF protection, bounded concurrency, and configurable size and timeout limits.
      4 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables agents to open websites, capture full-page screenshots in the background using a Chromium-based browser, and read saved screenshots back as images.
      5
      1
      MIT