← Index

io.github.brightdata/brightdata-mcp

io.github.brightdata/brightdata-mcp·v2.9.5·Search
Quality Score
85
/100

Bright Data's Web MCP server enabling AI agents to search, extract & navigate the web

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "brightdata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "<your-api_token>",
        "WEB_UNLOCKER_ZONE": "<web_unlocker_zone>",
        "BROWSER_ZONE": "<browser_zone>",
        "PRO_MODE": "<pro_mode>",
        "GROUPS": "<groups>",
        "TOOLS": "<tools>",
        "POLLING_TIMEOUT": "<polling_timeout>",
        "BASE_TIMEOUT": "<base_timeout>",
        "BASE_MAX_RETRIES": "<base_max_retries>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "brightdata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "<your-api_token>",
        "WEB_UNLOCKER_ZONE": "<web_unlocker_zone>",
        "BROWSER_ZONE": "<browser_zone>",
        "PRO_MODE": "<pro_mode>",
        "GROUPS": "<groups>",
        "TOOLS": "<tools>",
        "POLLING_TIMEOUT": "<polling_timeout>",
        "BASE_TIMEOUT": "<base_timeout>",
        "BASE_MAX_RETRIES": "<base_max_retries>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @brightdata/mcp
§02  Environment variables
API_TOKEN
requiredsecret

Your API key for Bright Data

WEB_UNLOCKER_ZONE

Your unlocker zone name

BROWSER_ZONE

Your browser zone name

PRO_MODE

To enable PRO_MODE - set to true

GROUPS

Comma-separated tool group IDs (e.g., 'ecommerce,browser')

TOOLS

Comma-separated tool names to enable

POLLING_TIMEOUT

Polling timeout in seconds for web_data_* tools (default: 600)

BASE_TIMEOUT

Request timeout in seconds for base tools (search & scrape). No limit if unset

BASE_MAX_RETRIES

Max retries for base tools on transient errors (0-3, default: 0)

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Search