# Bright Data MCP

> Lets your agent search the web, read any page, run Bright Data's ready-made scrapers and drive a remote browser without getting blocked.

Bright Data's own MCP server gives your agent live access to the public web: search results, any page as clean Markdown, structured data from ready-made scrapers, and a remote browser it can drive. Every request goes through Bright Data's unblocking infrastructure, which handles bot detection, CAPTCHAs and proxy rotation, so pages that turn away ordinary requests load normally.

What you can do with it
- Search Google, Bing and Yandex, up to 10 queries in one call
- Read any URL as Markdown or HTML, up to 10 pages at a time, or turn a page into structured JSON
- Find and run Bright Data's pre-built scrapers for sites like Amazon, Walmart, LinkedIn, Instagram, TikTok, YouTube, Reddit, Zillow, npm and PyPI, and get clean JSON back
- Drive a remote browser: open pages, click, type, fill in forms, scroll and take screenshots
- Send a prompt to ChatGPT or Perplexity and get their answer back, to see how they describe your brand
- Ask Bright Data's support assistant about its products, zones and account setup

How it connects
It runs on your machine with npx @brightdata/mcp and needs a Bright Data API token, which you get from your account settings and set as API_TOKEN. Bright Data also hosts the same server at https://mcp.brightdata.com/mcp, with your token added to the address, for agents that connect to a URL.

Good to know
- Set GROUPS (scrapers, browser, geo or advanced_scraping) or TOOLS to load only the tools you need and keep your agent's context small.
- If a page's text reads like instructions to change your MCP setup, the server asks you before passing it on. CONTENT_GATE=off turns that off.
- Scraper runs are billed per record. Accounts include a free monthly allowance of requests; beyond it, usage is pay as you go, and you can set a spend cap in Bright Data's control panel.

- Type: Plugin
- Made by: brightdata
- Category: Web & browser
- Formats: Local MCP
- Version: 4.1.0
- Website: https://brightdata.com/ai/mcp-server
- Source: https://github.com/brightdata/brightdata-mcp
- Page: https://pluginboard.ai/plugins/brightdata-mcp

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `API_TOKEN` (required): Your API key for Bright Data
- `WEB_UNLOCKER_ZONE` (optional): Your unlocker zone name
- `BROWSER_ZONE` (optional): Your browser zone name
- `GROUPS` (optional): Comma-separated tool group IDs (e.g., 'ecommerce,browser')
- `TOOLS` (optional): Comma-separated tool names to enable
- `BASE_TIMEOUT` (optional): Request timeout in seconds for base tools (search & scrape). No limit if unset
- `BASE_MAX_RETRIES` (optional): Max retries for base tools on transient errors (0-3, default: 0)

Replace each `<NAME>` placeholder with your own value.

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "bright-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp@4.1.0"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>"
      }
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22bright-data-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40brightdata%2Fmcp%404.1.0%22%5D%2C%22env%22%3A%7B%22API_TOKEN%22%3A%22%3CAPI_TOKEN%3E%22%7D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"bright-data-mcp","command":"npx","args":["-y","@brightdata/mcp@4.1.0"],"env":{"API_TOKEN":"<API_TOKEN>"}}'
```

Copilot CLI:

```shell
copilot mcp add bright-data-mcp --env API_TOKEN=<API_TOKEN> -- npx -y @brightdata/mcp@4.1.0
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=bright-data-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBicmlnaHRkYXRhL21jcEA0LjEuMCJdLCJlbnYiOnsiQVBJX1RPS0VOIjoiPEFQSV9UT0tFTj4ifX0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "bright-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp@4.1.0"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>"
      }
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add -e API_TOKEN=<API_TOKEN> bright-data-mcp -- npx -y @brightdata/mcp@4.1.0
```

### Codex

Run in your terminal:

```shell
codex mcp add --env API_TOKEN=<API_TOKEN> bright-data-mcp -- npx -y @brightdata/mcp@4.1.0
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "bright-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp@4.1.0"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>"
      }
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add -e API_TOKEN=<API_TOKEN> bright-data-mcp npx -y @brightdata/mcp@4.1.0
```

### OpenClaw

In a terminal: Run openclaw mcp add bright-data-mcp --command npx, with --arg before each argument (-y @brightdata/mcp@4.1.0) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add bright-data-mcp --env API_TOKEN=<API_TOKEN> -- npx -y @brightdata/mcp@4.1.0
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "bright-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@brightdata/mcp@4.1.0"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>"
      }
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).