DEV Community

Dan E
Dan E

Posted on Originally published at rendex.dev

Add Screenshot Capability to Windsurf via MCP

Add Screenshot Capability to Windsurf via MCP

Windsurf's Cascade AI can read every file in your project and run terminal commands, but it cannot see a rendered web page. The Model Context Protocol (MCP) changes that: connect the Rendex MCP server and Cascade gains a tool it can call on its own to capture any URL and describe what it sees.

Prerequisites

  • Windsurf installed (any recent version with MCP support)
  • Node.js on your machine (for npx)
  • A Rendex API key. Get one free (100 renders/month, no credit card)

Step 1: Get a Rendex API key

Sign in at rendex.dev/login, open the dashboard, and copy your key. It starts with rdx_.

Step 2: Open the MCP Servers panel

In Windsurf, click the gear icon in the status bar and select MCP Servers. This opens mcp_config.json, the file Cascade reads at startup.

Step 3: Add the Rendex server

{
  "mcpServers": {
    "rendex": {
      "command": "npx",
      "args": ["-y", "@copperline/rendex-mcp"],
      "env": {
        "RENDEX_API_KEY": "rdx_your_key_here"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Replace rdx_your_key_here with your actual key and save the file.

Step 4: Restart Cascade

Click Restart Cascade in the MCP Servers panel, or close and reopen Windsurf.

Step 5: Verify the tool is available

In a Cascade chat, ask: What MCP tools do you have? Cascade should list rendex_screenshot.

Step 6: Capture a page

Screenshot https://rendex.dev and describe the hero section.

Capture https://example.com/checkout as a full-page PNG and check for layout issues.
Enter fullscreen mode Exit fullscreen mode

Cascade calls rendex_screenshot, gets the rendered page back, and answers from what it sees:

Windsurf Cascade chat: the user asks to screenshot stripe.com, Cascade calls rendex_screenshot, and returns the captured Stripe hero in a browser frame with a written summary of the headline and CTA

Troubleshooting

rendex_screenshot does not appear. Run npx @copperline/rendex-mcp --version in a terminal to confirm Node.js is installed.

Authentication error. Check that RENDEX_API_KEY in mcp_config.json matches your dashboard key exactly, including the rdx_ prefix.

Cascade times out. Ask Cascade to add blockResourceTypes: ["media", "font"] or use waitUntil: "domcontentloaded" for faster captures.

Next steps

Get a free API key and start with 100 captures per month.

Top comments (0)