ShotAPI MCP Server

io.github.smallhandsomePublished by GitHub account smallhandsomev1.0.1Updated Oct 24, 2026

Screenshot and HTML render MCP server for AI agents

VerifiedStreamable HTTPWeb executableBrowser AutomationDeveloper Tools

Overview

AI-generated overview

Remote MCP server that lets an assistant take web page screenshots and render HTML/CSS into images to visually check its own output.

What you can do
  • Capture a screenshot of a single URL with a one-call tool
  • Take configurable screenshots with viewport, full-page, CSS selector and format options
  • Render assistant-written HTML/CSS into an image so the result can be inspected and revised
  • Use the same service over HTTP for before/after captures in deployment or CI checks
When to use it
Useful when an assistant writes HTML/CSS or front-end code and needs to see the rendered result, or when you want a quick visual check of a deployed page without installing a browser stack locally.
Requirements
Remote streamable-http endpoint; no local install or Playwright needed. The manifest declares OAuth as required, while the README describes an IP-based free tier with no signup or API key. Local STDIO mode needs Python, Playwright Chromium, and optionally the SHOTAPI_BASE_URL and SHOTAPI_KEY environment variables.
Before you install
Screenshots and rendered HTML are sent to a third-party service, so avoid pages or markup containing secrets or private data. Paid tiers require an API key (SHOTAPI_KEY) and a subscription. The free tier is IP-based and rate-limited, and the README's no-auth claim conflicts with the manifest's OAuth requirement.

Installation

In SourceWeft

  1. Open ShotAPI MCP Server in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.smallhandsome%2Fshotapi-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "shotapi": {
      "type": "http",
      "url": "https://aiphotoshop.mynatapp.cc/mcp"
    }
  }
}

README

ShotAPI — Web Screenshot & Render MCP Server for AI Agents

Give your AI Agent eyes. One command, zero install.

[GitHub stars] [MCP Registry]

中文文档

Quick Start (Remote Mode — No Install)

bash
# Claude Codeclaude mcp add --transport streamable-http shotapi https://aiphotoshop.mynatapp.cc/mcp
# Or with npxnpx -y @anthropic-ai/claude-code@latest --mcp https://aiphotoshop.mynatapp.cc/mcp

For Claude Desktop / Cursor, add to your config:

json
{  "mcpServers": {    "shotapi": {      "type": "streamable-http",      "url": "https://aiphotoshop.mynatapp.cc/mcp"    }  }}

Real Use Cases

1. Claude verifies its own code

Human: Build a landing page with a hero section, testimonials, and pricing grid.
Claude: [writes HTML/CSS code]
Claude: Let me check this with the render tool...
[Claude calls ShotAPI render tool with the HTML it wrote]
Claude: The pricing grid overlaps on mobile. Fixing responsive breakpoints...

2. Deployment verification

Human: I just deployed. Check if it looks right.
Claude: [calls ShotAPI screenshot on https://yourapp.com]
Claude: Footer text is cut off — CSS overflow issue. Background image 404.

3. UI regression in CI/CD

bash
# Capture before/after screenshots and comparecurl -s "https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://staging.myapp.com" -o before.pngcurl -s "https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://staging.myapp.com" -o after.png

3 MCP Tools

ToolDescriptionExample
screenshot_one_linerOne URL, one screenshotscreenshot_one_liner(url="https://github.com")
screenshotFull control: viewport, full-page, CSS selector, formatscreenshot(url="https://github.com", selector="#hero")
renderRender HTML/CSS to image — Agent writes code, sees result instantlyrender(html="<h1>Hello</h1>")

The render tool closes the feedback loop: write code → render → see → revise → render again.

Why ShotAPI?

  • MCP-native — No glue code. Agent calls tools directly in conversation.
  • Zero install remote mode — streamable-http, no Python/Playwright needed.
  • Direct China access — No VPN required.
  • Free tier — 50 screenshots + 50 renders/month, IP-based, no signup, no API key. All features unlocked (full-page, selector, WebP).
  • Render capability — Not just screenshots of existing pages. Render Agent-generated HTML.
  • Built-in ad blocking — Cleaner screenshots, less noise.
  • Listed in MCP Registry — Official Anthropic MCP server directory.

Try It Now (No Signup)

bash
curl -s "https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://github.com" -o shot.jpg

Pricing

PlanPriceLimit
Free$050+50/month (IP-based, all features, no signup)
Starter$4.90/mo5,000/month
Pro$9.90/mo20,000/month

Free tier: no API key needed. Paid: get key at pricing page.

Local Mode (STDIO)

For private deployments or paid-tier usage, run locally:

bash
# Install dependenciespip install -r requirements.txtplaywright install chromium
# Set env varsexport SHOTAPI_BASE_URL=https://aiphotoshop.mynatapp.ccexport SHOTAPI_KEY=your_key_here  # optional for paid tiers
# Add to Claude Codeclaude mcp add shotapi python mcp_stdio.py

Links

Source: README.md at commit 09b175a

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts