Brightdata Mcp

---

🌟 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.

---

🎯 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
• 💻 Coding Agents - Look up npm/PyPI packages, versions, and READMEs in real time
• 🧠 GEO & Brand Visibility - See how ChatGPT, Grok, and Perplexity perceive your brand
• 📝 Content Creation - Access up-to-date information for writing
• 🎓 Academic Research - Gather data from multiple sources efficiently

---

⚡ Quick Start

Use the configuration wizard:

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

---

🚀 Pricing & Modes

💡 How the free tier works: Your account gets 5,000 credits/month

(~$7.50 value), auto-renewed on the 1st with no credit card required.

MCP requests draw from this shared pool — base tools (search_engine,

scrape_as_markdown, discover) cost 1 credit per request, while

web_data_* tools cost 1 credit per record returned. Unused credits

don't roll over, and when they run out requests stop (no surprise

charges unless you've deposited funds). 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, discover.

• Group ID custom is reserved; use TOOLS for bespoke picks.

Group ID

Description

Featured tools

ecommerce

Retail and marketplace datasets

web_data_amazon_product,

web_data_walmart_product,

web_data_google_shopping

social

Social, community, and creator insights

web_data_linkedin_posts,

web_data_tiktok_posts,

web_data_youtube_videos

browser

Bright Data Scraping Browser automation tools

scraping_browser_snapshot,

scraping_browser_click_ref,

scraping_browser_screenshot

finance

Financial intelligence datasets

web_data_yahoo_finance_business

business

Company and location intelligence datasets

web_data_crunchbase_company,

web_data_zoominfo_company_profile,

web_data_zillow_properties_listing

research

News and developer data feeds

web_data_github_repository_file,

web_data_reuter_news

app_stores

App store data

web_data_google_play_store,

web_data_apple_app_store

travel

Travel information

web_data_booking_hotel_listings

geo

GEO & LLM brand visibility

web_data_chatgpt_ai_insights,

web_data_grok_ai_insights,

web_data_perplexity_ai_insights

code

Package intelligence for coding agents

web_data_npm_package,

web_data_pypi_package

advanced_scraping

Batch and AI-assisted extraction helpers

search_engine_batch,

scrape_batch,

extract

Claude Desktop example

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "",
        "GROUPS": "browser,advanced_scraping",
        "TOOLS": "extract"
      }
    }
  }
}

Coding agent example (Claude Code / Cursor / Windsurf)

Give your coding agent real-time package intelligence — latest versions, READMEs,

dependencies, and metadata from npm and PyPI without scraping:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "",
        "GROUPS": "code"
      }
    }
  }
}

---

✨ Features

🔥 Core Capabilities

🔍 Smart Web SearchGoogle-quality results optimized for AI

📄 Clean MarkdownAI-ready content extraction

🌍 Global AccessBypass geo-restrictions automatically

🛡️ Anti-Bot ProtectionNever get blocked or rate-limited

🤖 Browser AutomationControl real browsers remotely (Pro)

⚡ Lightning FastOptimized 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?"
✅ "What's the latest version of express on npm?"
✅ "Get the README for the langchain-brightdata PyPI package"

---

🎬 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)

💎 Pro Mode Tools (60+ Tools)

Click to see all Pro tools

📚 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
        "POLLING_TIMEOUT": "600"         // Polling timeout in seconds (default: 600)
      }
    }
  }
}

Environment Variables

Notes:

• POLLING_TIMEOUT controls how long web_data_* tools wait for results. Each second = 1 polling attempt.
• Lower values (e.g., 300) will fail faster on slow data collections.
• Higher values (e.g., 1200) allow more time for complex scraping tasks.

---

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

• 🐛 Report bugs
• 💡 Suggest features
• 🔧 Submit PRs
• ⭐ Star this repo!

Please follow Bright Data's coding standards.

---

📞 Support

---

📜 License

MIT © Bright Data Ltd.

---