Repository avatar
AI Tools
v2.7.0
active

brightdata-mcp

io.github.brightdata/brightdata-mcp

Bright Data's Web MCP server enabling AI agents to search, extract & navigate the web

Documentation

Bright Data Logo

The Web MCP

๐ŸŒ Give your AI real-time web superpowers
Seamlessly connect LLMs to the live web without getting blocked

npm version npm downloads License

Quick Start โ€ข Features โ€ข Pricing โ€ข Demos โ€ข Docs โ€ข Support

๐ŸŽ‰ Free Tier Available! ๐ŸŽ‰

5,000 requests/month FREE
Perfect for prototyping and everyday AI workflows


๐Ÿš€ Launch Week - January 2026 ๐Ÿš€

5 Days of Major Releases!

๐Ÿ“ฆ Tool Groups๐Ÿง™ Setup Wizardโšก Token Efficiency๐Ÿข Enterprise Integrations๐Ÿ“Š Observability

๐ŸŒŸ Overview

The Web MCP is your gateway to giving AI assistants true web capabilities. No more outdated responses, no more "I can't access real-time information" - just seamless, reliable web access that actually works.

Built by Bright Data, the world's #1 web data platform, this MCP server ensures your AI never gets blocked, rate-limited, or served CAPTCHAs.

โœ… Works with Any LLM
Claude, GPT, Gemini, Llama
๐Ÿ›ก๏ธ Never Gets Blocked
Enterprise-grade unblocking
๐Ÿš€ 5,000 Free Requests
Monthly
โšก Zero Config
Works out of the box

๐ŸŽฏ Perfect For

  • ๐Ÿ” Real-time Research - Get current prices, news, and live data
  • ๐Ÿ›๏ธ E-commerce Intelligence - Monitor products, prices, and availability
  • ๐Ÿ“Š Market Analysis - Track competitors and industry trends
  • ๐Ÿค– AI Agents - Build agents that can actually browse the web
  • ๐Ÿ“ Content Creation - Access up-to-date information for writing
  • ๐ŸŽ“ Academic Research - Gather data from multiple sources efficiently

โšก Quick Start

Use the configuration wizard:

GIF for day2

๐Ÿ“ก Use our hosted server - No installation needed!

Perfect for users who want zero setup. Just add this URL to your MCP client:

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

Setup in Claude Desktop:

  1. Go to: Settings โ†’ Connectors โ†’ Add custom connector
  2. Name: Bright Data Web
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. Click "Add" and you're done! โœจ
Run locally on your machine
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}

๐Ÿš€ Pricing & Modes

โšก Rapid Mode (Free tier)๐Ÿ’Ž Pro Mode๐Ÿ”ง Custom Mode

$0/month

5,000 requests


โœ… Web Search
โœ… Scraping with Web unlocker
โŒ Browser Automation
โŒ Web data tools


Default Mode

Pay-as-you-go

Everything in rapid plus 60+ tools


โœ… Browser Control
โœ… Web Data APIs



PRO_MODE=true

Usage-based

Pick the tools you need


โœ… Combine tool groups
โœ… Add individual tools
โŒ Overrides Pro eligibility


GROUPS="browser"
TOOLS="scrape_as_html"

๐Ÿ’ก Note: Pro mode is not included in the free tier and incurs additional charges based on usage.


๐Ÿง  Advanced Tool Selection

  • GROUPS lets you enable curated tool bundles. Use comma-separated group IDs such as ecommerce,browser.
  • TOOLS adds explicit tool names on top of the selected groups.
  • Mode priority: PRO_MODE=true (all tools) โ†’ GROUPS / TOOLS (whitelist) โ†’ default rapid mode (base toolkit).
  • Base tools always enabled: search_engine, search_engine_batch, scrape_as_markdown, scrape_batch.
  • Group ID custom is reserved; use TOOLS for bespoke picks.
Group IDDescriptionFeatured tools
ecommerceRetail and marketplace datasetsweb_data_amazon_product, web_data_walmart_product, web_data_google_shopping
socialSocial, community, and creator insightsweb_data_linkedin_posts, web_data_tiktok_posts, web_data_youtube_videos
browserBright Data Scraping Browser automation toolsscraping_browser_snapshot, scraping_browser_click_ref, scraping_browser_screenshot
financeFinancial intelligence datasetsweb_data_yahoo_finance_business
businessCompany and location intelligence datasetsweb_data_crunchbase_company, web_data_zoominfo_company_profile, web_data_zillow_properties_listing
researchNews and developer data feedsweb_data_github_repository_file, web_data_reuter_news
app_storesApp store dataweb_data_google_play_store, web_data_apple_app_store
travelTravel informationweb_data_booking_hotel_listings
advanced_scrapingBatch and AI-assisted extraction helperssearch_engine_batch, scrape_batch, extract

Claude Desktop example

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

โœจ Features

๐Ÿ”ฅ Core Capabilities

๐Ÿ” Smart Web Search
Google-quality results optimized for AI
๐Ÿ“„ Clean Markdown
AI-ready content extraction
๐ŸŒ Global Access
Bypass geo-restrictions automatically
๐Ÿ›ก๏ธ Anti-Bot Protection
Never get blocked or rate-limited
๐Ÿค– Browser Automation
Control real browsers remotely (Pro)
โšก Lightning Fast
Optimized for minimal latency

๐ŸŽฏ Example Queries That Just Work

โœ… "What's Tesla's current stock price?"
โœ… "Find the best-rated restaurants in Tokyo right now"
โœ… "Get today's weather forecast for New York"
โœ… "What movies are releasing this week?"
โœ… "What are the trending topics on Twitter today?"

๐ŸŽฌ Demos

Note: These videos show earlier versions. New demos coming soon! ๐ŸŽฅ

View Demo Videos

Basic Web Search Demo

https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33

Advanced Scraping Demo

https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d

๐Ÿ“บ More tutorials on YouTube โ†’


๐Ÿ”ง Available Tools

โšก Rapid Mode Tools (Default - Free)

ToolDescriptionUse Case
๐Ÿ” search_engineWeb search with AI-optimized resultsResearch, fact-checking, current events
๐Ÿ“„ scrape_as_markdownConvert any webpage to clean markdownContent extraction, documentation

๐Ÿ’Ž Pro Mode Tools (60+ Tools)

Click to see all Pro tools
CategoryToolsDescription
Browser Controlscraping_browser.*Full browser automation
Web Data APIsweb_data_*Structured data extraction
E-commerceProduct scrapersAmazon, eBay, Walmart data
Social MediaSocial scrapersTwitter, LinkedIn, Instagram
Maps & LocalLocation toolsGoogle Maps, business data

๐Ÿ“š View complete tool documentation โ†’


๐ŸŽฎ Try It Now!

๐Ÿงช Online Playground

Try the Web MCP without any setup:


๐Ÿ”ง Configuration

Basic Setup

{
  "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",
        "PRO_MODE": "true",              // Enable all 60+ tools
        "RATE_LIMIT": "100/1h",          // Custom rate limiting
        "WEB_UNLOCKER_ZONE": "custom",   // Custom unlocker zone
        "BROWSER_ZONE": "custom_browser" // Custom browser zone
      }
    }
  }
}

๐Ÿ“š Documentation


๐Ÿšจ Common Issues & Solutions

๐Ÿ”ง Troubleshooting Guide

โŒ "spawn npx ENOENT" Error

Solution: 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

Solution: Increase timeout in your client settings to 180s

๐Ÿ”‘ Authentication Issues

Solution: Ensure your API token is valid and has proper permissions

๐Ÿ“ก Remote Server Connection

Solution: Check your internet connection and firewall settings

More troubleshooting โ†’


๐Ÿค Contributing

We love contributions! Here's how you can help:

Please follow Bright Data's coding standards.


๐Ÿ“ž Support


๐Ÿ“œ License

MIT ยฉ Bright Data Ltd.


Built with โค๏ธ by
Bright Data

The world's #1 web data platform


โญ Star us on GitHub โ€ข Read our Blog