developer-toolsapi_key

Screenshot API

Screenshot API renders webpages and custom HTML as images, PDFs, videos, or extracted content and supports paid asynchronous bulk capture jobs.

Verdict

Screenshot API lets your team capture webpage screenshots, PDFs, and videos programmatically from inside Switchy Projects. @mention it to render a single URL or kick off bulk jobs that process hundreds of pages at once. Designers grab visual snapshots for mockups, QA engineers document bugs across browsers, and marketers audit landing pages at scale. The MCP handles both synchronous renders (get a URL back immediately) and asynchronous CSV/JSON batch jobs (poll for status, download results when done). You'll need an API key from Screenshot API's dashboard and enough credits for paid operations — bulk jobs and certain render options consume balance.

Common use cases

  • Capture competitor landing pages weekly
  • Generate PDF invoices from HTML templates
  • Document UI bugs with timestamped screenshots
  • Audit email renders across clients
  • Archive blog posts as static images

Integration

Vendor
Screenshot API
Category
developer-tools
Auth
API_KEY
Tools
5
Composio slug
screenshot_api

Tools

  • 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.

  • 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.

  • Download Bulk Results

    Download the processed result CSV for a completed paid bulk screenshot job UUID.

  • Get Bulk Job Status

    Get progress and success/failure counts for a paid asynchronous bulk screenshot job UUID.

  • 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.

Setup

Setup guide

  1. 11. Sign up at Screenshot API and generate an API key from your account dashboard. 2. In Switchy, open Settings → Integrations → Developer Tools and click 'Connect' next to Screenshot API. 3. Paste your API key into the prompt and click 'Authorize'. 4. Switchy confirms the connection and shows Screenshot API as available in your workspace. 5. Open any Project, type '@Screenshot API render a screenshot of https://example.com' and send the message. 6. The MCP returns a stored image URL — click it to verify the screenshot loaded correctly. 7. For bulk jobs, upload a CSV or send JSON with up to 50 URLs, then poll job status by UUID until complete. 8. Download the result CSV using the job UUID to retrieve all rendered URLs and metadata.

What teammates see: by default, memories from Screenshot API are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Render Landing Page

@Screenshot API render a full-page screenshot of https://www.example.com/landing and return the image URL.

Batch Competitor Audit

@Screenshot API create a bulk JSON job for these URLs: https://competitor1.com, https://competitor2.com, https://competitor3.com. Return the job UUID.

Check Bulk Job Progress

@Screenshot API get the status for bulk job UUID abc-123-def and tell me how many renders completed successfully.

Generate PDF Report

@Screenshot API render https://internal-dashboard.example.com/report as a PDF and return the download link.

Download Finished Results

@Screenshot API download the result CSV for bulk job UUID xyz-789-ghi and share the file link.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@screenshot-api render a full-page screenshot of our staging homepage at https://staging.acme.com and return the image URL

Output

Screenshot rendered successfully. The full-page capture is stored at https://api.screenshotapi.net/results/abc123def456.png (1920x4800px). The page loaded in 2.3 seconds with all assets fetched. No custom filename was specified, so the system generated a unique identifier. The image will remain accessible at this URL according to your account's retention policy.

Notes

This example shows the core single-screenshot workflow. The MCP returns a stored URL, not inline image data, so your AI can reference it but won't display it directly in chat. Rendering costs one API credit per request. If you need the same URL repeatedly, pass a custom filename to overwrite the stored file instead of generating new ones.

Prompt

@screenshot-api start a bulk job to capture screenshots of the 30 competitor URLs in our market-research CSV file and give me the job UUID

Output

Bulk screenshot job created successfully. Job UUID: 7f8e9a1b-2c3d-4e5f-6a7b-8c9d0e1f2a3b. The CSV containing 30 URLs has been uploaded and queued for processing. Each URL will be rendered with your account's default viewport and format settings. Use the job UUID to poll status or download results once complete. Estimated processing time: 5-8 minutes depending on page complexity and current queue depth.

Notes

This demonstrates the asynchronous bulk workflow for high-volume screenshot jobs. The MCP uploads your CSV and returns a tracking UUID immediately, but screenshots process in the background. You'll need to poll job status separately or wait for completion before downloading the result CSV. Bulk jobs are billed per URL rendered, so verify your credit balance before large runs.

Prompt

@screenshot-api check the status of bulk job 7f8e9a1b-2c3d-4e5f-6a7b-8c9d0e1f2a3b and if it's done, summarize which URLs failed and why

Output

Job 7f8e9a1b-2c3d-4e5f-6a7b-8c9d0e1f2a3b is complete. Status: 27 succeeded, 3 failed. Failed URLs: (1) https://competitor-x.io timed out after 30 seconds, (2) https://beta.rival-y.com returned 403 Forbidden, (3) https://old.vendor-z.net has an invalid SSL certificate. The 27 successful screenshots are available in the result CSV, which can now be downloaded. All failures consumed API credits despite not producing images.

Notes

This pairs the status-check tool with AI reasoning to surface actionable insights from bulk job results. The MCP provides raw success/failure counts; the AI interprets them into a human-readable summary. Note that failed renders still cost credits, so pre-validate URLs when possible. The result CSV contains image URLs for successful renders only.

Use-case deep-dives

QA visual regression testing

When Screenshot API beats manual QA for UI changes

A 6-person dev team ships feature branches twice a week and needs to catch layout breaks before merge. Screenshot API's Render Screenshot tool lets you snapshot staging URLs at different viewports and compare them to prod baselines in your CI pipeline. The custom filename feature means you can overwrite the same reference file each run without cluttering storage. This works well if you're checking under 20 pages per deploy—beyond that, the per-screenshot cost adds up and a dedicated visual testing service with diff algorithms becomes cheaper. If your team already runs Playwright or Cypress, you probably don't need this MCP. But if you're pre-automation and doing manual spot-checks in browsers, Screenshot API gives you programmatic snapshots without writing test infrastructure.

Client reporting screenshot capture

Bulk CSV jobs for agency deliverable screenshots

A 3-person agency delivers monthly SEO reports to 40 clients and needs fresh homepage screenshots for each deck. The Create Bulk CSV Job tool lets you upload a spreadsheet of client URLs Friday afternoon and pull the results Monday morning via Download Bulk Results. The async job model means you're not blocking on API calls or managing retry logic for slow-loading sites. This is the right call if you're screenshotting more than 10 URLs at once—single Render Screenshot calls work fine for one-offs, but anything over that threshold benefits from the bulk queue. The trade-off is you lose real-time feedback, so if you need to adjust parameters mid-run or handle auth-walled pages interactively, you'll want the synchronous render tool instead.

Support ticket visual documentation

Rendering user-reported bugs as stored images

A 5-person support team triages bug reports in Linear and needs to archive what the user saw at the time of the ticket. Screenshot API's Render Screenshot tool takes the reported URL and stores a timestamped image you can link directly in the ticket thread. The extracted content links option also pulls text or metadata if you need to search across archived states later. This MCP makes sense if you're handling 15-plus visual bug reports per week and your team doesn't already use a session replay tool like LogRocket. If users are submitting their own screenshots, you don't need this. But if you're chasing down intermittent UI states or third-party embed failures, programmatic capture beats asking users to screenshot again. The API key auth means any team member can trigger renders without sharing credentials.

Frequently asked

What does the Screenshot API MCP do in Switchy?

It lets AI agents capture screenshots, PDFs, or videos of any webpage or custom HTML. Agents can render single pages on demand or submit bulk jobs with up to 50 URLs at once. Results are stored URLs you can reference in workflows, reports, or send to other tools. Useful for monitoring competitor sites, archiving marketing pages, or generating visual proofs.

Do I need a Screenshot API account to use this MCP?

Yes. You need an active Screenshot API account and an API key. Paste the key into Switchy's connection form. Bulk jobs are paid operations billed by Screenshot API based on your plan. Single renders may be free or paid depending on your tier. Check Screenshot API's pricing before running large batches.

Can it capture screenshots of pages behind a login?

No. The MCP renders public URLs or raw HTML you provide. It can't log into password-protected sites or handle multi-step authentication flows. If you need authenticated screenshots, export the HTML after login or use a browser automation tool instead. This MCP is for public pages and custom HTML strings.

How does this compare to using Screenshot API's dashboard directly?

The MCP lets AI agents trigger renders mid-conversation without you switching tabs or uploading CSVs manually. Agents can check job status, download results, and chain screenshots into other workflows. Use the dashboard for one-off captures or reviewing billing. Use the MCP when screenshots are part of a repeatable AI task.

Who on the team should connect this MCP?

Whoever owns the Screenshot API account and budget. Bulk jobs cost money, so you don't want every team member accidentally burning credits. Connect it once in a shared Switchy workspace. Set clear guidelines on when agents should use bulk vs single renders to avoid surprise bills.

More developer tools MCPs

See all developer tools MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.