How to Use the Browserless MCP in Windsurf

Let Windsurf control headless Chrome to scrape sites, grab screenshots, and build PDFs without leaving your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Browserless MCP to Windsurf

Create your Vinkius account to connect Browserless 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 with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate web tasks in Windsurf

Cascade can trigger `get_page_content` to pull raw HTML directly into your codebase. It parses the DOM while you focus on the logic. Your agent handles the heavy lifting of `run_scrape` to pull specific data points. Windsurf then formats the output into your project files.

Visual feedback inside Windsurf

Use `take_screenshot` to verify layout shifts or visual bugs. The agent captures the current state of any URL and drops the image into your workspace. Need a report? Cascade calls `generate_pdf` to turn live pages into documentation. It saves the file locally for immediate review.

Monitor your Browserless MCP Server

Check `list_active_sessions` to see what your AI is doing in real-time. It prevents runaway processes during complex development cycles. Keep an eye on costs by running `get_usage_stats`. You'll know exactly how many resources your Windsurf agent burns through each day.

Setup guide

Set up Browserless 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 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 payment history." If connected, Cascade will call the Browserless tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "browserless-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 Browserless. 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 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 MCP in Windsurf

Add the server via the Cascade MCP settings panel. Once connected, Windsurf discovers the tools and lets your agent call them automatically.

Yes. Simply ask Cascade to convert a URL into a document. It uses `generate_pdf` to render the page and save it to your local directory.

Your data stays private. The server only touches the URLs you explicitly ask it to scrape or render during your Windsurf session.

You need an API key to authenticate. Once provided, you can check your status using `get_account_config`.

The service only processes public web content you request. It does not store your private credentials or local environment variables.

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

Mastra AI sdk-typescript

Start using the Browserless MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started