-
Endpoint
https://api.localscreenshot.com/mcp -
KeyYour API key, in the
Authorizationheader. -
Free every month50 credits each month, no card.
1Endpoint
One address, over Streamable HTTP. Your tool sends JSON-RPC requests to it with POST.
https://api.localscreenshot.com/mcpAuthorization: Bearer $LOCALSCREENSHOT_API_KEYKeep 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 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.
{
"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.
{
"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.
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.
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.
https://api.localscreenshot.com/mcp/freetake_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.