ScreenshotAPI

ScreenshotAPI MCP Server

Official MCP server for ScreenshotAPI. It gives your AI assistant 8 tools for website screenshots, URL and HTML to PDF, scrolling videos, JavaScript-aware web scraping (Markdown, text, HTML), and bulk captures. You ask in plain English and the server makes the API calls. Your assistant also gets the screenshot back as an image, so it can see the page it captured.

Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Cline, Codex, and any other MCP-compatible client.

Quick Start

1. Sign up for ScreenshotAPI and copy your API key from the dashboard.

1. Cursor users can install in one click:

1. Everyone else: add this to your MCP client config (see Install by Client for the exact file path):

{

"mcpServers": { "screenshotapi": { "command": "npx", "args": ["-y", "@screenshotapinet/mcp"], "env": { "SCREENSHOTAPI_TOKEN": " " } } } }

1. Restart your client.

1. Test it: ask "Take a screenshot of https://example.com"

Table of Contents

• Quick Start
• Install by Client
• Verify It Works
• Tool Reference
• Prompt Examples
• Error Codes
• How It Works
• Environment Variables
• Building from Source
• Troubleshooting
• Links
• License

Install by Client

Requirements

• Node.js 18 or later
• npx available in your terminal
• A ScreenshotAPI API key (sign up)

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{

"mcpServers": { "screenshotapi": { "command": "npx", "args": ["-y", "@screenshotapinet/mcp"], "env": { "SCREENSHOTAPI_TOKEN": " " } } } }

Restart Claude Desktop after saving.

Claude Code

claude mcp add screenshotapi --env SCREENSHOTAPI_TOKEN=<YOUR_API_KEY> -- npx -y @screenshotapinet/mcp

Start a new Claude Code session after adding the server.

Cursor

One-click install:

Or add to .cursor/mcp.json manually:

{

"mcpServers": { "screenshotapi": { "command": "npx", "args": ["-y", "@screenshotapinet/mcp"], "env": { "SCREENSHOTAPI_TOKEN": " " } } } }

Restart Cursor after saving.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "screenshotapi": { "command": "npx", "args": ["-y", "@screenshotapinet/mcp"], "env": { "SCREENSHOTAPI_TOKEN": " " } } } }

Restart Windsurf after saving.

VS Code / GitHub Copilot

Add to your VS Code settings.json:

{

"mcp": { "servers": { "screenshotapi": { "command": "npx", "args": ["-y", "@screenshotapinet/mcp"], "env": { "SCREENSHOTAPI_TOKEN": " " } } } } }

Restart VS Code after saving.

Cline

Open MCP Servers panel → Configure → Advanced MCP Settings. Add to cline_mcp_settings.json:

{

"mcpServers": { "screenshotapi": { "command": "npx", "args": ["-y", "@screenshotapinet/mcp"], "env": { "SCREENSHOTAPI_TOKEN": " " } } } }

Restart Cline after saving.

Codex CLI

codex mcp add screenshotapi --env SCREENSHOTAPI_TOKEN=<YOUR_API_KEY> -- npx -y @screenshotapinet/mcp

codex mcp list

Start a new Codex session after adding the server.

Any Other MCP Client

Use this config:

{

"command": "npx", "args": ["-y", "@screenshotapinet/mcp"], "env": { "SCREENSHOTAPI_TOKEN": " " } }

Verify It Works

Try these after setup:

Tool Reference

All 8 tools wrap the ScreenshotAPI REST API. The render tools (take_screenshot, generate_pdf, scrape_page, record_scrolling_video) call GET https://shot.screenshotapi.net/v3/screenshot with output=json and share the page preparation options below. Each takes either url or custom_html.

Shared render options

take_screenshot

Captures a page as an image and returns the hosted image URL. The image is also returned inline so the assistant can see it. Full-page captures are the exception, since they are usually too tall to view; pass include_image=true to get them inline anyway.

Plus all shared render options.

generate_pdf

Converts a URL or raw HTML to PDF and returns the hosted PDF URL. With no format (and no width/height), the whole page becomes one continuous PDF page.

Plus all shared render options.

scrape_page

Renders the page in a real browser, so JavaScript runs first, then extracts its content. The server downloads the extracted files and return