Skip to main content
1

Prerequisites

Before you begin, make sure you have the following:

Bright Data Account

Sign up for free and receive 5,000 requests per month at no cost.

Your Bright Data API Key

New users receive their API key in the welcome email.

Node.js

Ensure Node.js is installed and up to date.
2

Choose Your Client

Select and configure your preferred MCP client:

Claude

n8n

3

Advanced Configuration

Add environment variables to customize your MCP server:
{
  "mcpServers":{
    "Bright Data":{
      "command":"npx",
      "args":[
        "@brightdata/mcp"
      ],
      "env":{
        "API_TOKEN":"<insert-your-api-token-here>",
        "RATE_LIMIT":"<optional if you want to change rate limit format: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s>",
        "WEB_UNLOCKER_ZONE":"<optional if you want to override the web unlocker zone name - default is mcp_unlocker>",
        "BROWSER_ZONE":"<optional if you want to override the browser zone name - defaults is mcp_browser>",
        "PRO_MODE":"<optional boolean, defaults to false. Set to true to expose all tools including browser and web_data_* tools>"
      }
    }
  }
}

​
Modes: Rapid (Free) vs Pro

Rapid (Free) – Access to search_engine and scraper_as_markdown tools.
Pro – Adds Browser API and Scraper tools for advanced capabilities.Set PRO_MODE=true in your environment variables to enable Pro features.
4

Quick Examples

Try these example prompts with your MCP server:
“Extract all flight times departing from JFK Airport to Heathrow in the next 24 hours.”
“Extract the Bright Data overview section from LinkedIn.”
“Go to ebay.com, click the ‘Shop by category’ button in the navigation bar, and extract all categories.”