@brightdata/mcp

<div align="center"> <a href="https://brightdata.com/ai/mcp-server"> <img src="https://github.com/user-attachments/assets/c21b3f7b-7ff1-40c3-b3d8-66706913d62f" alt="Bright Data Logo"> </a> <h1>The Web MCP</h1> <p> <strong>🌐 Give your AI real-time web superpowers</strong><br/> <i>Seamlessly connect LLMs to the live web without getting blocked</i> </p> <p> <a href="https://www.npmjs.com/package/@brightdata/mcp"> <img src="https://img.shields.io/npm/v/@brightdata/mcp?style=for-the-badge&color=blue" alt="npm version"/> </a> <a href="https://www.npmjs.com/package/@brightdata/mcp"> <img src="https://img.shields.io/npm/dw/@brightdata/mcp?style=for-the-badge&color=green" alt="npm downloads"/> </a> <a href="https://github.com/brightdata-com/brightdata-mcp/blob/main/LICENSE"> <img src="https://img.shields.io/badge/license-MIT-purple?style=for-the-badge" alt="License"/> </a> </p> <p> <a href="#-quick-start">Quick Start</a> • <a href="#-features">Features</a> • <a href="#-pricing--modes">Pricing</a> • <a href="#-demos">Demos</a> • <a href="#-documentation">Docs</a> • <a href="#-support">Support</a> </p> <div> <h3>🎉 <strong>Free Tier Available!</strong> 🎉</h3> <p><strong>5,000 requests/month FREE</strong> <br/> _{Perfect for prototyping and everyday AI workflows}</p> </div> </div> <br/> <div align="center"> <h3>🚀 <a href="https://brightdata.com/ai/mcp-server/launch-week">Launch Week - January 2026</a> 🚀</h3> <p><strong>5 Days of Major Releases!</strong></p> <table> <tr> <td align="center">📦 <a href="https://brightdata.com/ai/mcp-server/launch-week/day1">Tool Groups</a></td> <td align="center">🧙 <a href="https://brightdata.com/ai/mcp-server/launch-week/day2">Setup Wizard</a></td> <td align="center">⚡ <a href="https://brightdata.com/ai/mcp-server/launch-week/day3">Token Efficiency</a></td> <td align="center">🏢 <a href="https://brightdata.com/ai/mcp-server/launch-week/day4">Enterprise Integrations</a></td> <td align="center">📊 <a href="https://brightdata.com/ai/mcp-server/launch-week/day5">Observability</a></td> </tr> </table> </div>

---

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

<div align="center"> <table> <tr> <td align="center">✅ <strong>Works with Any LLM</strong><br/>_{Claude, GPT, Gemini, Llama}</td> <td align="center">🛡️ <strong>Never Gets Blocked</strong><br/>_{Enterprise-grade unblocking}</td> <td align="center">🚀 <strong>5,000 Free Requests</strong><br/>_Monthly</td> <td align="center">⚡ <strong>Zero Config</strong><br/>_{Works out of the box}</td> </tr> </table> </div>

---

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

<summary><b>📡 Use our hosted server - No installation needed!</b></summary>

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! ✨

<summary><b>Run locally on your machine</b></summary>

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

---

🚀 Pricing & Modes

<div align="center"> <table> <tr> <th width="33%">⚡ Rapid Mode (Free tier)</th> <th width="33%">💎 Pro Mode</th> <th width="34%">🔧 Custom Mode</th> </tr> <tr> <td align="center"> <h3>$0/month</h3> <p><strong>5,000 requests</strong></p> <hr/> <p>✅ Web Search<br/> ✅ Scraping with Web unlocker<br/> ❌ Browser Automation<br/> ❌ Web data tools</p> <br/> <code>Default Mode</code> </td> <td align="center"> <h3>Pay-as-you-go</h3> <p><strong>Everything in rapid plus 60+ tools</strong></p> <hr/> <p>✅ Browser Control<br/> ✅ Web Data APIs<br/> <br/> <br/> <br/> <code>PRO_MODE=true</code> </td> <td align="center"> <h3>Usage-based</h3> <p><strong>Pick the tools you need</strong></p> <hr/> <p>✅ Combine tool groups<br/> ✅ Add individual tools<br/> ❌ Overrides Pro eligibility</p> <br/> <code>GROUPS="browser"</code><br/> <code>TOOLS="scrape_as_html"</code> </td> </tr> </table> </div>

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

<table> <tr> <th align="left">Group ID</th> <th align="left">Description</th> <th align="left">Featured tools</th> </tr> <tr> <td><code>ecommerce</code></td> <td>Retail and marketplace datasets</td> <td><code>web_data_amazon_product</code>, <code>web_data_walmart_product</code>, <code>web_data_google_shopping</code></td> </tr> <tr> <td><code>social</code></td> <td>Social, community, and creator insights</td> <td><code>web_data_linkedin_posts</code>, <code>web_data_tiktok_posts</code>, <code>web_data_youtube_videos</code></td> </tr> <tr> <td><code>browser</code></td> <td>Bright Data Scraping Browser automation tools</td> <td><code>scraping_browser_snapshot</code>, <code>scraping_browser_click_ref</code>, <code>scraping_browser_screenshot</code></td> </tr> <tr> <td><code>finance</code></td> <td>Financial intelligence datasets</td> <td><code>web_data_yahoo_finance_business</code></td> </tr> <tr> <td><code>business</code></td> <td>Company and location intelligence datasets</td> <td><code>web_data_crunchbase_company</code>, <code>web_data_zoominfo_company_profile</code>, <code>web_data_zillow_properties_listing</code></td> </tr> <tr> <td><code>research</code></td> <td>News and developer data feeds</td> <td><code>web_data_github_repository_file</code>, <code>web_data_reuter_news</code></td> </tr> <tr> <td><code>app_stores</code></td> <td>App store data</td> <td><code>web_data_google_play_store</code>, <code>web_data_apple_app_store</code></td> </tr> <tr> <td><code>travel</code></td> <td>Travel information</td> <td><code>web_data_booking_hotel_listings</code></td> </tr> <tr> <td><code>advanced_scraping</code></td> <td>Batch and AI-assisted extraction helpers</td> <td><code>search_engine_batch</code>, <code>scrape_batch</code>, <code>extract</code></td> </tr> </table>

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

<table> <tr> <td>🔍 <b>Smart Web Search</b><br/>Google-quality results optimized for AI</td> <td>📄 <b>Clean Markdown</b><br/>AI-ready content extraction</td> </tr> <tr> <td>🌍 <b>Global Access</b><br/>Bypass geo-restrictions automatically</td> <td>🛡️ <b>Anti-Bot Protection</b><br/>Never get blocked or rate-limited</td> </tr> <tr> <td>🤖 <b>Browser Automation</b><br/>Control real browsers remotely (Pro)</td> <td>⚡ <b>Lightning Fast</b><br/>Optimized for minimal latency</td> </tr> </table>

🎯 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! 🎥

<details> <summary><b>View Demo Videos</b></summary>

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 →

</details>

---

🔧 Available Tools

⚡ Rapid Mode Tools (Default - Free)

| Tool | Description | Use Case | |------|-------------|----------| | 🔍 search_engine | Web search with AI-optimized results | Research, fact-checking, current events | | 📄 scrape_as_markdown | Convert any webpage to clean markdown | Content extraction, documentation |

💎 Pro Mode Tools (60+ Tools)

<details> <summary><b>Click to see all Pro tools</b></summary>

| Category | Tools | Description | |----------|-------|-------------| | Browser Control | scraping_browser.* | Full browser automation | | Web Data APIs | web_data_* | Structured data extraction | | E-commerce | Product scrapers | Amazon, eBay, Walmart data | | Social Media | Social scrapers | Twitter, LinkedIn, Instagram | | Maps & Local | Location tools | Google Maps, business data |

📚 View complete tool documentation →

</details>

---

🎮 Try It Now!

🧪 Online Playground

Try the Web MCP without any setup:

<div align="center"> <a href="https://brightdata.com/ai/playground-chat"> <img src="https://img.shields.io/badge/Try_on-Playground-00C7B7?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMyA3VjE3TDEyIDIyTDIxIDE3VjdMMTIgMloiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMiIvPgo8L3N2Zz4=" alt="Playground"/> </a> </div>

---

🔧 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

| Variable | Description | Default | Example | |----------|-------------|---------|---------| | API_TOKEN | Your Bright Data API token (required) | - | your-token-here | | PRO_MODE | Enable all 60+ tools | false | true | | RATE_LIMIT | Custom rate limiting | unlimited | 100/1h, 50/30m | | WEB_UNLOCKER_ZONE | Custom Web Unlocker zone name | mcp_unlocker | my_custom_zone | | BROWSER_ZONE | Custom Browser zone name | mcp_browser | my_browser_zone | | POLLING_TIMEOUT | Timeout for web_data_* tools polling (seconds) | 600 | 300, 1200 | | GROUPS | Comma-separated tool group IDs | - | ecommerce,browser | | TOOLS | Comma-separated individual tool names | - | extract,scrape_as_html |

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

<div align="center"> <table> <tr> <td align="center"> <a href="https://docs.brightdata.com/mcp-server/overview"> <img src="https://img.shields.io/badge/📖-API_Docs-blue?style=for-the-badge" alt="API Docs"/> </a> </td> <td align="center"> <a href="https://github.com/brightdata-com/brightdata-mcp/blob/main/examples"> <img src="https://img.shields.io/badge/💡-Examples-green?style=for-the-badge" alt="Examples"/> </a> </td> <td align="center"> <a href="https://github.com/brightdata-com/brightdata-mcp/blob/main/CHANGELOG.md"> <img src="https://img.shields.io/badge/📝-Changelog-orange?style=for-the-badge" alt="Changelog"/> </a> </td> <td align="center"> <a href="https://brightdata.com/blog/ai/web-scraping-with-mcp"> <img src="https://img.shields.io/badge/📚-Tutorial-purple?style=for-the-badge" alt="Tutorial"/> </a> </td> </tr> </table> </div>

---

🚨 Common Issues & Solutions

<details> <summary><b>🔧 Troubleshooting Guide</b></summary>

❌ "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 →

</details>

---

🤝 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

<div align="center"> <table> <tr> <td align="center"> <a href="https://github.com/brightdata-com/brightdata-mcp/issues"> <strong>🐛 GitHub Issues</strong><br/> _{Report bugs & features} </a> </td> <td align="center"> <a href="https://docs.brightdata.com/mcp-server/overview"> <strong>📚 Documentation</strong><br/> _{Complete guides} </a> </td> <td align="center"> <a href="mailto:support@brightdata.com"> <strong>✉️ Email</strong><br/> _{support@brightdata.com} </a> </td> </tr> </table> </div>

---

📜 License

MIT © Bright Data Ltd.

---

<div align="center"> <p> <strong>Built with ❤️ by</strong><br/> <a href="https://brightdata.com"> <img src="https://idsai.net.technion.ac.il/files/2022/01/Logo-600.png" alt="Bright Data" height="120"/> </a> </p> <p> _{The world's #1 web data platform} </p> <br/> <p> <a href="https://github.com/brightdata-com/brightdata-mcp">⭐ Star us on GitHub</a> • <a href="https://brightdata.com/blog">Read our Blog</a> </p> </div>