Skip to content
Back to search

brightdata-mcp

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/brightdata/brightdata-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/brightdata/brightdata-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/brightdata--brightdata-mcp/badge.svg)](/listings/brightdata--brightdata-mcp)

HTML

<a href="/listings/brightdata--brightdata-mcp"><img src="/api/listings/brightdata--brightdata-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**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](https://brightdata.com/cp/setting/users). New accounts get 5,000 free requests per month.

Optional URL parameters:

| Parameter | Description | Example | |-----------|-------------|---------| | `groups=<ids>` | Enable specific tool groups | `...&groups=social,ecommerce` | | `tools=<names>` | Enable specific tools only | `...&tools=search_engine,scrape_as_markdown` |

<details> <summary><b>Claude Desktop</b></summary>

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>"
      }
    }
  }
}

</details>

<details> <summary><b>Claude Code</b></summary>

claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"

</details>

<details> <summary><b>Cursor</b></summary>

Add to `~/.cursor/mcp.json`:

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

</details>

<details> <summary><b>VS Code</b></summary>

Add to `.vscode/mcp.json`:

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

</details>

<details> <summary><b>Windsurf</b></summary>

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

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

</details>

<details> <summary><b>Gemini CLI</b></summary>

Add to `~/.gemini/settings.json`:

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

</details>

<details> <summary><b>Zed</b></summary>

Add to your Zed settings:

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

</details>

<details> <summary><b>Warp</b></summary>

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

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

</details>

<details> <summary><b>Other clients (local npx)</b></summary>

For any client that supports local MCP servers:

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

</details>

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 663 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <a href="https://brightdata.com/ai/mcp-server">
  3. <img src="https://github.com/user-attachments/assets/c21b3f7b-7ff1-40c3-b3d8-66706913d62f" alt="Bright Data Logo">
  4. </a>
  5. <h1>Bright Data MCP</h1>
  6. <p><strong>Web search, page scraping, structured data extraction, and browser automation for AI agents and LLMs over the Model Context Protocol.</strong></p>
  7. <p>Works with AI agents, coding agents, chat assistants, and any MCP-compatible client.</p>
  8. <p>
  9. <a href="https://www.npmjs.com/package/@brightdata/mcp"><img src="https://img.shields.io/npm/v/@brightdata/mcp?style=flat-square" alt="npm version"></a>
  10. <a href="https://www.npmjs.com/package/@brightdata/mcp"><img src="https://img.shields.io/npm/dw/@brightdata/mcp?style=flat-square" alt="npm downloads"></a>
  11. <a href="https://github.com/brightdata/brightdata-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"></a>
  12. </p>
  13. <p>
  14. <a href="#quick-start">Quick Start</a> •
  15. <a href="#pricing-and-free-tier">Pricing</a> •
  16. <a href="#use-cases">Use Cases</a> •
  17. <a href="#tools-reference-30-tools">Tools</a> •
  18. <a href="#agent-skills">Agent Skills</a> •
  19. <a href="#documentation">Docs</a> •
  20. <a href="#support">Support</a>
  21. </p>
  22. <p><strong>Free tier: 5,000 requests per month.</strong> No credit card required. Renews monthly.</p>
  23. </div>
  24. ---
  25. ## Overview
  26. The Bright Data MCP server gives AI agents real-time access to public web data. It exposes **30 tools** covering:
  27. - **Web search** — Bing and Google results as structured data
  28. - **Page scraping (Fetch API)** — any URL as Markdown, text, HTML or JSON-LD. Long pages can be read in parts
  29. - **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
  30. - **Browser automation** — navigate, click, type, screenshot, and read pages in a remote browser session
  31. - **LLM response collection** — send a prompt to ChatGPT or Perplexity and get the answer text back as Markdown
  32. Two deployment options: a hosted remote server (one URL, no installation) or a local instance via `npx @brightdata/mcp`.
  33. ---
  34. ## Quick Start
  35. **Hosted server — no installation.** Add this URL to your MCP client:
  36. ```
  37. https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
  38. ```
  39. Get your API token from your [Bright Data account settings](https://brightdata.com/cp/setting/users). New accounts get 5,000 free requests per month.
  40. Optional URL parameters:
  41. | Parameter | Description | Example |
  42. |-----------|-------------|---------|
  43. | `groups=<ids>` | Limit to specific tool groups (default: all tools) | `...&groups=scrapers,browser` |
  44. | `tools=<names>` | Limit to specific tools | `...&tools=search_engine,scrape_as_markdown` |
  45. <details>
  46. <summary><b>Claude Desktop</b></summary>
  47. 1. Go to: Settings → Connectors → Add custom connector
  48. 2. Name: `Bright Data`
  49. 3. URL: `https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN`
  50. 4. Click "Add"
  51. Or run locally:
  52. ```json
  53. {
  54. "mcpServers": {
  55. "Bright Data": {
  56. "command": "npx",
  57. "args": ["@brightdata/mcp"],
  58. "env": {
  59. "API_TOKEN": "<your-api-token-here>"
  60. }
  61. }
  62. }
  63. }
  64. ```
  65. </details>
  66. <details>
  67. <summary><b>Claude Code</b></summary>
  68. ```bash
  69. claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  70. ```
  71. </details>
  72. <details>
  73. <summary><b>Cursor</b></summary>
  74. Add to `~/.cursor/mcp.json`:
  75. ```json
  76. {
  77. "mcpServers": {
  78. "brightdata": {
  79. "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  80. }
  81. }
  82. }
  83. ```
  84. </details>
  85. <details>
  86. <summary><b>VS Code</b></summary>
  87. Add to `.vscode/mcp.json`:
  88. ```json
  89. {
  90. "servers": {
  91. "brightdata": {
  92. "type": "http",
  93. "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  94. }
  95. }
  96. }
  97. ```
  98. </details>
  99. <details>
  100. <summary><b>Windsurf</b></summary>
  101. Add to `~/.codeium/windsurf/mcp_config.json`:
  102. ```json
  103. {
  104. "mcpServers": {
  105. "brightdata": {
  106. "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  107. }
  108. }
  109. }
  110. ```
  111. </details>
  112. <details>
  113. <summary><b>Gemini CLI</b></summary>
  114. Add to `~/.gemini/settings.json`:
  115. ```json
  116. {
  117. "mcpServers": {
  118. "brightdata": {
  119. "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  120. }
  121. }
  122. }
  123. ```
  124. </details>
  125. <details>
  126. <summary><b>Zed</b></summary>
  127. Add to your Zed settings:
  128. ```json
  129. {
  130. "context_servers": {
  131. "brightdata": {
  132. "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  133. }
  134. }
  135. }
  136. ```
  137. </details>
  138. <details>
  139. <summary><b>Warp</b></summary>
  140. Go to Settings > MCP Servers > Add MCP Server and add:
  141. ```json
  142. {
  143. "brightdata": {
  144. "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  145. }
  146. }
  147. ```
  148. </details>
  149. <details>
  150. <summary><b>Other clients (local npx)</b></summary>
  151. For any client that supports local MCP servers:
  152. ```json
  153. {
  154. "mcpServers": {
  155. "Bright Data": {
  156. "command": "npx",
  157. "args": ["@brightdata/mcp"],
  158. "env": {
  159. "API_TOKEN": "<your-api-token-here>"
  160. }
  161. }
  162. }
  163. }
  164. ```
  165. </details>
  166. ---
  167. ## Pricing and Free Tier
  168. Every account includes a recurring monthly free tier. **No credit card or commitment required to start.**
  169. **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.
  170. What's included free:
  171. - Fetch any webpage and extract as Markdown
  172. - Access to 60+ pre-built scrapers for popular domains
  173. - Web search (Bing, Google)
  174. - Browser automation
  175. - Geo-targeting
  176. Beyond the free tier — pay as you go, no commitment:
  177. | | Search & Scrape | Browser Navigation |
  178. |---|---|---|
  179. | **Pay as you go** | $1.50 / 1K results | $8 / GB |
  180. - When free requests run out, requests stop. No surprise charges — unless you have deposited funds
  181. - Adding a credit card is a verification step only; you are not charged unless your free tier is exhausted **and** you have funds deposited
  182. - Set a spend cap in the [control panel](https://brightdata.com/cp) so pay-as-you-go usage never exceeds your budget
  183. [Full pricing, volume plans and enterprise →](https://brightdata.com/pricing/mcp-server)
  184. ---
  185. ## Use Cases
  186. ### Real-time research
  187. Answer questions using live web data instead of training data. Search, then read the sources.
  188. | Task | Tools |
  189. |------|-------|
  190. | Search the web for current information | `search_engine`, `search_engine_batch` |
  191. | Read a specific page as clean Markdown | `scrape_as_markdown`, `scrape_batch` |
  192. 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".
  193. ### E-commerce intelligence
  194. Read product data as structured JSON: price, availability, rating, review count, seller, images.
  195. | Task | Tools |
  196. |------|-------|
  197. | Products and search results from Amazon, Walmart, eBay, Etsy, Home Depot and other stores. Reviews from Walmart | `search_scrapers` → `get_scraper_details` → `run_scraper` |
  198. 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?".
  199. ### Market and competitor analysis
  200. Build competitor profiles from live data: funding, headcount, hiring, customer reviews, pricing pages.
  201. | Task | Tools |
  202. |------|-------|
  203. | Company funding, size, employees, job postings (Crunchbase, ZoomInfo, LinkedIn) | `search_scrapers` → `run_scraper` |
  204. | Customer sentiment (Facebook company reviews, app store reviews) | `search_scrapers` → `run_scraper` |
  205. | Competitor pricing pages | `scrape_as_markdown`, `scrape_batch` |
  206. | Market discovery | `search_engine_batch` |
  207. Example prompt: "Analyze Notion as a competitor: pricing, funding, hiring focus, and what customers complain about".
  208. ### AI agents with reliable web access
  209. Replace built-in fetch and search tools. Pages that need JavaScript or clicks go to the remote browser tools.
  210. | Task | Tools |
  211. |------|-------|
  212. | Drop-in replacement for built-in web search | `search_engine` |
  213. | Drop-in replacement for built-in URL fetch | `scrape_as_markdown` |
  214. | Parallel data collection (5 at a time) | `search_engine_batch`, `scrape_batch` |
  215. | Interactive sites (infinite scroll, dynamic content, forms) | `scraping_browser_*` (14 tools) |
  216. ### Coding agents
  217. Package registry data on demand — no scraping, no stale caches.
  218. | Task | Tools |
  219. |------|-------|
  220. | npm and PyPI package version, README, metadata | `run_scraper` with the npmjs or pypi scraper (find them with `search_scrapers`) |
  221. | Read files from GitHub repositories | `run_scraper` with the GitHub repository scraper |
  222. Example prompts: "What's the latest version of express on npm?", "Get the README for the langchain-brightdata PyPI package".
  223. ### GEO and brand visibility
  224. Send a prompt to ChatGPT or Perplexity and get the answer text back as Markdown. Each call sends one prompt.
  225. | Task | Tools |
  226. |------|-------|
  227. | Send a prompt to ChatGPT (web search off) and get the answer text as Markdown | `chatgpt_ai_insights` |
  228. | Send a prompt to Perplexity and get the answer text as Markdown | `perplexity_ai_insights` |
  229. Example prompt: "Ask ChatGPT and Perplexity 'what is the best proxy provider' and compare how each one ranks us".
  230. ### Social media monitoring
  231. 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`.
  232. | Platform | Examples of scrapers |
  233. |----------|----------------------|
  234. | LinkedIn | person profiles, company profiles, job listings, posts, people search |
  235. | Instagram | profiles, posts, reels, comments |
  236. | TikTok | profiles, posts, shop, comments |
  237. | Facebook | profiles, posts, marketplace listings, company reviews, events |
  238. | YouTube | videos, channels, comments |
  239. | X (Twitter) | posts, posts by profile |
  240. | Reddit | posts, comments |
  241. Example prompt: "Get the last 10 posts from this TikTok profile and summarize the engagement".
  242. ### Content creation and academic research
  243. Gather source material from many pages at once, filtered by recency and relevance.
  244. | Task | Tools |
  245. |------|-------|
  246. | Collect multiple sources in one call | `scrape_batch` (up to 5 URLs) |
  247. | News | `search_engine` with news queries |
  248. ---
  249. ## Tool Selection: Groups
  250. Tools are organized into groups so you only load what you need. Fewer tools means less context for your agent to process.
  251. - With no `GROUPS` or `TOOLS`, all 30 tools are enabled. Setting either one limits the server to those tools only
  252. - `GROUPS` enables tool bundles. Comma-separated: `GROUPS="scrapers,browser"` (local) or `&groups=scrapers,browser` (hosted URL)
  253. - `TOOLS` adds individual tools on top: `TOOLS="scrape_batch,session_stats"`. On its own, it enables only the tools you list
  254. - Every group also includes `search_engine`, `scrape_as_markdown` and `ask_brightdata_assistant`
  255. - Group ID `custom` is reserved; use `TOOLS` for individual picks
  256. | Group ID | Contents | Tool count |
  257. |----------|----------|-----------|
  258. | `scrapers` | Search and run any pre-built Web Scraper API scraper (Amazon, LinkedIn, TikTok, npm, ...) | 6 |
  259. | `browser` | Remote browser automation | 14 |
  260. | `geo` | ChatGPT and Perplexity response collection | 2 |
  261. | `advanced_scraping` | Batch tools, session stats | 3 |
  262. 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.
  263. ### Configuration examples
  264. Local server with browser automation and batch tools:
  265. ```json
  266. {
  267. "mcpServers": {
  268. "Bright Data": {
  269. "command": "npx",
  270. "args": ["@brightdata/mcp"],
  271. "env": {
  272. "API_TOKEN": "<your-api-token-here>",
  273. "GROUPS": "browser,advanced_scraping"
  274. }
  275. }
  276. }
  277. }
  278. ```
  279. Coding agent setup (Claude Code / Cursor / Windsurf) — npm, PyPI and GitHub data through the pre-built scrapers:
  280. ```json
  281. {
  282. "mcpServers": {
  283. "Bright Data": {
  284. "command": "npx",
  285. "args": ["@brightdata/mcp"],
  286. "env": {
  287. "API_TOKEN": "<your-api-token-here>",
  288. "GROUPS": "scrapers"
  289. }
  290. }
  291. }
  292. }
  293. ```
  294. ---
  295. ## Tools Reference (30 Tools)
  296. ### Which tool to use
  297. - **Known URL, need the content:** `scrape_as_markdown`. Multiple URLs (up to 5): `scrape_batch`
  298. - **Need to find information:** `search_engine`. Multiple queries (up to 5): `search_engine_batch`
  299. - **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`
  300. - **Raw HTML:** `scrape_as_markdown` with `format: 'html'`
  301. - **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
  302. - **Page needs JavaScript or interaction (click, type, scroll):** `scraping_browser_*` tools. The scrape tools don't render JavaScript
  303. - **How ChatGPT/Perplexity answer a prompt:** `chatgpt_ai_insights` / `perplexity_ai_insights`
  304. - **Question about Bright Data itself (products, zones, errors, setup):** `ask_brightdata_assistant`
  305. Notes on scraper runs:
  306. - Return structured JSON, billed per record returned
  307. - Records with an `error` field explain inputs that failed, e.g. a URL of the wrong type
  308. - 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
  309. - If a run fails, `scrape_as_markdown` works on the same URL as a fallback
  310. <details>
  311. <summary><b>Search and Scraping — 5 tools</b></summary>
  312. | Tool | Description | Group |
  313. |------|-------------|-------|
  314. | `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 |
  315. | `search_engine_batch` | Up to 5 search queries in one call. Searches not done within 55 s return a timeout error | default / `advanced_scraping` |
  316. | `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 |
  317. | `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` |
  318. | `session_stats` | Tool usage counts for the current session | default / `advanced_scraping` |
  319. </details>
  320. <details>
  321. <summary><b>Web Scraper API — 6 tools</b></summary>
  322. 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).
  323. 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).
  324. | Tool | Description | Group |
  325. |------|-------------|-------|
  326. | `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` |
  327. | `get_scraper_details` | Description, input fields, example input and main output fields for one scraper method | default / `scrapers` |
  328. | `run_scraper` | Run a scraper method. Waits up to 45 seconds; if still running, returns a `snapshot_id` to check later | default / `scrapers` |
  329. | `get_scraper_progress` | Status of a run: starting, running, ready, failed or canceled | default / `scrapers` |
  330. | `get_scraper_results` | Records of a finished run | default / `scrapers` |
  331. | `refresh_scrapers` | Reload the scraper list now instead of waiting for the daily refresh | default / `scrapers` |
  332. </details>
  333. <details>
  334. <summary><b>Browser Automation — 14 tools</b></summary>
  335. Remote browser session. Typical sequence: navigate → snapshot → interact by ref → extract or screenshot.
  336. | Tool | Description |
  337. |------|-------------|
  338. | `scraping_browser_navigate` | Open or reuse a browser session and navigate to a URL |
  339. | `scraping_browser_go_back` | Navigate back |
  340. | `scraping_browser_go_forward` | Navigate forward |
  341. | `scraping_browser_snapshot` | ARIA snapshot of the page listing interactive elements with refs. Required before ref-based actions |
  342. | `scraping_browser_click_ref` | Click an element by ref from the latest snapshot |
  343. | `scraping_browser_type_ref` | Type into an element by ref; optionally press Enter to submit |
  344. | `scraping_browser_fill_form` | Fill several form fields by ref in one call |
  345. | `scraping_browser_screenshot` | Screenshot of the current page; optional `full_page` |
  346. | `scraping_browser_get_text` | Text content of the page body |
  347. | `scraping_browser_get_html` | HTML of the current page |
  348. | `scraping_browser_scroll` | Scroll to the bottom of the page |
  349. | `scraping_browser_scroll_to_ref` | Scroll an element into view |
  350. | `scraping_browser_wait_for_ref` | Wait for an element to become visible, with optional timeout |
  351. | `scraping_browser_network_requests` | Network requests since page load: method, URL, status |
  352. 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.
  353. </details>
  354. <details>
  355. <summary><b>GEO and LLM Visibility — 2 tools</b></summary>
  356. | Tool | Input | Returns |
  357. |------|-------|---------|
  358. | `chatgpt_ai_insights` | Prompt | ChatGPT's answer as Markdown |
  359. | `perplexity_ai_insights` | Prompt | Perplexity's answer as Markdown |
  360. Use for Generative Engine Optimization (tracking how LLMs describe your brand) and LLM-as-a-judge workflows.
  361. </details>
  362. <details>
  363. <summary><b>Dataset Search — 2 tools</b></summary>
  364. Filter search over stored LinkedIn datasets; returns matching records at once, with no scraper run.
  365. | Tool | Description | Group |
  366. |------|-------------|-------|
  367. | `list_dataset_fields` | Filterable fields of a dataset (name, type, description). Call before `search_dataset` | default / `social`, `business` |
  368. | `search_dataset` | Records matching a filter, up to 10 per call, with a cursor for more | default / `social`, `business` |
  369. </details>
  370. <details>
  371. <summary><b>Bright Data Assistant — 1 tool</b></summary>
  372. | Tool | Description | Group |
  373. |------|-------------|-------|
  374. | `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 |
  375. </details>
  376. [Full tool reference in the docs →](https://docs.brightdata.com/ai/mcp-server/tools)
  377. ---
  378. ## Agent Skills
  379. Bright Data's agent skills teach your agent when and how to use Bright Data. They live at [github.com/brightdata/skills](https://github.com/brightdata/skills). Start with `agent-onboarding`.
  380. ---
  381. ## Configuration
  382. ### Basic setup (local)
  383. ```json
  384. {
  385. "mcpServers": {
  386. "Bright Data": {
  387. "command": "npx",
  388. "args": ["@brightdata/mcp"],
  389. "env": {
  390. "API_TOKEN": "your-token-here"
  391. }
  392. }
  393. }
  394. }
  395. ```
  396. ### Advanced configuration
  397. ```json
  398. {
  399. "mcpServers": {
  400. "Bright Data": {
  401. "command": "npx",
  402. "args": ["@brightdata/mcp"],
  403. "env": {
  404. "API_TOKEN": "your-token-here",
  405. "RATE_LIMIT": "100/1h",
  406. "SERP_ZONE": "custom_serp",
  407. "BROWSER_ZONE": "custom_browser"
  408. }
  409. }
  410. }
  411. }
  412. ```
  413. ### Environment variables
  414. | Variable | Description | Default | Example |
  415. |----------|-------------|---------|---------|
  416. | `API_TOKEN` | Your Bright Data API token (required) | - | `your-token-here` |
  417. | `RATE_LIMIT` | Custom rate limiting | unlimited | `100/1h`, `50/30m` |
  418. | `SERP_ZONE` | Custom SERP API zone name, used by the search tools | `mcp_serp` | `my_serp_zone` |
  419. | `BROWSER_ZONE` | Custom Browser zone name | `mcp_browser` | `my_browser_zone` |
  420. | `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` |
  421. | `CONTENT_GATE_TIMEOUT` | Seconds to wait for the user's answer before withholding the content | `120` | `60`, `300` |
  422. | `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` |
  423. | `BASE_TIMEOUT` | Request timeout in seconds for the search and dataset tools (search also stops at 55 s) | No limit | `60`, `120` |
  424. | `BASE_MAX_RETRIES` | Max retries for the search and dataset tools on transient errors (0-3) | `0` | `1`, `3` |
  425. | `GROUPS` | Comma-separated tool group IDs. Limits the server to these groups | All tools | `scrapers,browser` |
  426. | `TOOLS` | Comma-separated individual tool names. Limits the server to these tools | All tools | `scrape_batch,session_stats` |
  427. ### Content gate
  428. `scrape_as_markdown`, `search_engine` and their batch variants return whatever a web
  429. page says. If that content contains text that reads like instructions to change your MCP
  430. configuration — register a server, run an `npx -y` package, edit the MCP config file — the server
  431. pauses and asks you, through your MCP client, before returning it. Approve and the content is
  432. returned unchanged; decline and it is withheld with a short explanation to the assistant. Pages that
  433. do not contain such text are returned exactly as before, with no prompt. For a batch call, only the
  434. matching items are withheld.
  435. Pages that are *about* MCP configuration (documentation, READMEs) will naturally prompt. Clients that
  436. do not support MCP elicitation get the matching content withheld; set `CONTENT_GATE=off` if you
  437. accept the risk. While the server waits for your answer it reports progress; clients that do not
  438. extend their tool timeout on progress will cap the wait at their own limit — `CONTENT_GATE_TIMEOUT`
  439. is the knob on the server side. Browser tools are not covered.
  440. ---
  441. ## Documentation
  442. | Resource | Link |
  443. |----------|------|
  444. | API documentation | [docs.brightdata.com/ai/mcp-server/overview](https://docs.brightdata.com/ai/mcp-server/overview) |
  445. | Full tools reference | [docs.brightdata.com/ai/mcp-server/tools](https://docs.brightdata.com/ai/mcp-server/tools) |
  446. | Agent skills | [github.com/brightdata/skills](https://github.com/brightdata/skills) |
  447. | Usage examples | [examples](https://github.com/brightdata/brightdata-mcp/blob/main/examples) |
  448. | Changelog | [CHANGELOG.md](https://github.com/brightdata/brightdata-mcp/blob/main/CHANGELOG.md) |
  449. ---
  450. ## Troubleshooting
  451. <details>
  452. <summary><b>Common issues and solutions</b></summary>
  453. ### "spawn npx ENOENT" error
  454. Install Node.js, or use the full path to node:
  455. ```json
  456. "command": "/usr/local/bin/node" // macOS/Linux
  457. "command": "C:\\Program Files\\nodejs\\node.exe" // Windows
  458. ```
  459. ### Timeouts on complex sites
  460. Increase the timeout in your client settings to 180s.
  461. ### Authentication issues
  462. Verify your API token is valid and has the required permissions. Tokens are managed in [account settings](https://brightdata.com/cp/setting/users).
  463. ### run_scraper returns errors or no data
  464. 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.
  465. ### Remote server connection fails
  466. Check your internet connection and firewall settings.
  467. </details>
  468. ---
  469. ## Contributing
  470. - [Report bugs](https://github.com/brightdata/brightdata-mcp/issues)
  471. - [Suggest features](https://github.com/brightdata/brightdata-mcp/issues)
  472. - [Submit PRs](https://github.com/brightdata/brightdata-mcp/pulls)
  473. Please follow [Bright Data's coding standards](https://brightdata.com/dna/js_code).
  474. ---
  475. ## Support
  476. | Channel | Link |
  477. |---------|------|
  478. | GitHub issues | [github.com/brightdata/brightdata-mcp/issues](https://github.com/brightdata/brightdata-mcp/issues) |
  479. | Documentation | [docs.brightdata.com/ai/mcp-server/overview](https://docs.brightdata.com/ai/mcp-server/overview) |
  480. | Email | [support@brightdata.com](mailto:support@brightdata.com) |
  481. ---
  482. ## License
  483. MIT © [Bright Data Ltd.](https://brightdata.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.