MCP Server

Bright Data Model Context Protocol (MCP) empowers your AI models and agents with
real-time, reliable access to public web data. With Bright Data MCP, your applications can effortlessly retrieve both static and dynamic content from across the web, eliminating the need to build or maintain complex data scraping and unlocking infrastructure.

​

Configuration

Before you begin, ensure you have the following:

• Node.js package is installed and up to date

  A Bright Data account (new users get free credit for testing, and then you can pay as you go)

• An API key with Admin permissions from the user settings page

• To enable automation capabilities create a Browser API zone in your control panel (any zone name is allowed)

Choose your client configuration:

// Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<api-key>", // insert your api key from https://brightdata.com/cp/setting/users
        "WEB_UNLOCKER_ZONE": "<web_unlocker zone name>", // Optional - if you want to use different name than mcp_unlocker, and uses web_unlocker
        "BROWSER_ZONE": "<browser zone name>", // Optional - if you use browser api and want to use a different name than mcp_browser
    		"RATE_LIMIT": "<rate limit format>" // Optional - possible values: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s
      }
    }
  }
}

// Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<api-key>", // insert your api key from https://brightdata.com/cp/setting/users
        "WEB_UNLOCKER_ZONE": "<web_unlocker zone name>", // Optional - if you want to use different name than mcp_unlocker, and uses web_unlocker
        "BROWSER_ZONE": "<browser zone name>", // Optional - if you use browser api and want to use a different name than mcp_browser
    		"RATE_LIMIT": "<rate limit format>" // Optional - possible values: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s
      }
    }
  }
}

​

Examples

​

How to verify that the MCP is working

Claude will ask for permission request, click “Allow”

You will be able to monitor your BrightData API usage under “My Zones” in the BrightData website

​

Troubleshooting

For any problem, look at the troubleshooting section on GitHub or contact support