Skip to main content
Glama
Bright Data MCP

Bright Data MCP

Official
by brightdata

Overview

The Bright Data MCP server gives AI agents real-time access to public web data. It exposes 30 tools covering:

  • Web search — Bing and Google results as structured data

  • Page scraping (Fetch API) — any URL as Markdown, text, HTML or JSON-LD. Long pages can be read in parts

  • Structured data (Web Scraper API) — clean JSON from 1,200+ pre-built scrapers: Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI and more, without parsing HTML. Six tools find and run any of them

  • Browser automation — navigate, click, type, screenshot, and read pages in a remote browser session

  • LLM response collection — send a prompt to ChatGPT or Perplexity and get the answer text back as Markdown

Two deployment options: a hosted remote server (one URL, no installation) or a local instance via npx @brightdata/mcp.


Related MCP server: MCP Fetch

Quick Start

Hosted server — no installation. Add this URL to your MCP client:

https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE

Get your API token from your Bright Data account settings. New accounts get 5,000 free requests per month.

Optional URL parameters:

Parameter

Description

Example

groups=<ids>

Limit to specific tool groups (default: all tools)

...&groups=scrapers,browser

tools=<names>

Limit to specific tools

...&tools=search_engine,scrape_as_markdown

  1. Go to: Settings → Connectors → Add custom connector

  2. Name: Bright Data

  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN

  4. Click "Add"

Or run locally:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}

Add to .vscode/mcp.json:

{
  "servers": {
    "brightdata": {
      "type": "http",
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brightdata": {
      "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "brightdata": {
      "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}

Add to your Zed settings:

{
  "context_servers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}

Go to Settings > MCP Servers > Add MCP Server and add:

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}

For any client that supports local MCP servers:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}

Pricing and Free Tier

Every account includes a recurring monthly free tier. No credit card or commitment required to start.

5,000 free requests per month, renewing on the 1st of each month. Unused requests don't roll over. For team accounts, the free tier is shared across all users in the account.

What's included free:

  • Fetch any webpage and extract as Markdown

  • Access to 60+ pre-built scrapers for popular domains

  • Web search (Bing, Google)

  • Browser automation

  • Geo-targeting

Beyond the free tier — pay as you go, no commitment:

Search & Scrape

Browser Navigation

Pay as you go

$1.50 / 1K results

$8 / GB

  • When free requests run out, requests stop. No surprise charges — unless you have deposited funds

  • Adding a credit card is a verification step only; you are not charged unless your free tier is exhausted and you have funds deposited

  • Set a spend cap in the control panel so pay-as-you-go usage never exceeds your budget

Full pricing, volume plans and enterprise →


Use Cases

Real-time research

Answer questions using live web data instead of training data. Search, then read the sources.

Task

Tools

Search the web for current information

search_engine, search_engine_batch

Read a specific page as clean Markdown

scrape_as_markdown, scrape_batch

Example prompts: "What's Tesla's current stock price?", "Get today's weather forecast for New York", "Find the most cited sources on EU AI regulation from the last 6 months".

E-commerce intelligence

Read product data as structured JSON: price, availability, rating, review count, seller, images.

Task

Tools

Products and search results from Amazon, Walmart, eBay, Etsy, Home Depot and other stores. Reviews from Walmart

search_scrapers → get_scraper_details → run_scraper

Example prompts: "Compare this laptop's price on Amazon vs Walmart vs eBay", "Get the rating and review count for ASIN B0D2Q9397Y", "Is this product in stock?".

Market and competitor analysis

Build competitor profiles from live data: funding, headcount, hiring, customer reviews, pricing pages.

Task

Tools

Company funding, size, employees, job postings (Crunchbase, ZoomInfo, LinkedIn)

search_scrapers → run_scraper

Customer sentiment (Facebook company reviews, app store reviews)

search_scrapers → run_scraper

Competitor pricing pages

scrape_as_markdown, scrape_batch

Market discovery

search_engine_batch

Example prompt: "Analyze Notion as a competitor: pricing, funding, hiring focus, and what customers complain about".

AI agents with reliable web access

Replace built-in fetch and search tools. Pages that need JavaScript or clicks go to the remote browser tools.

Task

Tools

Drop-in replacement for built-in web search

search_engine

Drop-in replacement for built-in URL fetch

scrape_as_markdown

Parallel data collection (5 at a time)

search_engine_batch, scrape_batch

Interactive sites (infinite scroll, dynamic content, forms)

scraping_browser_* (14 tools)

Coding agents

Package registry data on demand — no scraping, no stale caches.

Task

Tools

npm and PyPI package version, README, metadata

run_scraper with the npmjs or pypi scraper (find them with search_scrapers)

Read files from GitHub repositories

run_scraper with the GitHub repository scraper

Example prompts: "What's the latest version of express on npm?", "Get the README for the langchain-brightdata PyPI package".

GEO and brand visibility

Send a prompt to ChatGPT or Perplexity and get the answer text back as Markdown. Each call sends one prompt.

Task

Tools

Send a prompt to ChatGPT (web search off) and get the answer text as Markdown

chatgpt_ai_insights

Send a prompt to Perplexity and get the answer text as Markdown

perplexity_ai_insights

Example prompt: "Ask ChatGPT and Perplexity 'what is the best proxy provider' and compare how each one ranks us".

Social media monitoring

Structured data from every major platform: profiles, posts, comments, engagement metrics. Each platform has scrapers per data type (LinkedIn profiles, Instagram reels, TikTok comments, ...); find them with search_scrapers and run them with run_scraper.

Platform

Examples of scrapers

LinkedIn

person profiles, company profiles, job listings, posts, people search

Instagram

profiles, posts, reels, comments

TikTok

profiles, posts, shop, comments

Facebook

profiles, posts, marketplace listings, company reviews, events

YouTube

videos, channels, comments

X (Twitter)

posts, posts by profile

Reddit

posts, comments

Example prompt: "Get the last 10 posts from this TikTok profile and summarize the engagement".

Content creation and academic research

Gather source material from many pages at once, filtered by recency and relevance.

Task

Tools

Collect multiple sources in one call

scrape_batch (up to 5 URLs)

News

search_engine with news queries


Tool Selection: Groups

Tools are organized into groups so you only load what you need. Fewer tools means less context for your agent to process.

  • With no GROUPS or TOOLS, all 30 tools are enabled. Setting either one limits the server to those tools only

  • GROUPS enables tool bundles. Comma-separated: GROUPS="scrapers,browser" (local) or &groups=scrapers,browser (hosted URL)

  • TOOLS adds individual tools on top: TOOLS="scrape_batch,session_stats". On its own, it enables only the tools you list

  • Every group also includes search_engine, scrape_as_markdown and ask_brightdata_assistant

  • Group ID custom is reserved; use TOOLS for individual picks

Group ID

Contents

Tool count

scrapers

Search and run any pre-built Web Scraper API scraper (Amazon, LinkedIn, TikTok, npm, ...)

6

browser

Remote browser automation

14

geo

ChatGPT and Perplexity response collection

2

advanced_scraping

Batch tools, session stats

3

Older group IDs (ecommerce, social, business, finance, research, app_stores, travel, code) still work and enable the scrapers tools; social and business also add search_dataset and list_dataset_fields. Old web_data_* names in TOOLS enable the scrapers tools too.

Configuration examples

Local server with browser automation and batch tools:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "browser,advanced_scraping"
      }
    }
  }
}

Coding agent setup (Claude Code / Cursor / Windsurf) — npm, PyPI and GitHub data through the pre-built scrapers:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "scrapers"
      }
    }
  }
}

Tools Reference (30 Tools)

Which tool to use

  • Known URL, need the content: scrape_as_markdown. Multiple URLs (up to 5): scrape_batch

  • Need to find information: search_engine. Multiple queries (up to 5): search_engine_batch

  • Structured data from a known platform (Amazon, LinkedIn, TikTok, npm, PyPI, etc.): search_scrapers → get_scraper_details → run_scraper. Returns JSON records. If the run takes longer than 45 seconds, run_scraper returns a snapshot_id: check it with get_scraper_progress, then read the records with get_scraper_results

  • Raw HTML: scrape_as_markdown with format: 'html'

  • Page cut at 40,000 characters: call scrape_as_markdown again with snapshot_id and start from the result's next field. The rest is read from the saved page at no extra cost

  • Page needs JavaScript or interaction (click, type, scroll): scraping_browser_* tools. The scrape tools don't render JavaScript

  • How ChatGPT/Perplexity answer a prompt: chatgpt_ai_insights / perplexity_ai_insights

  • Question about Bright Data itself (products, zones, errors, setup): ask_brightdata_assistant

Notes on scraper runs:

  • Return structured JSON, billed per record returned

  • Records with an error field explain inputs that failed, e.g. a URL of the wrong type

  • Results can be large. Keep limit_per_input low for discover_by_* methods and run bulk collection in a subagent where your framework supports it, so records don't flood the main context window

  • If a run fails, scrape_as_markdown works on the same URL as a fallback

Tool

Description

Group

search_engine

Search Bing (default) or Google. Returns JSON (link, title, description), 10 results per page. Params: country, page (from 0), time_range (hour, day, week, month, year, any; Bing supports only day, week, year). Times out after 55 s

default / every group

search_engine_batch

Up to 5 search queries in one call. Searches not done within 55 s return a timeout error

default / advanced_scraping

scrape_as_markdown

Any URL. Returns the content as markdown (default), text, html or ld_json. No JavaScript rendering. Pages over 40,000 characters are cut; to read the rest at no extra cost, call again with snapshot_id and start from the result's next field

default / every group

scrape_batch

Up to 5 URLs in one call. Returns the content as markdown (default), text, html or ld_json. 40,000 characters in total, shared between pages; each cut page has a next for scrape_as_markdown

default / advanced_scraping

session_stats

Tool usage counts for the current session

default / advanced_scraping

Search and run any of Bright Data's 1,200+ pre-built scrapers. The scraper list is loaded from docs.brightdata.com/scrapers.json and refreshed daily. Available on both the hosted and the local server. Enabled by default when no tools or groups are selected; otherwise add the scrapers group (&groups=scrapers on the hosted URL, GROUPS=scrapers locally).

Typical flow: search_scrapers → get_scraper_details → run_scraper. Runs are billed per record; discover_by_* methods collect up to limit_per_input records per input (default 10).

Tool

Description

Group

search_scrapers

Find scrapers by site or data type (e.g. "amazon reviews", "linkedin.com"). Returns dataset ID, name, domain and collection methods

default / scrapers

get_scraper_details

Description, input fields, example input and main output fields for one scraper method

default / scrapers

run_scraper

Run a scraper method. Waits up to 45 seconds; if still running, returns a snapshot_id to check later

default / scrapers

get_scraper_progress

Status of a run: starting, running, ready, failed or canceled

default / scrapers

get_scraper_results

Records of a finished run

default / scrapers

refresh_scrapers

Reload the scraper list now instead of waiting for the daily refresh

default / scrapers

Remote browser session. Typical sequence: navigate → snapshot → interact by ref → extract or screenshot.

Tool

Description

scraping_browser_navigate

Open or reuse a browser session and navigate to a URL

scraping_browser_go_back

Navigate back

scraping_browser_go_forward

Navigate forward

scraping_browser_snapshot

ARIA snapshot of the page listing interactive elements with refs. Required before ref-based actions

scraping_browser_click_ref

Click an element by ref from the latest snapshot

scraping_browser_type_ref

Type into an element by ref; optionally press Enter to submit

scraping_browser_fill_form

Fill several form fields by ref in one call

scraping_browser_screenshot

Screenshot of the current page; optional full_page

scraping_browser_get_text

Text content of the page body

scraping_browser_get_html

HTML of the current page

scraping_browser_scroll

Scroll to the bottom of the page

scraping_browser_scroll_to_ref

Scroll an element into view

scraping_browser_wait_for_ref

Wait for an element to become visible, with optional timeout

scraping_browser_network_requests

Network requests since page load: method, URL, status

Refs come from the latest snapshot. If the page changes after a click or navigation, take a new snapshot before the next ref-based action. For static pages, scrape_as_markdown is faster and cheaper than a browser session.

Tool

Input

Returns

chatgpt_ai_insights

Prompt

ChatGPT's answer as Markdown

perplexity_ai_insights

Prompt

Perplexity's answer as Markdown

Use for Generative Engine Optimization (tracking how LLMs describe your brand) and LLM-as-a-judge workflows.

Filter search over stored LinkedIn datasets; returns matching records at once, with no scraper run.

Tool

Description

Group

list_dataset_fields

Filterable fields of a dataset (name, type, description). Call before search_dataset

default / social, business

search_dataset

Records matching a filter, up to 10 per call, with a cursor for more

default / social, business

Tool

Description

Group

ask_brightdata_assistant

Ask Sophie, Bright Data's support assistant, about products, APIs, zones, errors or account setup. Pass the returned dialog_id to ask a follow-up in the same thread

default / every group

Full tool reference in the docs →


Agent Skills

Bright Data's agent skills teach your agent when and how to use Bright Data. They live at github.com/brightdata/skills. Start with agent-onboarding.


Configuration

Basic setup (local)

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here"
      }
    }
  }
}

Advanced configuration

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here",
        "RATE_LIMIT": "100/1h",
        "SERP_ZONE": "custom_serp",
        "BROWSER_ZONE": "custom_browser"
      }
    }
  }
}

Environment variables

Variable

Description

Default

Example

API_TOKEN

Your Bright Data API token (required)

-

your-token-here

RATE_LIMIT

Custom rate limiting

unlimited

100/1h, 50/30m

SERP_ZONE

Custom SERP API zone name, used by the search tools

mcp_serp

my_serp_zone

BROWSER_ZONE

Custom Browser zone name

mcp_browser

my_browser_zone

CONTENT_GATE

When page content returned by a data tool looks like instructions to change the MCP configuration, the server asks the user (via MCP elicitation) before returning it. Set to off to disable

on

off

CONTENT_GATE_TIMEOUT

Seconds to wait for the user's answer before withholding the content

120

60, 300

BROWSER_FILTERED_SNAPSHOT

scraping_browser_snapshot always lists only buttons, links and fields. Saves tokens, and stops page text posing as a clickable element (for sensitive tasks). If necessary, Page text can then be read with scraping_browser_get_text

off

on

BASE_TIMEOUT

Request timeout in seconds for the search and dataset tools (search also stops at 55 s)

No limit

60, 120

BASE_MAX_RETRIES

Max retries for the search and dataset tools on transient errors (0-3)

0

1, 3

GROUPS

Comma-separated tool group IDs. Limits the server to these groups

All tools

scrapers,browser

TOOLS

Comma-separated individual tool names. Limits the server to these tools

All tools

scrape_batch,session_stats

Content gate

scrape_as_markdown, search_engine and their batch variants return whatever a web page says. If that content contains text that reads like instructions to change your MCP configuration — register a server, run an npx -y package, edit the MCP config file — the server pauses and asks you, through your MCP client, before returning it. Approve and the content is returned unchanged; decline and it is withheld with a short explanation to the assistant. Pages that do not contain such text are returned exactly as before, with no prompt. For a batch call, only the matching items are withheld.

Pages that are about MCP configuration (documentation, READMEs) will naturally prompt. Clients that do not support MCP elicitation get the matching content withheld; set CONTENT_GATE=off if you accept the risk. While the server waits for your answer it reports progress; clients that do not extend their tool timeout on progress will cap the wait at their own limit — CONTENT_GATE_TIMEOUT is the knob on the server side. Browser tools are not covered.


Documentation


Troubleshooting

"spawn npx ENOENT" error

Install Node.js, or use the full path to node:

"command": "/usr/local/bin/node"  // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe"  // Windows

Timeouts on complex sites

Increase the timeout in your client settings to 180s.

Authentication issues

Verify your API token is valid and has the required permissions. Tokens are managed in account settings.

run_scraper returns errors or no data

Records with an error field explain inputs that failed. Compare your input with sample_input from get_scraper_details (e.g., Amazon product URLs contain /dp/, Walmart ones /ip/) and check the page is publicly accessible. scrape_as_markdown works on the same URL as a fallback.

Remote server connection fails

Check your internet connection and firewall settings.


Contributing

Please follow Bright Data's coding standards.


Support


License

MIT © Bright Data Ltd.

Available Tools

30 tools
ask_brightdata_assistantA
Read-only

Ask Bright Data's support assistant (Sophie) a question about Bright Data products, APIs, MCP usage, zones, scraping, or account setup. Use when the user asks "how do I..." about Bright Data, when you hit a Bright Data error you don't recognize, or when deciding between products (Web Unlocker vs. Scraping Browser vs. dataset tools). Supports threaded follow-ups via dialog_id.

Inputs: question (required), dialog_id.

chatgpt_ai_insightsB

Send a prompt to ChatGPT and get back AI-generated insights. Returns structured answer text, citations, recommendations, and markdown. Useful for GEO and LLM as a judge.

Inputs: prompt (required).

get_scraper_detailsA
Read-only

Show the scraper description, input fields, example input and main output fields for one method. Call before run_scraper and build the input from sample_input or input_fields. Records may contain more fields than output_fields lists.

Inputs: method (required), dataset_id (required).

get_scraper_progressB
Read-only

Status of a run: starting, running, ready, failed or canceled.

Inputs: snapshot_id (required).

get_scraper_resultsC
Read-only

Records of a finished run. Returns status "running" if not ready yet.

Inputs: snapshot_id (required).

list_dataset_fieldsA
Read-only

List the filterable fields of a searchable dataset (field name, type, and description). Call this before search_dataset to learn which field names and types you can filter on. Supported dataset_id values:

  • gd_l1viktl72bvl7bjuj0: LinkedIn people profiles

  • gd_me5ppxjr2ge6icjuh0: LinkedIn people profiles (contact-enriched)

  • gd_l1vikfnt1wgvvqz95w: LinkedIn company information

Inputs: dataset_id (required).

perplexity_ai_insightsB

Send a prompt to Perplexity and get back AI-generated insights. Returns structured answer text in markdown format. Useful for GEO and LLM as a judge.

Inputs: prompt (required).

refresh_scrapersA
Read-only

Reload the scraper list now instead of waiting for the daily refresh.

Inputs: no named parameters.

run_scraperA

Run a scraper method. input is a list of objects shaped like sample_input from get_scraper_details, one per URL or query. collect_by_url returns one record per input; discover_by_* methods return up to limit_per_input records per input, and every record is billed. Waits up to 45 seconds; if still running it returns snapshot_id with status "running": then poll get_scraper_progress and call get_scraper_results when ready. Records with an "error" field explain failed inputs.

Inputs: input (required), method (required), dataset_id (required), limit_per_input.

scrape_as_markdownA
Read-only

Fetch one web page. Returns JSON: url, format, content, plus title and note when present. content is the page in one format, markdown by default. Pick another with the format param:

  • text: plain text, no links or headings

  • html: raw HTML, for CSS selectors or data hidden in the markup

  • ld_json: schema.org data (price, rating, author...) If the page has no data in that format, markdown is returned instead, with a note. No JavaScript rendering. Pages that take longer than 45 s time out. Pages over 40,000 characters are cut. To read the rest for free, call again with the snapshot_id and start values from the result's next field.

Inputs: url (required), start, format, snapshot_id.

scrape_batchA
Read-only

Fetch up to 5 web pages at once. Returns a JSON array in input order, one item per URL: url, format, content, plus title and note when present; or url and error if that page failed. content is the page in one format, markdown by default. Pick another with the format param:

  • text: plain text, no links or headings

  • html: raw HTML, for CSS selectors or data hidden in the markup

  • ld_json: schema.org data (price, rating, author...) If a page has no data in that format, markdown is returned instead, with a note. No JavaScript rendering. Pages that take longer than 35 s time out (45 s when only one URL is sent). The whole result is cut at 40,000 characters, shared between pages. To read the rest of a cut page for free, call scrape_as_markdown with its url and the snapshot_id and start values from that item's next field.

Inputs: urls (required), format.

scraping_browser_click_refA
Destructive

Click on an element using its ref from the ARIA snapshot. Use scraping_browser_snapshot first to get the correct ref values. This is more reliable than CSS selectors.

Inputs: ref (required), element (required).

scraping_browser_fill_formA
Destructive

Fill multiple form fields in one operation. Use scraping_browser_snapshot first to get the correct ref values. This is more efficient than filling fields one by one.

Inputs: fields (required).

scraping_browser_get_htmlB
Read-only

Get the HTML content of the current page. Avoid using this tool and if used, use full_page option unless it is important to see things like script tags since this can be large

Inputs: full_page.

scraping_browser_get_textB
Read-only

Get the text content of the current page

Inputs: no named parameters.

scraping_browser_go_backB
Read-only

Go back to the previous page

Inputs: no named parameters.

scraping_browser_go_forwardB
Read-only

Go forward to the next page

Inputs: no named parameters.

scraping_browser_navigateC
Read-only

Navigate a scraping browser session to a new URL

Inputs: url (required), country.

scraping_browser_network_requestsA
Read-only

Get all network requests made since loading the current page. Shows HTTP method, URL, status code and status text for each request. Useful for debugging API calls, tracking data fetching, and understanding page behavior.

Inputs: no named parameters.

scraping_browser_screenshotA
Read-only

Take a screenshot of the current page. Set full_page to capture the whole scrollable page.

Inputs: full_page.

scraping_browser_scrollB
Read-only

Scroll to the bottom of the current page

Inputs: no named parameters.

scraping_browser_scroll_to_refA
Read-only

Scroll to a specific element using its ref from the ARIA snapshot. Use scraping_browser_snapshot first to get the correct ref values. This is more reliable than CSS selectors.

Inputs: ref (required), element (required).

scraping_browser_snapshotA
Read-only

Capture an ARIA snapshot of the current page showing all interactive elements with their refs. This provides accurate element references that can be used with ref-based tools. Use this before interacting with elements to get proper refs instead of guessing selectors. A filtered snapshot does not include page text; If necessary, call scraping_browser_get_text to read it.

Inputs: filtered.

scraping_browser_type_refA
Destructive

Type text into an element using its ref from the ARIA snapshot. Use scraping_browser_snapshot first to get the correct ref values. This is more reliable than CSS selectors.

Inputs: ref (required), text (required), element (required), submit.

scraping_browser_wait_for_refA
Read-only

Wait for an element to be visible using its ref from the ARIA snapshot. Use scraping_browser_snapshot first to get the correct ref values. This is more reliable than CSS selectors.

Inputs: ref (required), element (required), timeout.

search_datasetA
Read-only

Search a Bright Data dataset by a filter and get matching records back directly (fast Elasticsearch-backed search; no snapshot). Use this to FIND MANY records by criteria, as opposed to run_scraper which collects fresh records by URL. First call list_dataset_fields to get valid field names. A filter is a tree: a group {operator:"and"|"or", filters:[...]} or a leaf {name, value, operator}. Max nesting depth 3. Leaf operators: =, !=, <, <=, >, >=, in, not_in, includes, not_includes, array_includes, not_array_includes, is_null, is_not_null. Supported dataset_id values:

  • gd_l1viktl72bvl7bjuj0: LinkedIn people profiles

  • gd_me5ppxjr2ge6icjuh0: LinkedIn people profiles (contact-enriched)

  • gd_l1vikfnt1wgvvqz95w: LinkedIn company information

Inputs: filter (required), dataset_id (required), size, sort, +1 more.

search_engineA
Read-only

Search Bing (default) or Google. Returns JSON: organic results with link, title and description. Searches not done within 55 s return a timeout error.

Inputs: query (required), page, engine, country, +1 more.

search_engine_batchA
Read-only

Run up to 5 searches at once, on Bing (default) or Google. Returns a JSON array in input order: query, engine, and result (organic link, title, description) or error. Searches not done within 55 s return a timeout error.

Inputs: queries (required).

search_scrapersA
Read-only

Find a Bright Data pre-built scraper (Web Scraper API, 1,200+ sites) for a site or data type, e.g. "amazon reviews" or "linkedin.com". Returns dataset_id, name, domain and collection_methods. Next: call get_scraper_details with a dataset_id and one method.

Inputs: query (required), limit.

session_statsC
Read-only

Tell the user about the tool usage during this session

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 30 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, especially within the browser automation and dataset/scraper groups. There is some overlap between static page scraping tools and browser-based scraping tools, but descriptions generally clarify when to use each.

    Naming Consistency4/5

    The server mostly uses snake_case and a predictable verb_noun pattern, with a consistent scraping_browser_ prefix for browser tools. Minor deviations include noun-style names like session_stats and provider-prefixed names like chatgpt_ai_insights, but overall naming remains readable and coherent.

    Tool Count2/5

    With 30 tools, the surface is large for an MCP server and likely overwhelming for agents despite covering several Bright Data subproducts. The browser automation category alone accounts for many granular tools, pushing the total well beyond a well-scoped set.

    Completeness4/5

    The surface covers the main Bright Data workflows: static scraping, browser automation, search, dataset lookup, scraper lifecycle, AI insights, and support. Minor gaps exist, such as no explicit browser-session close/reset or scraper cancel operation, but core workflows are well represented.

    Maintenance

    ActivityActive
    ResponsivenessMostly unanswered

    Related MCP Connectors

    Related MCP Servers