Skip to the content
For AI tools

MCP server

Connect your AI tool once. After that it takes screenshots of web pages on its own, from 227 countries.

On this page5 sections
In shortWhat you need to connect.
  • Endpointhttps://api.localscreenshot.com/mcp
  • KeyYour API key, in the Authorization header.
  • Free every month50 credits each month, no card.

1Endpoint

One address, over Streamable HTTP. Your tool sends JSON-RPC requests to it with POST.

Addresshttps://api.localscreenshot.com/mcp
TransportStreamable HTTP, POST
HeaderAuthorization: Bearer $LOCALSCREENSHOT_API_KEY
KeyThe same API key as the REST API. Create a free account to get one.

Keep the key out of shared files. The blocks below read it from the LOCALSCREENSHOT_API_KEY environment variable where the tool allows it.

2Connect your tool

Copy the block for your tool. More tools are on the home page and in the documentation.

Claude Code

One command in your terminal.

Claude Code
claude mcp add --transport http localscreenshot https://api.localscreenshot.com/mcp \
  --header "Authorization: Bearer $LOCALSCREENSHOT_API_KEY"

Cursor

Paste into .cursor/mcp.json. Cursor reads the key from your environment.

Cursor
{
  "mcpServers": {
    "localscreenshot": {
      "url": "https://api.localscreenshot.com/mcp",
      "headers": { "Authorization": "Bearer ${env:LOCALSCREENSHOT_API_KEY}" }
    }
  }
}

VS Code

Paste into .vscode/mcp.json. VS Code asks for your key once and keeps it. Works for GitHub Copilot in VS Code.

VS Code
{
  "inputs": [
    { "type": "promptString", "id": "localscreenshot-key", "description": "localscreenshot API key", "password": true }
  ],
  "servers": {
    "localscreenshot": {
      "type": "http",
      "url": "https://api.localscreenshot.com/mcp",
      "headers": { "Authorization": "Bearer ${input:localscreenshot-key}" }
    }
  }
}

Claude

In Claude (web or desktop): Customize, Connectors, then add a custom connector.

Claude
1. In Claude, open Customize > Connectors
2. Click "+ Add", then "Add custom connector"
3. Name: localscreenshot
4. URL: https://api.localscreenshot.com/mcp
5. Under Request headers, add
   Authorization: Bearer $LOCALSCREENSHOT_API_KEY
6. Save, then ask Claude for a screenshot

Replace $LOCALSCREENSHOT_API_KEY with your key.

No MCP in your tool? An agent that can run a shell command can use the command line client: npx localscreenshot https://example.com, or pip install localscreenshot. More about the command line.

3What your tool can do

The server gives your tool 3 tools. Each screenshot uses credits from your account. A failed screenshot is not charged.

ToolWhat it does
take_screenshotTake a screenshot of a public web page and get the image back. Options: device or viewport size, full page, a single element (selector), dark mode, hiding cookie banners and ads, and loading the page from a chosen country. Returns the image, the page title, final URL and HTTP status, and the credits left. Each screenshot uses credits from the connected account and is saved to its screenshot list.
list_countriesList the countries a screenshot can be taken from. Use the two-letter code as the "country" option of take_screenshot.
get_creditsShow how many credits are left on the connected account. A screenshot uses 1 credit, or 2 when taken from a chosen country.

It does not sign in to websites, does not solve bot checks and does not get past paywalls.

4Free endpoint, no key

A second address answers without a key. It is there so a directory, or an agent without an account yet, can discover the server and look at a real result. It does not capture a page of your choice.

Addresshttps://api.localscreenshot.com/mcp/free
KeyNone
Limit3 tool calls a minute for each address
ToolWhat it does
take_demo_screenshotSee what a localscreenshot result looks like: a real screenshot of one of our example pages. It does not capture a page of your choice. For that, create a free account and use the main MCP server with an API key.
list_countriesList the countries a screenshot can be taken from, with their two-letter codes. Choosing a country needs an account: this free endpoint only lists them.
get_pricingWhat localscreenshot costs: the free credits every account gets each month, the limits of a free account, what a screenshot costs in credits, and where paid plans and credit packs start.

5Credits and limits

  • 50 free credits every month, no card. A free account can send 10 requests a minute and run 2 screenshots at a time.
  • Every account without a paid plan gets 50 free credits each calendar month (UTC), given the first time it is used that month. They do not carry over: what is left is gone on the 1st. After the month the account was created, its email address must be confirmed.
  • A screenshot costs 1 credit, or 2 from a chosen country.
  • Plans start at €19 a month for 2,000 credits. Credit packs start at €12, paid once, for 1,000 credits.

Prices are before tax. The full grid is on the Pricing page.