Brightdata MCP Server
by brightdataio.github.brightdata/brightdata-mcpv2.12.0
Discover, extract, and interact with the web - one interface powering automated access across the public internet.
context tax
queued
security
queued
cold start
queued
freshness
Active1d ago
Install Brightdata MCP server
Install in Claude Code
claude mcp add brightdata -e API_TOKEN='<api-token>' -- npx -y @brightdata/mcpInstall in Cursor
{
"mcpServers": {
"brightdata": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<api-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"brightdata": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<api-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"brightdata": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<api-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"brightdata": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<api-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| API_TOKEN | yes | yes | 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) |
Freshness
Active — last maintenance signal 1d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-08 · 1d ago · GitHub · v2.12.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-08 · 1d ago · official registry · v2.12.0
FAQ
›How do I install the Brightdata MCP server in Claude Code?
Run: claude mcp add brightdata -e API_TOKEN='<api-token>' -- npx -y @brightdata/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Brightdata require an API key?
Yes. It expects API_TOKEN, of which 1 is a secret.
›Can I use Brightdata as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Brightdata in the official MCP registry?
Yes, as io.github.brightdata/brightdata-mcp.