How to add Bright Data MCP to Windsurf

All-in-one web access MCP — Web Unlocker, SERP, Scraper API, and a cloud Scraping Browser. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 5.0k★ · stdio · apikey · official

Windsurf config for Bright Data MCP

npx -y @brightdata/mcp

{
  "mcpServers": {
    "bright-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "<your-brightdata-api-token>"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Bright Data MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Bright Data MCP's tools become available to Cascade.

Before you start

Node.js installed (for local npx execution); not needed if you use the hosted remote server
A Bright Data API token — sign up at https://brightdata.com and create the token in your account (free tier available, no credit card required)
Set the token via the API_TOKEN environment variable (local) or the ?token= query param (hosted)

What Bright Data MCP can do in Windsurf

search_engine

Run an AI-optimized web search (Google/Bing/etc.) and get ranked results.

search_engine_batch

Batch multiple search-engine queries in one call.

scrape_as_markdown

Fetch a URL through Web Unlocker and return clean markdown.

scrape_batch

Scrape multiple URLs in a single batched request.

discover

AI-ranked search with intent scoring to surface the most relevant pages.

extract

AI-assisted extraction of fields from a page (Pro/advanced).

web_data_amazon_product

Structured product data from Amazon (one of 50+ web_data_* dataset tools).

web_data_linkedin_posts

Structured LinkedIn post data (social dataset).

Security

The API_TOKEN bills against your Bright Data account and PRO_MODE exposes 60+ powerful scraping tools, so keep the token in env and only enable PRO_MODE when needed. Content is fetched through Bright Data's proxy network, which sees the target URLs and returned data.

Bright Data MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Bright Data MCP config there under the "mcpServers" key and restart the client.

Is Bright Data MCP safe to use with Windsurf?

Is there a free tier?

Yes — 5,000 credits/month with no credit card required, and it auto-renews. Base tools cost 1 credit per request; web_data_* tools cost 1 credit per record returned. Unused credits don't roll over.

Do I have to install anything?

No. You can use the hosted remote server at https://mcp.brightdata.com/mcp?token=... with no install, or run it locally via npx @brightdata/mcp.

How do I enable the full set of tools?

Set PRO_MODE=true to expose all 60+ tools. For a narrower set, use the GROUPS env var (e.g. ecommerce, social, browser) or list individual tools via the TOOLS env var.

View repo Full Bright Data MCP page