{
  "markdown": "# ShotAPI — Web Screenshot & Render MCP Server for AI Agents\n\nGive your AI Agent eyes. One command, zero install.\n\n[![GitHub stars](https://img.shields.io/github/stars/smallhandsome/shotapi-mcp-server)](https://github.com/smallhandsome/shotapi-mcp-server)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/servers/io.github.smallhandsome/shotapi-mcp-server)\n\n[中文文档](README_CN.md)\n\n## Quick Start (Remote Mode — No Install)\n\n```bash\n# Claude Code\nclaude mcp add --transport streamable-http shotapi https://aiphotoshop.mynatapp.cc/mcp\n\n# Or with npx\nnpx -y @anthropic-ai/claude-code@latest --mcp https://aiphotoshop.mynatapp.cc/mcp\n```\n\nFor Claude Desktop / Cursor, add to your config:\n\n```json\n{\n  \"mcpServers\": {\n    \"shotapi\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://aiphotoshop.mynatapp.cc/mcp\"\n    }\n  }\n}\n```\n\n## Real Use Cases\n\n### 1. Claude verifies its own code\n\n```\nHuman: Build a landing page with a hero section, testimonials, and pricing grid.\n\nClaude: [writes HTML/CSS code]\n\nClaude: Let me check this with the render tool...\n\n[Claude calls ShotAPI render tool with the HTML it wrote]\n\nClaude: The pricing grid overlaps on mobile. Fixing responsive breakpoints...\n```\n\n### 2. Deployment verification\n\n```\nHuman: I just deployed. Check if it looks right.\n\nClaude: [calls ShotAPI screenshot on https://yourapp.com]\n\nClaude: Footer text is cut off — CSS overflow issue. Background image 404.\n```\n\n### 3. UI regression in CI/CD\n\n```bash\n# Capture before/after screenshots and compare\ncurl -s \"https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://staging.myapp.com\" -o before.png\ncurl -s \"https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://staging.myapp.com\" -o after.png\n```\n\n## 3 MCP Tools\n\n| Tool | Description | Example |\n|------|-------------|---------|\n| `screenshot_one_liner` | One URL, one screenshot | `screenshot_one_liner(url=\"https://github.com\")` |\n| `screenshot` | Full control: viewport, full-page, CSS selector, format | `screenshot(url=\"https://github.com\", selector=\"#hero\")` |\n| `render` | Render HTML/CSS to image — Agent writes code, sees result instantly | `render(html=\"<h1>Hello</h1>\")` |\n\nThe `render` tool closes the feedback loop: **write code → render → see → revise → render again**.\n\n## Why ShotAPI?\n\n- **MCP-native** — No glue code. Agent calls tools directly in conversation.\n- **Zero install remote mode** — streamable-http, no Python/Playwright needed.\n- **Direct China access** — No VPN required.\n- **Free tier** — 50 screenshots + 50 renders/month, IP-based, no signup, no API key. All features unlocked (full-page, selector, WebP).\n- **Render capability** — Not just screenshots of existing pages. Render Agent-generated HTML.\n- **Built-in ad blocking** — Cleaner screenshots, less noise.\n- **Listed in MCP Registry** — Official Anthropic MCP server directory.\n\n## Try It Now (No Signup)\n\n```bash\ncurl -s \"https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://github.com\" -o shot.jpg\n```\n\n## Pricing\n\n| Plan | Price | Limit |\n|------|-------|-------|\n| Free | $0 | 50+50/month (IP-based, all features, no signup) |\n| Starter | $4.90/mo | 5,000/month |\n| Pro | $9.90/mo | 20,000/month |\n\nFree tier: no API key needed. Paid: get key at [pricing page](https://aiphotoshop.mynatapp.cc/pricing).\n\n## Local Mode (STDIO)\n\nFor private deployments or paid-tier usage, run locally:\n\n```bash\n# Install dependencies\npip install -r requirements.txt\nplaywright install chromium\n\n# Set env vars\nexport SHOTAPI_BASE_URL=https://aiphotoshop.mynatapp.cc\nexport SHOTAPI_KEY=your_key_here  # optional for paid tiers\n\n# Add to Claude Code\nclaude mcp add shotapi python mcp_stdio.py\n```\n\n## Links\n\n- **Docs**: https://aiphotoshop.mynatapp.cc/docs\n- **Pricing**: https://aiphotoshop.mynatapp.cc/pricing\n- **Health**: https://aiphotoshop.mynatapp.cc/health\n- **MCP Registry**: https://registry.modelcontextprotocol.io/servers/io.github.smallhandsome/shotapi-mcp-server\n- **Smithery**: https://smithery.ai/server/@ljs/shotapi\n- **awesome-mcp-servers**: https://github.com/punkpeye/awesome-mcp-servers\n- **Dev.to Article**: https://dev.to/smallhandsome/give-your-ai-agent-eyes-building-a-visual-mcp-server-for-web-screenshots-3f49",
  "bytes": 4239,
  "sha": "d5d24fb19cf874bbf80ff6a18cc4eed8d330a00c4ce6a6059fb388fc90d6bfe6",
  "repo_slug": "smallhandsome/shotapi-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_smallhandsome_shotapi_mcp_serv_e0b8d742/readme"
}