Bright Data MCP Setup Guide
Prerequisites
- Bright Data account (free tier: 5,000 requests/month)
- API token from user settings
- For local setup: Node.js installed
Remote MCP (Recommended)
No installation required. Use the hosted server URL in your MCP client.
Endpoints
SSE (Server-Sent Events):
https://mcp.brightdata.com/sse?token=YOUR_API_TOKENStreamable HTTP:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKENWith Pro Mode (All Tools)
https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&pro=1With Tool Groups
https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=ecommerce,socialWith Custom Tools
https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&tools=scrape_as_markdown,web_data_linkedin_person_profileCombined Options
https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=ecommerce&tools=extractRemote URL Parameters
| Parameter | Description | Example |
|---|---|---|
token | API token (required) | token=abc123 |
pro | Enable all Pro tools | pro=1 |
groups | Tool group IDs (comma-separated) | groups=ecommerce,social |
tools | Individual tool names (comma-separated) | tools=scrape_as_markdown |
unlocker | Custom web unlocker zone | unlocker=my_zone |
browser | Custom browser zone | browser=my_browser |
Local MCP (Self-hosted)
Quick Start
bash
npx @brightdata/mcpOr install globally:
bash
npm install -g @brightdata/mcp
brightdata-mcpWith Environment Variables
bash