Bright Data Web MCP for Windsurf: Setup & Config

What you can do with Bright Data Web in Windsurf

Choose configurable live-web access spanning search, extraction, datasets, and package intelligence.

• Monitor product details and prices across retail datasets.
• Compare AI-generated brand mentions across supported LLM services.

Before you start: Bright Data Web in Windsurf

• Node.js with npx for local execution
• A Bright Data account and API token
• An MCP-compatible client

This configuration uses the local process. A hosted endpoint is also documented. Rapid mode is the default; optional groups and Pro tools can change usage costs.

Bright Data Web Windsurf configuration

1. Choose Windsurf configuration scope

   For Bright Data Web MCP, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

2. Add Bright Data Web MCP to Windsurf

   Use the brightdata-mcp entry below in mcpServers. Keep Bright Data Web MCP's documented stdio connection fields and your other Windsurf entries.

3. Check Bright Data Web MCP in Windsurf

   Bright Data Web MCP: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

{
  "mcpServers": {
    "brightdata-mcp": {
      "command": "npx",
      "args": [
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "<your Bright Data API token>"
      }
    }
  }
}

Bright Data Web tools available to Windsurf

Bright Data Web's stored tool list documents 30 tools; compare it with Windsurf's connected tool list, because the stored list is not a live check.

search_engine

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for search_engine.

search_engine_batch

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for search_engine_batch.

scrape_as_markdown

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for scrape_as_markdown.

scrape_batch

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for scrape_batch.

discover

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for discover.

scrape_as_html

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for scrape_as_html.

extract

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for extract.

scraping_browser_snapshot

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for scraping_browser_snapshot.

scraping_browser_click_ref

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for scraping_browser_click_ref.

Click a referenced element in the remote browser.

scraping_browser_screenshot

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for scraping_browser_screenshot.

Capture an image from the remote browser.

web_data_amazon_product

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_amazon_product.

Retrieve structured Amazon product information.

web_data_walmart_product

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_walmart_product.

Retrieve structured Walmart product information.

web_data_google_shopping

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_google_shopping.

Access Google Shopping dataset information.

web_data_linkedin_posts

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_linkedin_posts.

Retrieve structured LinkedIn post data.

web_data_tiktok_posts

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_tiktok_posts.

Retrieve structured TikTok post data.

web_data_youtube_videos

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_youtube_videos.

web_data_yahoo_finance_business

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_yahoo_finance_business.

web_data_crunchbase_company

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_crunchbase_company.

web_data_zoominfo_company_profile

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_zoominfo_company_profile.

web_data_zillow_properties_listing

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_zillow_properties_listing.

web_data_github_repository_file

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_github_repository_file.

web_data_reuter_news

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_reuter_news.

web_data_google_play_store

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_google_play_store.

Retrieve Google Play store data.

web_data_apple_app_store

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_apple_app_store.

Retrieve Apple App Store data.

web_data_booking_hotel_listings

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_booking_hotel_listings.

Access Booking hotel listing information.

web_data_chatgpt_ai_insights

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_chatgpt_ai_insights.

Query ChatGPT for structured AI insights and brand visibility research.

web_data_grok_ai_insights

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_grok_ai_insights.

Query Grok for AI insights useful in brand visibility research.

web_data_perplexity_ai_insights

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_perplexity_ai_insights.

Query Perplexity for sourced AI answers and brand visibility research.

web_data_npm_package

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_npm_package.

Look up npm package versions, documentation, and dependency metadata.

web_data_pypi_package

After refreshing Bright Data Web in Windsurf settings, check Cascade's tool list for web_data_pypi_package.

Look up Python package versions and project information from PyPI.

Bright Data Web: full stored tool descriptions

Troubleshooting Bright Data Web in Windsurf

• Check npx @brightdata/mcp (Node.js/npm) on the machine running Windsurf's MCP integration for Bright Data Web MCP; refresh MCP and inspect Cascade's tools.
• Check API_TOKEN for Bright Data Web MCP; do not bypass a Windsurf permission error with a broad administrator token.
• Bright Data Web MCP uses stdio here: Windsurf must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires a Bright Data API token.
• Known limitation: Browser automation and Pro capabilities incur usage charges.
• Known limitation: Requests stop after the free credit pool is exhausted unless funds are available.
• General Windsurf troubleshooting lives in the /clients/windsurf guide.

Frequently asked questions