Log inSubmit server
Brightdata MCP logo

Brightdata MCP

Searches the live web, extracts pages, and runs Bright Data scrapers through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Brightdata MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "brightdata-mcp": {
      "command": "npx",
      "args": [
        "@brightdata/mcp"
      ],
      "env": {
        "API_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The brightdata-mcp MCP server connects AI agents to Bright Data for live web search, webpage extraction, and structured scraper access. It provides search tools for Google, Bing, and Yandex, Markdown extraction for individual or multiple URLs, and an AI-ranked discovery tool. Use it for current research or site-specific data collection when ordinary web requests may encounter bot detection, CAPTCHAs, or geo-restrictions.

Use cases

  • Research current news and public web information
  • Extract readable Markdown from protected webpages
  • Compare data collected from multiple URLs
  • Run structured scrapers for products, companies, or reviews
  • Monitor asynchronous scraper jobs and retrieve records

Key features

  • Google, Bing, and Yandex search
  • Single-page and batch Markdown extraction
  • AI-ranked web discovery
  • Pre-built scraper search and execution
  • Asynchronous scraper status and result retrieval
  • Geo, date, intent, and keyword filtering

Tools11

What Brightdata MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

17/17 checks healthy over the last 42d

What it can do

From the 11 tools this server returned when we ran it; 11 declare their own safety hints.

Makes network requests · 11Read-only tools · 11
Network at startup4 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age553 days
Maintainers7

Observed 2026-10-14 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · @brightdata/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2.7kStargazers on the source repository.
npm downloads46kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Brightdata MCP works

What brightdata-mcp MCP server does

The brightdata-mcp MCP server gives MCP-compatible AI clients access to Bright Data's web search and extraction services. Its tools cover three main workflows: finding current information, converting webpages into Markdown, and collecting structured records through Bright Data's pre-built scraper catalog.

search_engine queries Google, Bing, or Yandex and returns result fields such as URLs, titles, and descriptions in JSON or Markdown. search_engine_batch runs several queries together. discover adds AI-based relevance ranking, intent-based ranking, geographic targeting, date filters, and keyword filters to web discovery.

For page content, scrape_as_markdown handles one URL and scrape_batch handles multiple URLs. Both support advanced extraction options and return Markdown.

How it works

You can connect through Bright Data's hosted MCP endpoint or run the package locally with npx @brightdata/mcp. The hosted option uses a URL containing an API token; the local option receives the token through the API_TOKEN environment variable.

Structured extraction follows a separate sequence. First, search_scrapers finds a suitable pre-built scraper by site or data type. Then get_scraper_details returns its description, accepted fields, sample input, and primary output fields. Build the request from that information before calling run_scraper.

A scraper run accepts a list of input objects. It may return records immediately or provide a snapshot_id while the job remains in progress. Use get_scraper_progress to check states such as starting, running, ready, failed, or canceled, and use get_scraper_results when the run is ready. refresh_scrapers reloads the scraper catalog instead of waiting for its daily refresh.

Setup and configuration

The hosted endpoint is https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN. The README provides setup examples for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, and Zed. Hosted connections can optionally restrict the available tools with groups or tools URL parameters.

For a local stdio connection, configure the client to run npx @brightdata/mcp and set API_TOKEN to a Bright Data account token. Scraper runs may bill each returned record, and a run that exceeds the stated wait period can remain asynchronous.

Tools and capabilities

  • Search Google, Bing, or Yandex and return SERP data.
  • Run multiple search or page-extraction requests in a batch.
  • Extract individual webpages or URL sets as Markdown.
  • Rank web results by relevance with filters for intent, location, date, and keywords.
  • Find, inspect, run, monitor, and retrieve results from Bright Data pre-built scrapers.
  • Refresh the available scraper catalog on demand.

The repository describes the broader package as covering web search, page scraping, structured extraction, and browser automation, but the tools listed for this entry are the search, extraction, discovery, and scraper-management tools above.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Brightdata MCP

brightdata-mcp is an MCP server that connects AI agents to Bright Data's web search, page extraction, and pre-built scraper services. Its main tools search Google, Bing, and Yandex, scrape one or many URLs as Markdown, discover ranked results, and run structured scrapers with progress and result retrieval.

Run it locally with `npx @brightdata/mcp` and provide the `API_TOKEN` environment variable. You can also use Bright Data's hosted MCP endpoint with your token in the URL, which avoids a local installation.

Yes, brightdata-mcp works with Cursor. Add the hosted MCP URL to `~/.cursor/mcp.json`, including your Bright Data API token in the URL, or configure Cursor to run the local npx command with `API_TOKEN`.

First call `search_scrapers`, then use `get_scraper_details` to inspect the method and input shape. Call `run_scraper` with matching input objects; if it returns a running snapshot, check `get_scraper_progress` and retrieve completed records with `get_scraper_results`.

Yes, the listed page-scraping tools are described as able to unlock webpages affected by bot detection or CAPTCHA challenges. Use `scrape_as_markdown` for one URL or `scrape_batch` for multiple URLs, subject to Bright Data account access and usage limits.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBrightdata MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/brightdata-mcp?style=directory)](https://allmcps.com/mcp/brightdata-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/brightdata-mcp"><img src="https://allmcps.com/api/badge/brightdata-mcp?style=directory" alt="Brightdata MCP on AllMCPs" /></a>