How to Use the Hyperbrowser (Web Infra for AI) MCP in Windsurf

Q: How do I connect Hyperbrowser (Web Infra for AI) to Windsurf?

Add the server configuration to your mcpconfig.json file. Once you refresh the MCP panel, Cascade detects all tools automatically and starts using them.

Q: Does Windsurf support long-running scraping with Hyperbrowser (Web Infra for AI)?

Yes. You trigger the job with startscrape and use getscrapejob to poll for the final results. This keeps your IDE responsive while the browser does the heavy lifting.

Q: Can Hyperbrowser (Web Infra for AI) help Windsurf agents bypass anti-bot measures?

The server includes stealth configuration options within createsession. You pass these as JSON config to modify browser fingerprints and proxy settings before starting your task.

Q: What happens to browser sessions when I close Windsurf?

Sessions remain active until you explicitly call stopsession or the timeout is reached. You can use listsessions to track and clean up any dangling instances.

Let Cascade control remote browser sessions directly in Windsurf to gather data and verify web UI behavior without manual setup.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hyperbrowser (Web Infra for AI) MCP to Windsurf

Create your Vinkius account to connect Hyperbrowser (Web Infra for AI) 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 Hyperbrowser (Web Infra for AI) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous browser session management

Cascade uses `create_session` and `get_session` to spin up isolated cloud browsers for your tasks. It handles the lifecycle so you don't have to manage local drivers or proxy configurations. Once a session is live, Cascade can use `run_script` to interact with complex web pages. It chains these operations to navigate through multi-step flows.

Structured data extraction for Windsurf

Point your agent at any target and use `start_scrape` combined with `extract_data`. It renders the page and returns the results as clean JSON for your project files. This MCP Server allows Cascade to pull specific information like pricing or product details. It parses the DOM so you get usable data instead of raw HTML.

Visual feedback and debugging

When you need to see what the agent sees, call `page_screenshot`. Cascade displays the output in your IDE to verify that your scripts hit the right elements. Use `page_content` to inspect the source if the visual layout doesn't tell the whole story. This creates a tight feedback loop for debugging web-based tasks.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "hyperbrowser-web-infra-for-ai-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 Hyperbrowser. 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 Hyperbrowser (Web Infra for AI) 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 Hyperbrowser (Web Infra for AI) MCP in Windsurf

Add the server configuration to your `mcp_config.json` file. Once you refresh the MCP panel, Cascade detects all tools automatically and starts using them.

Yes. You trigger the job with `start_scrape` and use `get_scrape_job` to poll for the final results. This keeps your IDE responsive while the browser does the heavy lifting.

The server includes stealth configuration options within `create_session`. You pass these as JSON config to modify browser fingerprints and proxy settings before starting your task.

Sessions remain active until you explicitly call `stop_session` or the timeout is reached. You can use `list_sessions` to track and clean up any dangling instances.

Your session data, including cookies and local storage, stays within your isolated browser instance. The server only transmits the requested content or extracted data back to your agent.

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