ShotAPI

What ShotAPI MCP server does

The ShotAPI MCP server exposes browser-based screenshot and rendering functions to MCP-compatible AI clients. An agent can capture a webpage from a URL, request a more controlled screenshot, or submit HTML and CSS for image rendering. This supports visual checks after an agent writes interface code, deployment reviews, and basic screenshot-based regression workflows.

The service can capture an existing page or render content supplied directly by the agent. Screenshots can use a specified viewport, capture the full page, target a CSS selector, and choose an output format. The service also includes ad blocking, which can reduce unrelated page content in captures.

How it works

In remote mode, an MCP client connects to the streamable-HTTP endpoint at https://aiphotoshop.mynatapp.cc/mcp. The client then exposes ShotAPI's functions in the agent conversation. Claude Code can be configured with its MCP command, while Claude Desktop and Cursor can use an MCP server entry with the endpoint URL.

The three available tools serve different purposes:

• screenshot_one_liner captures one URL with a minimal call.
• screenshot provides controls for viewport size, full-page capture, CSS selectors, and image format.
• render converts agent-supplied HTML and CSS into an image.

The render workflow is useful when an agent needs to write markup, inspect the resulting visual output, make a correction, and render it again. The HTTP service also exposes screenshot requests through a versioned endpoint, which can be called directly with curl for non-MCP workflows.

Setup and configuration

Remote use requires no Python, Playwright installation, API key, or signup on the documented free tier. Add the streamable-HTTP URL to the MCP client's configuration, or pass it to Claude Code with the MCP command shown in the project documentation.

For local stdio mode, install the Python dependencies from requirements.txt, install Chromium through Playwright, and run mcp_stdio.py. Set SHOTAPI_BASE_URL to the ShotAPI service URL.

The documented free tier allows 50 screenshots and 50 renders per month, uses IP-based limits, and does not require an API key. Paid plans increase the monthly limits and provide a key through the pricing page.

Tools and capabilities

The ShotAPI MCP server is suited to agents that need visual feedback rather than only textual or DOM-level inspection. It can:

• Capture a single webpage from a URL.
• Capture a full page or a selected CSS element.
• Adjust viewport settings and output format.
• Render HTML/CSS written by an agent.
• Support remote streamable HTTP or local stdio operation.
• Provide direct HTTP screenshot access for scripts and CI workflows.

Limitations and notes

Usage is limited by the selected plan. The free service uses IP-based quotas of 50 screenshots and 50 renders per month, while the listed paid plans provide 5,000 or 20,000 monthly requests. Local mode still requires the Python dependencies and a Chromium installation.