Use GetScreenshot in Windsurf (now Devin Desktop)
Windsurf became Devin Desktop in June 2026. Add the GetScreenshot MCP server to its mcp_config.json and the agent can capture any public page, render HTML it just wrote, and compare before and after.
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.
Windsurf
Devin Desktop (the editor formerly named Windsurf), updated to a current build.
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
Devin Desktop supports both connection styles. Use one of them, not both. These steps are for the Devin Local agent, which is what new tabs use unless you picked another agent. 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 MCP config file
Open the Customize page from the Agents window and click MCPs. In the Install MCPs for selector choose This computer. The list shows the servers the agent loads, and you can open a listed server's config file from there. If the list is empty, create the file yourself. MCP servers are read from three places:
- • User, for all your projects:
~/.config/devin/mcp_config.json(%APPDATA%\devin\mcp_config.jsonon Windows) - • Local override, for one project and gitignored:
.devin/mcp_config.local.json - • Project, shared through version control:
.devin/mcp_config.json
Put the entries below in the user file or in .devin/mcp_config.local.json. Both hold your key in plain text and neither is shared. Do not put the key in .devin/mcp_config.json, which is checked into version control.
Option A: connect to the hosted server
Nothing to install. Add this entry, with your key in place of YOUR_API_KEY.
~/.config/devin/mcp_config.json
{
"mcpServers": {
"getscreenshot": {
"url": "https://mcp.getscreenshotapi.com/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}If the file already has an mcpServers object, add the getscreenshot entry inside it.
Option B: run the server locally
The agent starts the server on your machine with npx. Needs Node.js 20.9 or newer.
~/.config/devin/mcp_config.json
{
"mcpServers": {
"getscreenshot": {
"command": "npx",
"args": ["-y", "getscreenshot-mcp"],
"env": {
"GETSCREENSHOT_API_KEY": "YOUR_API_KEY"
}
}
}
}Confirm it is connected
Save the file and go back to Customize > MCPs. Refresh the list under This computer. getscreenshot should be listed with its toggle on. You can also ask the agent to list its MCP servers and tools. A new server may need a moment to initialize.
Try a prompt
Ask for a screenshot of a public page. By default the agent asks for approval before it calls an MCP tool. You can allow one tool or the whole server, for the session or permanently.
Take a screenshot of https://example.com and describe what is above the fold.Still on the legacy Cascade agent?
Cascade is now the legacy agent in Devin Desktop. To add a server for it, use Open MCP config file in Cascade's MCP menu, edit the mcp_config.json file it opens, and press the refresh button afterwards. Cascade's documentation shows the same mcpServers shape: command, args and env for a local server, and url or serverUrl with headers for a remote one. The editor also has a separate, build-specific file at ~/.codeium/windsurf/mcp_config.json that it uses for MCP discovery. To avoid editing the wrong one, always edit the file the menu action opens.
Prompts to Try
Replace the example URLs and file names with your own
Check a deployed change
Take a full-page screenshot of https://example.com/pricing and list anything that looks broken or misaligned.
Check HTML you just wrote
Render the HTML in src/index.html with render_html and tell me whether the hero section looks right.
Compare staging and production
Compare https://staging.example.com with https://www.example.com and describe what changed.
Check a mobile layout
Capture https://example.com with the iphone12 device and tell me if the navigation fits on screen.
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
Tools say no API key is configured, or the hosted server rejects the request
- • Check the key for typos or extra spaces.
- • Hosted setup: the header value must read
Bearer, a space, then the key. - • Local setup: check that
GETSCREENSHOT_API_KEYis spelled exactly like that inside theenvobject.
getscreenshot is not listed, or its tools do not appear
- • Check that the file is valid JSON and that you edited a file the agent reads (see the three locations in the setup steps).
- • Refresh the list under This computer and check that the server's toggle is on.
- • On an enterprise team, an admin can restrict MCP servers to an allowlist or registry. A server that is not allowed will not connect.
- • Local setup: check that
node --versionprints v20.9 or newer.
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 Windsurf. Product names belong to their owners.
Get an API Key and Connect Windsurf
Plans start at $5/month for 2,500 screenshots. The MCP server works with any API key on any plan.