How to Use the Browserless (Playwright Cloud) MCP in Windsurf

Q: How do I connect the Browserless (Playwright Cloud) MCP Server to Windsurf?

You add the server configuration directly to your /.codeium/windsurf/mcpconfig.json file using the provided Vinkius endpoint. Cascade immediately auto-discovers the tools and uses them whenever a prompt requires web interaction.

Q: What happens when a target site uses heavy lazy-loading?

Cascade uses scrapewithwait to hold the connection open until specific CSS selectors render on the remote browser. This ensures your agent doesn't receive half-empty pages or loading spinners.

Let Windsurf Cascade spin up remote Playwright browsers to scrape complex web apps, extract clean DOM elements, and capture screenshots on the fly.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Browserless (Playwright Cloud) MCP to Windsurf

Create your Vinkius account to connect Browserless (Playwright Cloud) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Browserless (Playwright Cloud) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade-Driven Web Scrapes with Windsurf

The `scrape_elements` and `scrape_with_wait` tools let Windsurf Cascade target specific CSS selectors and wait for elements to load before grabbing the data. Cascade analyzes the target site structure, identifies the container selectors, and pulls down the exact DOM elements it needs to build your context. Because Cascade handles multi-step sequences, it pairs these queries with `get_html_content` to fall back on raw markup when selectors change. You get clean, parsed data directly in your Windsurf editor workspace without running local browser instances.

Bypass Bot Mitigations with Stealth and Proxies

Routing traffic through clean IP addresses is handled by the `scrape_with_stealth` and `scrape_with_proxy` tools. This prevents cloud firewalls from blocking Cascade when it attempts to pull documentation or live data from protected endpoints. When Windsurf encounters a cloudflare wall during a task, it automatically switches to these stealth tools to keep its context-gathering process alive. Your agent gets the data it needs to write code, bypassing annoying CAPTCHAs silently behind the scenes.

Run Custom JS and Capture Visual Proof

Executing raw JavaScript inside the remote browser is done via `run_custom_function` and `get_screenshot` to snap full-page PNGs of the rendered output. Cascade uses these tools to interact with complex single-page apps, trigger state changes, and verify the resulting layout visually. If you need to verify how a UI looks after Cascade injects code, the agent pulls the screenshot directly into your Windsurf sidebar. This MCP Server lets you debug remote rendering issues without ever opening a local Chrome window.

Setup guide

Set up Browserless (Playwright Cloud) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Browserless (Playwright Cloud) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Browserless (Playwright Cloud) payment history." If connected, Cascade will call the Browserless (Playwright Cloud) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "browserless-playwright-cloud-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Playwright Cloud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Browserless (Playwright Cloud) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Browserless (Playwright Cloud) MCP in Windsurf

You add the server configuration directly to your `~/.codeium/windsurf/mcp_config.json` file using the provided Vinkius endpoint. Cascade immediately auto-discovers the tools and uses them whenever a prompt requires web interaction.

Yes, Cascade can execute multi-step login flows by chaining `scrape_with_js` to input credentials and click buttons. It then uses the active session state to scrape protected pages without local setup.

No, because all browser execution happens on Vinkius sandboxed cloud infrastructure rather than your local machine. Windsurf receives only the final extracted HTML or image data, keeping your local editor lightweight and fast.

Cascade uses `scrape_with_wait` to hold the connection open until specific CSS selectors render on the remote browser. This ensures your agent doesn't receive half-empty pages or loading spinners.

Vinkius processes all remote browser traffic, screenshots, and HTML payloads inside ephemeral, single-use V8 isolates. No session logs, target URLs, or extracted text are stored permanently after Cascade finishes its execution block.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript