How to Use the Browse AI MCP in Windsurf

Q: How do I add the Browse AI MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and configure it via the MCP Servers UI. Windsurf will load the tools instantly.

Q: How does Windsurf handle Browse AI credit limits?

Cascade calls listcredits to check your available Browse AI quota before starting any large scraping job. If your credits are low, Cascade alerts you in the chat interface before running the task.

Q: Can I list my active Browse AI robots in Windsurf?

Yes, Cascade uses listrobots to show all your configured scrapers directly in the Windsurf terminal or chat window. You can select a robot and ask Cascade to execute it on a new target URL instantly.

Run Browse AI robots and pull clean web scraping data directly into your Windsurf workspace with Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Browse AI MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trigger Browse AI scraper robots directly inside Windsurf

The `run_robot` tool lets Cascade start extraction runs on any URL directly from your Windsurf chat window. Once triggered, Cascade uses `get_task` to watch the run status, meaning you do not have to manually check the Browse AI dashboard to see if your data is ready. If you need to scale up, Cascade can grab multiple URLs from your current file and pass them to `run_bulk_task`. It chains these steps to pull live web data straight into your active workspace without breaking your focus.

Feed clean JSON data straight into Cascade code files

The `get_task_data` tool retrieves the final structured JSON from successful Browse AI scraper runs directly inside your IDE. Cascade handles the extraction process, detects when the status switches to successful, and immediately downloads the payload. Instead of copying and pasting web data, Cascade writes the output of `download_bulk_data` directly into your mock files or local database seeds. This MCP server lets you build and test features using real, fresh web data without leaving your editor.

Track site monitors and credits inside your Windsurf IDE

The `list_monitors` tool exposes all active scheduled web monitors to Cascade, letting your IDE monitor page changes and fetch updates. Cascade inspects your setup using `list_robots` to verify which extractors are active before initiating a run. To keep your scraping runs from failing due to empty quotas, Cascade checks `list_credits` to verify your remaining balance. This MCP integration keeps your development loop informed of your external scraping limits.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "browse-ai-1-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 Browse AI. 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 Browse 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 Browse AI MCP in Windsurf

Open your ~/.codeium/windsurf/mcp_config.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and configure it via the MCP Servers UI. Windsurf will load the tools instantly.

Yes, Cascade can autonomously read a list of URLs from your code and trigger `run_bulk_task` to run them concurrently. It then uses `get_bulk_task` to check the progress and downloads the completed datasets without you prompting each step.

Cascade calls `list_credits` to check your available Browse AI quota before starting any large scraping job. If your credits are low, Cascade alerts you in the chat interface before running the task.

Yes, Cascade uses `list_robots` to show all your configured scrapers directly in the Windsurf terminal or chat window. You can select a robot and ask Cascade to execute it on a new target URL instantly.

Your Browse AI API credentials remain inside your local Windsurf configuration and are only transmitted to the Vinkius sandbox. The scraped JSON payloads fetched by `get_task_data` are processed locally within your secure IDE environment.

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