English Français العربية

Shotpipe — Screenshots & OG Images

Official registry Media and design

Screenshot any URL and see it, or mint a social card — hosted, SSRF-safe, cached. No Chrome to run.

Source code Website 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 shotpipe-mcp
Claude Code 
claude mcp add shotpipe-screenshots-og-images -e 'SHOTPIPE_KEY=<SHOTPIPE_KEY>' -e 'SHOTPIPE_SECRET=<your shotpipe_secret>' -e 'SHOTPIPE_BASE_URL=<SHOTPIPE_BASE_URL>' -- npx -y shotpipe-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "shotpipe-screenshots-og-images": {
            "command": "npx",
            "args": [
                "-y",
                "shotpipe-mcp@0.1.1"
            ],
            "env": {
                "SHOTPIPE_KEY": "<SHOTPIPE_KEY>",
                "SHOTPIPE_SECRET": "<your shotpipe_secret>",
                "SHOTPIPE_BASE_URL": "<SHOTPIPE_BASE_URL>"
            }
        }
    }
}

Environment variables

  • SHOTPIPE_KEY required Shotpipe API key id (starts with k_). Free at https://shotpipe.io/signup.
  • SHOTPIPE_SECRET required secret Shotpipe HMAC signing secret. Requests are signed locally; the secret never leaves the process.
  • SHOTPIPE_BASE_URL Override the API base URL for a self-hosted Shotpipe instance. Defaults to https://shotpipe.io.

Documentation

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

Contents
  1. shotpipe-mcp
  2. Install
  3. Tools
  4. How it works

shotpipe-mcp

Hosted, SSRF-safe, cached screenshots and Open Graph images for AI agents — no headless Chrome to run.

An MCP server that lets an agent screenshot any URL and see the result, or mint a social-card image, by calling Shotpipe. It's the thing a local browser tool can't be:

  • No Chrome in your agent's sandbox. Rendering happens on Shotpipe's infrastructure. Nothing to install, no memory to babysit, no OOM at 2am.
  • Safe on untrusted URLs. Agents point at URLs their users typed. Shotpipe resolves DNS itself, pins the IP, re-checks every redirect, and refuses private / loopback / cloud-metadata hosts — so a hostile link can't turn your renderer into an SSRF hole.
  • Cached. The first capture renders; every identical one after is served from the edge in milliseconds and costs nothing.

Ad and cookie-consent banners are stripped by default.

Install

// Claude Desktop (claude_desktop_config.json), Claude Code (.mcp.json),
// Cursor, Cline, or any MCP client:
{
  "mcpServers": {
    "shotpipe": {
      "command": "npx",
      "args": ["-y", "shotpipe-mcp"],
      "env": {
        "SHOTPIPE_KEY": "k_your_key",
        "SHOTPIPE_SECRET": "your_signing_secret"
      }
    }
  }
}

Get a free key at shotpipe.io/signup (no card) or run npx shotpipe-init. Self-hosting Shotpipe? Set SHOTPIPE_BASE_URL.

Tools

screenshot

Screenshot a URL and return the image (so the model can see it) plus a permanent, shareable signed URL.

url (required) · format png\|jpeg\|pdf · width · height · dpr · full_page · selector · dark · omit_background · block_ads · block_banners · wait_for · delay · quality · fresh

og_image

Build a signed social-card URL from a hosted template. Returns the URL only by default and renders nothing — the image renders lazily on the first crawler hit, so agent/build time stays fast. Drop it into <meta property="og:image">. Pass render: true to also get a preview image.

title (required) · template · author · tag · accent · logo · width · height · dpr · render

How it works

The signing secret never leaves the process — every request is HMAC-signed locally, exactly like Shotpipe's other clients. The server just builds a signed URL and (for screenshot) fetches the bytes.

MIT · shotpipe.io

Frequently asked questions

What is Shotpipe — Screenshots & OG Images?

Screenshot any URL and see it, or mint a social card — hosted, SSRF-safe, cached. No Chrome to run.

How do I install Shotpipe — Screenshots & OG Images?

It runs on your machine. In Claude Code: claude mcp add shotpipe-screenshots-og-images -e 'SHOTPIPE_KEY=<SHOTPIPE_KEY>' -e 'SHOTPIPE_SECRET=<your shotpipe_secret>' -e 'SHOTPIPE_BASE_URL=<SHOTPIPE_BASE_URL>' -- npx -y shotpipe-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Shotpipe — Screenshots & OG Images need an API key?

Yes. It expects SHOTPIPE_KEY, SHOTPIPE_SECRET, which you set in its configuration.

Is Shotpipe — Screenshots & OG Images open source?

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

Who maintains Shotpipe — Screenshots & OG Images?

It is published by podop29. 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.