Use GetScreenshot in Claude Desktop
Add the GetScreenshot MCP server to claude_desktop_config.json. Claude can then capture any public page, render HTML, and compare before and after, right in a chat.
Works with any GetScreenshot API key on any plan, from $5/month.
What you get
Five tools that let the agent look at web pages
Look at any public page
The agent passes a URL to capture_screenshot. A hosted browser renders the page and the tool returns images sized for vision models, plus a link to the full-resolution file.
Render HTML it just wrote
render_html takes an HTML string and returns a screenshot of it. The agent can check a component or email template without a local browser.
Compare before and after
compare_screenshots diffs two pages or two earlier captures and reports the share of changed pixels, where the change is, and a diff image.
Limits worth knowing: captures run on our servers, so they cannot reach localhost or private networks. Each call is a single capture, not a logged-in browsing session. For multi-step browser automation see GetScreenshot vs Playwright MCP. Screenshot links are public URLs that stay available for 30 days.
Before You Start
Three things to have ready
A GetScreenshot API key
Any plan works. Plans start at $5/month for 2,500 screenshots. Get a key.
Claude Desktop
Claude Desktop installed (macOS, Windows or Linux).
Node.js 20.9 or newer
Only for the local option, which runs npx -y getscreenshot-mcp on your machine. The hosted option needs nothing installed.
How to Set Up
Hosted server at https://mcp.getscreenshotapi.com/mcp, or a local server started with npx
The dependable path for Claude Desktop is the local server, set up in its config file. A hosted option exists but is not available to every account. It is described after the steps. Both give the agent the same five tools and use the same API key and quota.
Get your API key
Pick a plan on the pricing page. The key arrives by email after checkout. The MCP server works with any API key on any plan, including Lincoln at $5/month for 2,500 screenshots. Code FREE5 makes the first month of the $5 plan free. If you lose the key, recover it from your account page.
View pricing plansOpen the config file
Open the Claude menu in your system menu bar and choose Settings.... In the Settings window, open the Developer tab and click Edit Config. This opens the file, and creates it if it does not exist yet:
- • macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - • Windows:
%APPDATA%\Claude\claude_desktop_config.json - • Linux:
~/.config/Claude/claude_desktop_config.json
Add the local server
Add the getscreenshot entry, with your key in place of YOUR_API_KEY. Claude Desktop starts the server on your machine with npx, so it needs Node.js 20.9 or newer. Check with node --version.
claude_desktop_config.json
{
"mcpServers": {
"getscreenshot": {
"command": "npx",
"args": ["-y", "getscreenshot-mcp"],
"env": {
"GETSCREENSHOT_API_KEY": "YOUR_API_KEY"
}
}
}
}If the file already has an mcpServers object, add the getscreenshot entry inside it.
This file holds your key in plain text. It lives in your user profile, not in a project. Do not copy it into a repository or a synced dotfiles folder with the key in it.
Restart Claude Desktop
Save the file, then quit Claude Desktop completely and start it again. Closing the window is not enough. The app reads the config and starts the server only at launch.
Confirm it is connected
In a chat, click the Add files, connectors, and more button at the bottom left of the message box. Hover over Connectors, click Manage connectors, and select getscreenshot. You should see its five tools.
Try a prompt
Ask for a screenshot of a public page. Claude asks for your approval before it runs a tool.
Take a screenshot of https://example.com and describe what is above the fold.Hosted server as a custom connector (limited availability)
Claude can also reach a remote MCP server as a custom connector. Our hosted server at https://mcp.getscreenshotapi.com/mcp authenticates with your API key in a request header. It does not use OAuth sign-in. Claude's connector dialog can send a fixed request header, but Anthropic's documentation describes that feature as a beta available to a limited set of organizations. If your dialog has no Request headers section, use the local setup above.
- 1. Go to Customize > Connectors, select Add, then Add custom connector.
- 2. Enter a name and the server URL
https://mcp.getscreenshotapi.com/mcp, then continue. - 3. Under Authentication, choose No sign-in.
- 4. Under Request headers (it may sit under Advanced), choose the
authorizationheader and enter the valueBearer YOUR_API_KEY. Include the wordBearerand the space. Claude sends the value exactly as you type it. Our server also accepts thex-api-keyheader with the key alone as its value. - 5. Click Add. Turn the connector on for a chat from the + button, under Connectors.
- • Authentication settings cannot be edited after you add a connector. To change the key, remove the connector and add it again.
- • On Team and Enterprise plans an Owner adds the connector under Organization settings > Connectors. A key stored in a request header is shared by every member who uses that connector, and so is its monthly quota.
- • Custom connectors are called from Anthropic's cloud, not from your computer. That works for our hosted server because it is on the public internet.
Prompts to Try
Replace the example URLs and file names with your own
Review a live page
Take a full-page screenshot of https://example.com/pricing and give me feedback on the layout and copy.
Check HTML
Render this HTML with render_html and tell me how it looks: <h1 style="font-family:sans-serif">Hello</h1>
Compare two pages
Compare https://staging.example.com with https://www.example.com and describe what changed.
Save a page as PDF
Save https://example.com/terms as a PDF and give me the link.
Each page captured uses one screenshot from your monthly quota. A comparison uses one per page it has to capture.
Tools the Server Adds
All five are read-only. Full inputs and outputs are in the MCP server reference
| Tool | What it does |
|---|---|
| capture_screenshot | Capture a public web page as images the model can see. Options cover full-page capture, a single element by CSS selector, device presets and wait conditions. |
| render_html | Render an HTML string (up to 2 MB) and screenshot it. Useful for a component or page the agent just wrote. |
| compare_screenshots | Visual diff of two pages or two earlier screenshots. Returns the changed-pixel percentage, the bounding box of the change and a diff image. |
| capture_pdf | Save a page as an A4 PDF and return a link that works for 30 days. |
| get_usage | Screenshots used, monthly limit and reset date for your key. Costs 1 quota unit. |
Troubleshooting
Common issues and how to resolve them
getscreenshot does not appear in the connector list
- • Check that the config file is valid JSON. A missing comma or brace stops every server in the file from loading.
- • Quit Claude Desktop completely and start it again.
- • Read the logs:
~/Library/Logs/Claudeon macOS,%APPDATA%\Claude\logson Windows,~/.config/Claude/logson Linux.mcp.logcovers connections andmcp-server-getscreenshot.logholds the server's own output. - • Run
npx -y getscreenshot-mcpin a terminal to see whether Node.js can start the server. Stop it with Ctrl+C.
Tools say no API key is configured
- • Check that
GETSCREENSHOT_API_KEYis spelled exactly like that inside theenvobject and that the value has no extra spaces. - • Restart Claude Desktop after every change to the file.
A tool call times out on a slow page
- • Ask the agent to retry with
wait_until: "domcontentloaded". It is the fastest setting and the most reliable on heavy sites. - • A capture usually takes around 9 seconds. The API gives up after 90 seconds.
- • Failed captures still count against your monthly quota, so change the settings before retrying more than once.
The agent cannot capture localhost or an internal site
- • The capture runs on our servers, which cannot reach
localhostor private networks. - • For markup the agent just wrote, use
render_htmlwith the HTML itself. Inline the CSS and images or set<base href>, because relative asset URLs will not resolve. - • For a running app, give the agent a public preview URL or a tunnel address.
The image is too large for the conversation
- • Ask for
return: "url_only"to get thescreenshot_urlwithout inline images. - • Capture one part of the page with
elementand a CSS selector instead of the full page. - • Lower
max_slices(default 4) to limit how many images a full-page capture returns.
Still stuck? Email support@rasterwise.com.
Other AI Clients
The same server works in other MCP clients. See all options on the AI Agents page
Prefer instructions the agent loads on demand? See the GetScreenshot agent skill.
GetScreenshot is an independent product. It is not affiliated with or endorsed by the makers of Claude Desktop. Product names belong to their owners.
Get an API Key and Connect Claude Desktop
Plans start at $5/month for 2,500 screenshots. The MCP server works with any API key on any plan.