Bright Data MCP server

Connect Bright Data to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Bright Data MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the manage zone tool in Bright Data
  • Use the scrape synchronous tool in Bright Data
  • Use the get snapshot history tool in Bright Data
  • Use the get zone details tool in Bright Data
  • Use the get account info tool in Bright Data
  • Use the cancel scraping job tool in Bright Data

Supported Tools

manage_zone

Manage Zone

Create, enable, disable, or delete a Bright Data zone. Zones are isolated proxy/scraping configurations with their own plan, credentials, and settings. Use this tool to manage the lifecycle of zones in your account.

scrape_synchronous

Scrape Synchronous

Scrape data from websites using Bright Data's pre-built scrapers and receive results in real-time. Best for small requests (up to 20 URLs). If the request takes longer than 1 minute, a snapshot ID is returned instead for async retrieval.

get_snapshot_history

Get Snapshot History

Retrieve a page of snapshots (scraping jobs) for a specific dataset/scraper. Filter by status or creation date and page through the history with skip and limit.

get_zone_details

Get Zone Details

Get detailed information about a specific Bright Data zone, including its configuration, plan, status, and passwords. Combines zone info, status, and credential data into a single response.

get_account_info

Get Account Info

Retrieve your Bright Data account status and balance information, including customer ID, account status, whether requests can be made, current balance, and pending balance.

cancel_scraping_job

Cancel Scraping Job

Cancel a running scraping job before it finishes. Stops the data collection process for the given snapshot. Returns the cancellation status.

download_snapshot

Download Snapshot

Download the results of a completed scraping job by its snapshot ID as a file in the requested format, with structured records also returned for compatibility.

search_serp

Search SERP

Execute a search query on major search engines (Google, Bing, Yandex, DuckDuckGo) and retrieve search engine results page (SERP) data. Supports localization, pagination, device emulation, and parsed JSON output. Handles all anti-bot measures and proxy rotation automatically.

trigger_scraping_job

Trigger Scraping Job

Start an asynchronous data collection job using Bright Data's pre-built scrapers. Provide target URLs or keywords and receive a snapshot ID to track progress and download results later. Supports delivery via webhook or API download.

unlock_web_page

Unlock Web Page

Fetch the content of any web page, bypassing anti-bot protections, CAPTCHAs, and access restrictions. Uses Bright Data's Web Unlocker to automatically handle proxy rotation, JavaScript rendering, and cookie management. Returns the page content as HTML, Markdown, or raw response.

list_zones

List Zones

List all active zones in your Bright Data account. Zones are collections of proxy or scraping configurations. Each zone has a name and type (e.g., "serp", "dc", "residential").

get_scraping_job_status

Get Scraping Job Status

Check the progress and status of an asynchronous scraping job. Returns the current status (starting, running, ready, failed) along with the associated dataset ID. Use after triggering a scraping job to know when results are available for download.

list_scrapers

List Scrapers

Discover available scrapers with dataset IDs, names, domains, collection methods, input schemas, and output fields. Use the returned dataset ID with trigger_scraping_job or scrape_synchronous.

get_snapshot_log

Get Snapshot Log

Inspect a scraping job snapshot with its status, scraper and dataset names, input and record counts, duration, and collection diagnostics. Use download_snapshot to retrieve the collected records.

Connect Bright Data to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Bright Data in Metorial. In your Metorial portal, enable the Bright Data MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Bright Data tools.

Run Bright Data through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Bright Data and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Bright Data tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Bright Data

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Sentry

Track, manage, and resolve application errors and performance issues. List, query, and bulk-update issues and error events with filters like status, assignment, and tags. Create and manage releases, associate commits, and upload source maps. Configure issue alert rules and metric alert rules with notification actions. Set up cron monitors to detect missed or failed scheduled jobs. Build custom dashboards with configurable widgets. Run ad-hoc Discover queries across errors and transactions for performance analysis. Manage organizations, teams, projects, and members. Provision users via SCIM. Access session replay data.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

Technical notes for Bright Data

Scrape websites, bypass anti-bot protections, and extract structured data at scale. Unlock blocked web pages with automatic CAPTCHA solving and proxy rotation. Query search engines (Google, Bing, Yandex, DuckDuckGo) for SERP data with localization and device emulation. Run 120+ pre-built scrapers for popular platforms like Amazon, LinkedIn, and Airbnb. Crawl millions of pages simultaneously. Automate headless browsers via Puppeteer, Playwright, or Selenium with built-in anti-detection. Access pre-collected datasets from 100+ domains. Manage proxy networks across 195 countries with residential, datacenter, ISP, and mobile IPs. Configure zones and manage account settings.

Frequently asked questions

Common questions about connecting Bright Data to AI agents with Metorial.

  1. How many tools does the Bright Data MCP server have?
    The Bright Data MCP server exposes 14 tools, including Manage Zone, Scrape Synchronous, Get Snapshot History. Each one is governed and traced through Metorial.
  2. Bright Data exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Bright Data MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Bright Data and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Bright Data MCP server yourself or use the hosted gateway.

Connect Bright Data to production AI agents

See how Metorial gives your team governed access to Bright Data, with tracing and security controls built in.