How to add ScreenshotOne MCP Server to Windsurf

Community server that captures website screenshots via the ScreenshotOne API. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 36★ · stdio · apikey

Windsurf config for ScreenshotOne MCP Server

npx -y screenshotone-mcp-server

{
  "mcpServers": {
    "screenshotone-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "screenshotone-mcp-server"
      ],
      "env": {
        "SCREENSHOTONE_API_KEY": "<your-api-key>"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the ScreenshotOne MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5ScreenshotOne MCP Server's tools become available to Cascade.

Before you start

Node.js 18 or higher
A ScreenshotOne access key from https://dash.screenshotone.com/access, set as SCREENSHOTONE_ACCESS_KEY
Git, if installing from source rather than the npm package

What ScreenshotOne MCP Server can do in Windsurf

take_screenshot

Capture a website screenshot from a URL, with options for viewport size, full-page capture, CSS-selector targeting, output format (PNG/JPEG/WebP/PDF), ad/tracker/cookie-banner blocking, and optional upload.

Security

The ScreenshotOne API key bills rendering usage to your account; keep it in env. Captured URLs are sent to ScreenshotOne's servers for rendering, so avoid passing internal or authenticated pages.

ScreenshotOne MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the ScreenshotOne MCP Server config there under the "mcpServers" key and restart the client.

Is ScreenshotOne MCP Server safe to use with Windsurf?

The ScreenshotOne API key bills rendering usage to your account; keep it in env. Captured URLs are sent to ScreenshotOne's servers for rendering, so avoid passing internal or authenticated pages.

Where do I get the access key?

Sign up at ScreenshotOne and create a key at https://dash.screenshotone.com/access, then set it as SCREENSHOTONE_ACCESS_KEY.

Is there a free tier?

ScreenshotOne offers a free tier with a monthly screenshot quota; heavier usage requires a paid plan. The MCP server itself is open source (ISC).

What output formats are supported?

PNG, JPEG, WebP, and PDF, selectable via the format option on the screenshot tool.

View repo Full ScreenshotOne MCP Server page