English Français العربية

io.github.nihey/screenshotty

Official registry Search and web

Capture web pages as screenshots (returned inline) or PDFs via the Screenshotty API.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package screenshotty-mcp
Claude Code 
claude mcp add screenshotty -e 'SCREENSHOTTY_API_KEY=<your screenshotty_api_key>' -- npx -y screenshotty-mcp@1.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "screenshotty": {
            "command": "npx",
            "args": [
                "-y",
                "screenshotty-mcp@1.1.0"
            ],
            "env": {
                "SCREENSHOTTY_API_KEY": "<your screenshotty_api_key>"
            }
        }
    }
}

Environment variables

  • SCREENSHOTTY_API_KEY required secret Screenshotty API key from https://screenshotty.link/dashboard/api-keys

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. screenshotty-mcp
  2. Get an API key
  3. Configure your client
  4. Tools
  5. Environment variables
  6. Development
  7. License

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.

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

ToolWhat it does
screenshot_urlScreenshot 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_htmlRender 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_pdfRender 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

VariableRequiredDefault
SCREENSHOTTY_API_KEYyes—
SCREENSHOTTY_API_URLnohttps://api.screenshotty.link

Development

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

License

MIT

Frequently asked questions

What is io.github.nihey/screenshotty?

Capture web pages as screenshots (returned inline) or PDFs via the Screenshotty API.

How do I install io.github.nihey/screenshotty?

It runs on your machine. In Claude Code: claude mcp add screenshotty -e 'SCREENSHOTTY_API_KEY=<your screenshotty_api_key>' -- npx -y screenshotty-mcp@1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.nihey/screenshotty need an API key?

Yes. It expects SCREENSHOTTY_API_KEY, which you set in its configuration.

Is io.github.nihey/screenshotty open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.nihey/screenshotty?

It is published by nihey. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.