# CurlShot

> CurlShot is a freemium MCP server for web search and scraping. Take screenshots of public web pages as images, PDF or scrolling video from an agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** API, Web
- **Website:** https://curlshot.com/docs/guides/ai-agents
- **Repository:** https://github.com/sergiupogor/curlshot-mcp
- **MCP Registry name:** io.github.SergiuPogor/curlshot
- **Categories:** web search and scraping, developer tools
- **Listing updated:** 2026-11-15

## About

CurlShot's MCP endpoint lets an agent see what a public page looks like. It speaks plain JSON-RPC 2.0 over streamable HTTP with no session, accepts up to 20 messages in one POST, and allows 120 requests a minute per IP, separate from plan limits.

There are two tools. take_screenshot needs an access key and renders a URL as PNG, JPEG, WebP, PDF, or an MP4, WebM or GIF recording of the page scrolling. Options include full page, device presets such as iphone_15_pro, window size, dark mode, a CSS selector, wait events, delay, caching, ad blocking and cookie-banner hiding. Over MCP the defaults are JPEG with ads and banners blocked, to keep images small. list_devices returns the device presets and needs no key.

Replies carry a one-line summary with remaining screenshots and a download link valid about a day, plus the image as base64. Plans: 100 screenshots a month free, then $19 for 3,000, $79 for 15,000 or $249 for 60,000. Failed renders and cache hits are not counted, and there are no overage charges.

## Features

- **Multiple output formats:** PNG, JPEG, WebP, PDF, MP4, WebM and GIF.
- **Capture controls:** Full page, device presets, selector, dark mode and delay.
- **Cleaner shots:** Blocks ads and cookie banners; on by default over MCP.
- **Download links:** Each result includes a link valid for about a day.
- **Agent-readable docs:** llms.txt, OpenAPI and markdown versions of pages.

## Good for

- Let an agent check how a page renders on a phone
- Archive a page as PDF
- Record a scrolling video of a landing page
- Capture one element using a CSS selector

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http curlshot https://curlshot.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://curlshot.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "curlshot": {
      "url": "https://curlshot.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "curlshot": {
      "type": "http",
      "url": "https://curlshot.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "curlshot": {
      "serverUrl": "https://curlshot.com/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "curlshot": {
      "type": "http",
      "url": "https://curlshot.com/api/mcp"
    }
  }
}
```

## Tools

- `take_screenshot`: Renders a public page as an image, PDF or scrolling video.
- `list_devices`: Returns the device presets accepted by viewport_device.

## FAQ

### Do I need an API key?

Yes for take_screenshot, sent as a Bearer access key. list_devices needs none.

### What does it cost?

100 screenshots a month free. Paid plans are $19, $79 and $249 a month.

### What counts as a screenshot?

One successful render. Failed renders and cache hits are not counted.

### Can it screenshot private pages?

It targets public web pages.

### Is CurlShot free?

CurlShot has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add CurlShot to Claude Code?

Run this command in your terminal: claude mcp add --transport http curlshot https://curlshot.com/api/mcp

### What are the best alternatives to CurlShot?

The closest alternatives to CurlShot are REA, Scrapling MCP Server, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/curlshot
