Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Building an AI startup?

You might be eligible for our Startup Program. Get fully funded access to the infrastructure you’re reading about right now (up to $20K value).
Getting Started Video:

​
Hosted MCP

1

Get your API token

  1. Go to Bright Data user settings
  2. Copy your API token (it looks like: 2dceb1aa0***************************)
2

Configure your MCP server

  1. Open Claude Desktop
  2. Go to: Settings → Developer → Edit Config
  3. Add this to your claude_desktop_config.json:
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE"
      ]
    }
  }
}
  1. Replace YOUR_API_TOKEN_HERE with your actual API token from Step 1
  2. Save and restart Claude Desktop
3

Test it works

  1. Ask your AI: “Can you search Google for ‘weather today’?”
  2. Claude will ask for permission - click “Allow”
  3. You should see results!
4

Monitor usage

  1. View your API usage at My Zones in your Bright Data dashboard
  2. Your free tier includes 5,000 requests per month

​
Self-hosted MCP

1

Prerequisites

Before you begin, ensure you have the following:
If you prefer to use a different zone name, you can specify it with the WEB_UNLOCKER_ZONE environment variable in your configuration
2

Basic 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": "<insert your api key from https://brightdata.com/cp/setting/users>"     
      }
    }
  }
}
3

Advanced Configuration

If you want to use advanced features like rate limiting or custom zones, you can add more environment variables:
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<insert your api key from https://brightdata.com/cp/setting/users>",
        "WEB_UNLOCKER_ZONE": "<Optional - if you want to use a specific name for web_unlocker, the name goes here. If not - REMOVE this field>",
        "BROWSER_ZONE": "<Optional - if you want to use a specific name for browser_api, the name goes here. If not - REMOVE this field>",
        "RATE_LIMIT": "<Optional - rate limit format, possible values: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s. If not in use - REMOVE this field>",
        "PRO_MODE": "<Optional - set to true to enable all 60+ tools>",
        "GROUPS": "<Optional - comma-separated tool groups, e.g., browser,ecommerce,social>",
        "TOOLS": "<Optional - comma-separated individual tool names to enable>"
      }
    }
  }
}