Skip to main content
Glama
Rumblingb

screenshot-mcp

by Rumblingb

Screenshot MCP Server

A Model Context Protocol (MCP) server that captures webpage screenshots using the ScreenshotOne API.

Free tier: 100 screenshots/month (no credit card required)
Paid: $19/month for 2,000 screenshots — Subscribe here

Tools

Tool

Description

screenshot_url(url, width?, height?)

Screenshot a webpage at desktop viewport (default 1280×720). Returns a base64 PNG.

screenshot_url_mobile(url)

Screenshot a webpage at mobile viewport (390×844, iPhone 13 Pro). Returns a base64 PNG.

screenshot_element(url, selector)

Screenshot a specific element on the page by CSS selector. Returns a base64 PNG.

Related MCP server: Webshot MCP

Quick Start

1. Get an API Key

Sign up at screenshotone.com — free tier gives you 100 screenshots/month.

2. Set the environment variable

export SCREENSHOTONE_API_KEY=your_key_here

3. Run with uv

uv run server.py

Or install dependencies and run directly:

pip install -r requirements.txt
python server.py

Usage with Claude Desktop / MCP Client

Add to your MCP client configuration:

{
  "mcpServers": {
    "screenshot": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/screenshot-mcp", "server.py"],
      "env": {
        "SCREENSHOTONE_API_KEY": "your_key_here"
      }
    }
  }
}

Testing with cURL

If you don't have the MCP client set up, you can test the API directly:

curl -o screenshot.png \
  "https://api.screenshotone.com/take?url=https://example.com&access_key=YOUR_API_KEY&viewport_width=1280&viewport_height=720"

Deployment

Smithery

This server is configured for Smithery deployment. See smithery.yaml for details.

Docker

FROM python:3.12-slim
WORKDIR /app
COPY . .
RUN pip install -r requirements.txt
ENV SCREENSHOTONE_API_KEY=""
CMD ["python", "server.py"]

Environment Variables

Variable

Required

Description

SCREENSHOTONE_API_KEY

Yes

Your ScreenshotOne API key

Pricing

Plan

Screenshots

Price

Link

Free

100/month

$0

screenshotone.com

Pro

2,000/month

$19/mo

Subscribe

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    Enables taking screenshots of web pages with support for multiple devices (desktop, mobile, tablet), custom dimensions, full-page capture, and various image formats. Built with Playwright for reliable web page rendering and screenshot generation.
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides tools to capture pixel-perfect website screenshots as images or PDF. Supports configurable viewport, full-page capture, CSS injection, and returns either viewable images or base64-encoded content.
    MIT