Skip to content

Let an AI agent see a web page

To let an AI agent see a web page, connect it to the CurlShot MCP server. The agent gets a take_screenshot tool: it passes the address of a page and receives a screenshot of it, which a model that reads images can look at. Agents without MCP use the same thing as one HTTP request, described in an OpenAPI file and in llms.txt.

Request
curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://example.com&response_type=json&image_width=1200" \
  --output screenshot.json

How to let an AI agent see a web page in three steps

  1. 1

    Create a free account and copy your access key.

  2. 2

    Add the MCP server to your agent, or give it the screenshot request.

  3. 3

    Ask the agent to look at a page. It takes the screenshot itself.

Three ways in, for any kind of agent

Pick the one your agent already speaks. All three use the same access key and the same options.

Show the table (3 rows)
Way inAddressBest for
MCP server/api/mcp, with the tools take_screenshot and list_devicesClaude, Cursor and other MCP clients
OpenAPI description/openapi.jsonAgents and code generators that build a client from a spec
Plain HTTP and llms.txt/llms.txt, and the screenshot requestAny agent that can fetch a URL
  • Create a separate access key for the agent, so you can revoke it without touching your other keys.
  • Leave "Require signature" off for that key: calls through MCP are not signed.
MCP client configuration
{
  "mcpServers": {
    "screenshots": {
      "type": "http",
      "url": "https://curlshot.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACCESS_KEY" }
    }
  }
}

What people use it for

  • A coding agent that checks how the page it just changed looks
  • Research agents that read pages which need a real browser to load
  • Visual checks: is the banner there, did the layout break
  • Reports with screenshots, written by an assistant

For developers: one request

The same thing from your own code. It is a plain HTTP request, so it works from any language. Create a free account to get an access key.

Questions people ask

How can an AI agent take a screenshot of a website?

Through the CurlShot MCP server, which gives the agent a take_screenshot tool, or with one HTTP request that returns the image.

What does the agent get back?

The image itself, or with response_type=json a short JSON answer with a link to the file, which is easier for a tool call to pass on.

Can the agent read the page as text too?

The service returns images and PDFs. A PDF of a page has text that can be selected and extracted, and a model that reads images can read a screenshot directly.

How do I keep the cost of an agent under control?

Each plan is a fixed number of screenshots a month, and an access key can be revoked at any time. Repeat requests for the same page can come from the cache at no cost.

Take as many screenshots as you need

A free account gives you 100 screenshots every month and keeps them in one place. No card needed.