# Screenshot API — how to use (mcp.ai)

Connect your Screenshot API account and use 5 tools for images and design straight from your AI agent. Connect with your own API key. Screenshot API renders webpages and custom HTML as images, PDFs, videos, or extracted content and supports paid asynchronous bulk capture jobs.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_screenshot_api?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `screenshot_api_create_bulk_csv_job`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/screenshot_api`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/screenshot_api/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/screenshot_api/create/bulk/csv/job` — Upload a CSV file to start a paid asynchronous bulk screenshot job and return the provider's complete job acceptance payload containing its UUID.
  - body: { csv_file: object }
- `POST https://api.mcp.ai/api/screenshot_api/create/bulk/json/job` — Start a paid asynchronous bulk screenshot job from up to 50 JSON request items and return the provider's complete job acceptance payload containing its UUID.
  - body: { urls: object[] }
- `POST https://api.mcp.ai/api/screenshot_api/download/bulk/results` — Download the processed result CSV for a completed paid bulk screenshot job UUID.
  - body: { job_uuid: string }
- `POST https://api.mcp.ai/api/screenshot_api/get/bulk/job/status` — Get progress and success/failure counts for a paid asynchronous bulk screenshot job UUID.
  - body: { job_uuid: string }
- `POST https://api.mcp.ai/api/screenshot_api/render/screenshot` — Render a webpage or custom HTML and return a stored image, PDF, or video URL plus optional extracted content links. A custom result filename can replace an existing stored file with the same name.
  - body: { url: string, cache?: object, storage?: object, blocking?: object, viewport?: object, file_type?: string, page_load?: object, scrolling?: object, appearance?: object, extraction?: object, custom_html?: string, pdf_options?: object, browser_context?: object }

## Example prompts
- "What can I do in Screenshot API?"
- "Show me a summary of my Screenshot API account"

## More
- Page: https://mcp.ai/screenshot_api
- Agent spec (llms.txt): https://mcp.ai/screenshot_api/llms.txt
- Postman collection: https://mcp.ai/screenshot_api/postman.json