The Web MCP 🌐 Give your AI real-time web superpowers Seamlessly connect LLMs to the live web without getting blocked Quick Start • Features • 🎉 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
Add this skill
npx mdskills install luminati-io/brightdata-mcpEnterprise-grade web data access with 60+ tools, excellent docs, free tier, and clear pricing tiers
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>56 <h1>The Web MCP</h1>78 <p>9 <strong>🌐 Give your AI real-time web superpowers</strong><br/>10 <i>Seamlessly connect LLMs to the live web without getting blocked</i>11 </p>1213 <p>14 <a href="https://www.npmjs.com/package/@brightdata/mcp">15 <img src="https://img.shields.io/npm/v/@brightdata/mcp?style=for-the-badge&color=blue" alt="npm version"/>16 </a>17 <a href="https://www.npmjs.com/package/@brightdata/mcp">18 <img src="https://img.shields.io/npm/dw/@brightdata/mcp?style=for-the-badge&color=green" alt="npm downloads"/>19 </a>20 <a href="https://github.com/brightdata-com/brightdata-mcp/blob/main/LICENSE">21 <img src="https://img.shields.io/badge/license-MIT-purple?style=for-the-badge" alt="License"/>22 </a>23 </p>2425 <p>26 <a href="#-quick-start">Quick Start</a> •27 <a href="#-features">Features</a> •28 <a href="#-pricing--modes">Pricing</a> •29 <a href="#-demos">Demos</a> •30 <a href="#-documentation">Docs</a> •31 <a href="#-support">Support</a>32 </p>3334 <div>35 <h3>🎉 <strong>Free Tier Available!</strong> 🎉</h3>36 <p><strong>5,000 requests/month FREE</strong> <br/>37 <sub>Perfect for prototyping and everyday AI workflows</sub></p>38 </div>39</div>4041 <br/>4243 <div align="center">44 <h3>🚀 <a href="https://brightdata.com/ai/mcp-server/launch-week">Launch Week - January 2026</a> 🚀</h3>45 <p><strong>5 Days of Major Releases!</strong></p>46 <table>47 <tr>48 <td align="center">📦 <a href="https://brightdata.com/ai/mcp-server/launch-week/day1">Tool Groups</a></td>49 <td align="center">🧙 <a href="https://brightdata.com/ai/mcp-server/launch-week/day2">Setup Wizard</a></td>50 <td align="center">⚡ <a href="https://brightdata.com/ai/mcp-server/launch-week/day3">Token Efficiency</a></td>51 <td align="center">🏢 <a href="https://brightdata.com/ai/mcp-server/launch-week/day4">Enterprise Integrations</a></td>52 <td align="center">📊 <a href="https://brightdata.com/ai/mcp-server/launch-week/day5">Observability</a></td>53 </tr>54 </table>55 </div>56575859---6061## 🌟 Overview6263**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.6465Built by [Bright Data](https://brightdata.com), the world's #1 web data platform, this MCP server ensures your AI never gets blocked, rate-limited, or served CAPTCHAs.6667<div align="center">68 <table>69 <tr>70 <td align="center">✅ <strong>Works with Any LLM</strong><br/><sub>Claude, GPT, Gemini, Llama</sub></td>71 <td align="center">🛡️ <strong>Never Gets Blocked</strong><br/><sub>Enterprise-grade unblocking</sub></td>72 <td align="center">🚀 <strong>5,000 Free Requests</strong><br/><sub>Monthly</sub></td>73 <td align="center">⚡ <strong>Zero Config</strong><br/><sub>Works out of the box</sub></td>74 </tr>75 </table>76</div>7778---7980## 🎯 Perfect For8182- 🔍 **Real-time Research** - Get current prices, news, and live data83- 🛍️ **E-commerce Intelligence** - Monitor products, prices, and availability84- 📊 **Market Analysis** - Track competitors and industry trends85- 🤖 **AI Agents** - Build agents that can actually browse the web86- 📝 **Content Creation** - Access up-to-date information for writing87- 🎓 **Academic Research** - Gather data from multiple sources efficiently8889---9091## ⚡ Quick Start9293**Use the configuration wizard:**9495969798<summary><b>📡 Use our hosted server - No installation needed!</b></summary>99100Perfect for users who want zero setup. Just add this URL to your MCP client:101102```103https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE104```105106**Setup in Claude Desktop:**1071. Go to: Settings → Connectors → Add custom connector1082. Name: `Bright Data Web`1093. URL: `https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN`1104. Click "Add" and you're done! ✨111112113<summary><b>Run locally on your machine</b></summary>114115```json116{117 "mcpServers": {118 "Bright Data": {119 "command": "npx",120 "args": ["@brightdata/mcp"],121 "env": {122 "API_TOKEN": "<your-api-token-here>"123 }124 }125 }126}127```128129130---131132## 🚀 Pricing & Modes133134<div align="center">135 <table>136 <tr>137 <th width="33%">⚡ Rapid Mode (Free tier)</th>138 <th width="33%">💎 Pro Mode</th>139 <th width="34%">🔧 Custom Mode</th>140 </tr>141 <tr>142 <td align="center">143 <h3>$0/month</h3>144 <p><strong>5,000 requests</strong></p>145 <hr/>146 <p>✅ Web Search<br/>147 ✅ Scraping with Web unlocker<br/>148 ❌ Browser Automation<br/>149 ❌ Web data tools</p>150 <br/>151 <code>Default Mode</code>152 </td>153 <td align="center">154 <h3>Pay-as-you-go</h3>155 <p><strong>Everything in rapid plus 60+ tools</strong></p>156 <hr/>157 <p>✅ Browser Control<br/>158 ✅ Web Data APIs<br/>159 <br/>160 <br/>161 <br/>162 <code>PRO_MODE=true</code>163 </td>164 <td align="center">165 <h3>Usage-based</h3>166 <p><strong>Pick the tools you need</strong></p>167 <hr/>168 <p>✅ Combine tool groups<br/>169 ✅ Add individual tools<br/>170 ❌ Overrides Pro eligibility</p>171 <br/>172 <code>GROUPS="browser"</code><br/>173 <code>TOOLS="scrape_as_html"</code>174 </td>175 </tr>176 </table>177</div>178179> **💡 Note:** Pro mode is **not included** in the free tier and incurs180> additional charges based on usage.181182---183184## 🧠 Advanced Tool Selection185186- `GROUPS` lets you enable curated tool bundles. Use comma-separated group187 IDs such as `ecommerce,browser`.188- `TOOLS` adds explicit tool names on top of the selected groups.189- Mode priority: `PRO_MODE=true` (all tools) → `GROUPS` / `TOOLS`190 (whitelist) → default rapid mode (base toolkit).191- Base tools always enabled: `search_engine`, `search_engine_batch`,192 `scrape_as_markdown`, `scrape_batch`.193- Group ID `custom` is reserved; use `TOOLS` for bespoke picks.194195196<table>197 <tr>198 <th align="left">Group ID</th>199 <th align="left">Description</th>200 <th align="left">Featured tools</th>201 </tr>202 <tr>203 <td><code>ecommerce</code></td>204 <td>Retail and marketplace datasets</td>205 <td><code>web_data_amazon_product</code>,206 <code>web_data_walmart_product</code>,207 <code>web_data_google_shopping</code></td>208 </tr>209 <tr>210 <td><code>social</code></td>211 <td>Social, community, and creator insights</td>212 <td><code>web_data_linkedin_posts</code>,213 <code>web_data_tiktok_posts</code>,214 <code>web_data_youtube_videos</code></td>215 </tr>216 <tr>217 <td><code>browser</code></td>218 <td>Bright Data Scraping Browser automation tools</td>219 <td><code>scraping_browser_snapshot</code>,220 <code>scraping_browser_click_ref</code>,221 <code>scraping_browser_screenshot</code></td>222 </tr>223 <tr>224 <td><code>finance</code></td>225 <td>Financial intelligence datasets</td>226 <td><code>web_data_yahoo_finance_business</code></td>227 </tr>228 <tr>229 <td><code>business</code></td>230 <td>Company and location intelligence datasets</td>231 <td><code>web_data_crunchbase_company</code>,232 <code>web_data_zoominfo_company_profile</code>,233 <code>web_data_zillow_properties_listing</code></td>234 </tr>235 <tr>236 <td><code>research</code></td>237 <td>News and developer data feeds</td>238 <td><code>web_data_github_repository_file</code>,239 <code>web_data_reuter_news</code></td>240 </tr>241 <tr>242 <td><code>app_stores</code></td>243 <td>App store data</td>244 <td><code>web_data_google_play_store</code>,245 <code>web_data_apple_app_store</code></td>246 </tr>247 <tr>248 <td><code>travel</code></td>249 <td>Travel information</td>250 <td><code>web_data_booking_hotel_listings</code></td>251 </tr>252 <tr>253 <td><code>advanced_scraping</code></td>254 <td>Batch and AI-assisted extraction helpers</td>255 <td><code>search_engine_batch</code>,256 <code>scrape_batch</code>,257 <code>extract</code></td>258 </tr>259</table>260261### Claude Desktop example262263```json264{265 "mcpServers": {266 "Bright Data": {267 "command": "npx",268 "args": ["@brightdata/mcp"],269 "env": {270 "API_TOKEN": "<your-api-token-here>",271 "GROUPS": "browser,advanced_scraping",272 "TOOLS": "extract"273 }274 }275 }276}277```278279---280281## ✨ Features282283### 🔥 Core Capabilities284285<table>286 <tr>287 <td>🔍 <b>Smart Web Search</b><br/>Google-quality results optimized for AI</td>288 <td>📄 <b>Clean Markdown</b><br/>AI-ready content extraction</td>289 </tr>290 <tr>291 <td>🌍 <b>Global Access</b><br/>Bypass geo-restrictions automatically</td>292 <td>🛡️ <b>Anti-Bot Protection</b><br/>Never get blocked or rate-limited</td>293 </tr>294 <tr>295 <td>🤖 <b>Browser Automation</b><br/>Control real browsers remotely (Pro)</td>296 <td>⚡ <b>Lightning Fast</b><br/>Optimized for minimal latency</td>297 </tr>298</table>299300### 🎯 Example Queries That Just Work301302```yaml303✅ "What's Tesla's current stock price?"304✅ "Find the best-rated restaurants in Tokyo right now"305✅ "Get today's weather forecast for New York"306✅ "What movies are releasing this week?"307✅ "What are the trending topics on Twitter today?"308```309310---311312## 🎬 Demos313314> **Note:** These videos show earlier versions. New demos coming soon! 🎥315316<details>317<summary><b>View Demo Videos</b></summary>318319### Basic Web Search Demo320https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33321322### Advanced Scraping Demo323https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d324325[📺 More tutorials on YouTube →](https://github.com/brightdata-com/brightdata-mcp/blob/main/examples/README.md)326327</details>328329---330331## 🔧 Available Tools332333### ⚡ Rapid Mode Tools (Default - Free)334335| Tool | Description | Use Case |336|------|-------------|----------|337| 🔍 `search_engine` | Web search with AI-optimized results | Research, fact-checking, current events |338| 📄 `scrape_as_markdown` | Convert any webpage to clean markdown | Content extraction, documentation |339340### 💎 Pro Mode Tools (60+ Tools)341342<details>343<summary><b>Click to see all Pro tools</b></summary>344345| Category | Tools | Description |346|----------|-------|-------------|347| **Browser Control** | `scraping_browser.*` | Full browser automation |348| **Web Data APIs** | `web_data_*` | Structured data extraction |349| **E-commerce** | Product scrapers | Amazon, eBay, Walmart data |350| **Social Media** | Social scrapers | Twitter, LinkedIn, Instagram |351| **Maps & Local** | Location tools | Google Maps, business data |352353[📚 View complete tool documentation →](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Tools.md)354355</details>356357---358359## 🎮 Try It Now!360361### 🧪 Online Playground362Try the Web MCP without any setup:363364<div align="center">365 <a href="https://brightdata.com/ai/playground-chat">366 <img src="https://img.shields.io/badge/Try_on-Playground-00C7B7?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMyA3VjE3TDEyIDIyTDIxIDE3VjdMMTIgMloiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMiIvPgo8L3N2Zz4=" alt="Playground"/>367 </a>368</div>369370---371372## 🔧 Configuration373374### Basic Setup375```json376{377 "mcpServers": {378 "Bright Data": {379 "command": "npx",380 "args": ["@brightdata/mcp"],381 "env": {382 "API_TOKEN": "your-token-here"383 }384 }385 }386}387```388389### Advanced Configuration390```json391{392 "mcpServers": {393 "Bright Data": {394 "command": "npx",395 "args": ["@brightdata/mcp"],396 "env": {397 "API_TOKEN": "your-token-here",398 "PRO_MODE": "true", // Enable all 60+ tools399 "RATE_LIMIT": "100/1h", // Custom rate limiting400 "WEB_UNLOCKER_ZONE": "custom", // Custom unlocker zone401 "BROWSER_ZONE": "custom_browser", // Custom browser zone402 "POLLING_TIMEOUT": "600" // Polling timeout in seconds (default: 600)403 }404 }405 }406}407```408409### Environment Variables410411| Variable | Description | Default | Example |412|----------|-------------|---------|---------|413| `API_TOKEN` | Your Bright Data API token (required) | - | `your-token-here` |414| `PRO_MODE` | Enable all 60+ tools | `false` | `true` |415| `RATE_LIMIT` | Custom rate limiting | unlimited | `100/1h`, `50/30m` |416| `WEB_UNLOCKER_ZONE` | Custom Web Unlocker zone name | `mcp_unlocker` | `my_custom_zone` |417| `BROWSER_ZONE` | Custom Browser zone name | `mcp_browser` | `my_browser_zone` |418| `POLLING_TIMEOUT` | Timeout for web_data_* tools polling (seconds) | `600` | `300`, `1200` |419| `GROUPS` | Comma-separated tool group IDs | - | `ecommerce,browser` |420| `TOOLS` | Comma-separated individual tool names | - | `extract,scrape_as_html` |421422**Notes:**423- `POLLING_TIMEOUT` controls how long web_data_* tools wait for results. Each second = 1 polling attempt.424- Lower values (e.g., 300) will fail faster on slow data collections.425- Higher values (e.g., 1200) allow more time for complex scraping tasks.426427---428429## 📚 Documentation430431<div align="center">432 <table>433 <tr>434 <td align="center">435 <a href="https://docs.brightdata.com/mcp-server/overview">436 <img src="https://img.shields.io/badge/📖-API_Docs-blue?style=for-the-badge" alt="API Docs"/>437 </a>438 </td>439 <td align="center">440 <a href="https://github.com/brightdata-com/brightdata-mcp/blob/main/examples">441 <img src="https://img.shields.io/badge/💡-Examples-green?style=for-the-badge" alt="Examples"/>442 </a>443 </td>444 <td align="center">445 <a href="https://github.com/brightdata-com/brightdata-mcp/blob/main/CHANGELOG.md">446 <img src="https://img.shields.io/badge/📝-Changelog-orange?style=for-the-badge" alt="Changelog"/>447 </a>448 </td>449 <td align="center">450 <a href="https://brightdata.com/blog/ai/web-scraping-with-mcp">451 <img src="https://img.shields.io/badge/📚-Tutorial-purple?style=for-the-badge" alt="Tutorial"/>452 </a>453 </td>454 </tr>455 </table>456</div>457458---459460## 🚨 Common Issues & Solutions461462<details>463<summary><b>🔧 Troubleshooting Guide</b></summary>464465### ❌ "spawn npx ENOENT" Error466**Solution:** Install Node.js or use the full path to node:467```json468"command": "/usr/local/bin/node" // macOS/Linux469"command": "C:\\Program Files\\nodejs\\node.exe" // Windows470```471472### ⏱️ Timeouts on Complex Sites473**Solution:** Increase timeout in your client settings to 180s474475### 🔑 Authentication Issues476**Solution:** Ensure your API token is valid and has proper permissions477478### 📡 Remote Server Connection479**Solution:** Check your internet connection and firewall settings480481[More troubleshooting →](https://github.com/brightdata-com/brightdata-mcp#troubleshooting)482483</details>484485---486487## 🤝 Contributing488489We love contributions! Here's how you can help:490491- 🐛 [Report bugs](https://github.com/brightdata-com/brightdata-mcp/issues)492- 💡 [Suggest features](https://github.com/brightdata-com/brightdata-mcp/issues)493- 🔧 [Submit PRs](https://github.com/brightdata-com/brightdata-mcp/pulls)494- ⭐ Star this repo!495496Please follow [Bright Data's coding standards](https://brightdata.com/dna/js_code).497498---499500## 📞 Support501502<div align="center">503 <table>504 <tr>505 <td align="center">506 <a href="https://github.com/brightdata-com/brightdata-mcp/issues">507 <strong>🐛 GitHub Issues</strong><br/>508 <sub>Report bugs & features</sub>509 </a>510 </td>511 <td align="center">512 <a href="https://docs.brightdata.com/mcp-server/overview">513 <strong>📚 Documentation</strong><br/>514 <sub>Complete guides</sub>515 </a>516 </td>517 <td align="center">518 <a href="mailto:support@brightdata.com">519 <strong>✉️ Email</strong><br/>520 <sub>support@brightdata.com</sub>521 </a>522 </td>523 </tr>524 </table>525</div>526527---528529## 📜 License530531MIT © [Bright Data Ltd.](https://brightdata.com)532533---534535<div align="center">536 <p>537 <strong>Built with ❤️ by</strong><br/>538 <a href="https://brightdata.com">539 <img src="https://idsai.net.technion.ac.il/files/2022/01/Logo-600.png" alt="Bright Data" height="120"/>540 </a>541 </p>542 <p>543 <sub>The world's #1 web data platform</sub>544 </p>545546 <br/>547548 <p>549 <a href="https://github.com/brightdata-com/brightdata-mcp">⭐ Star us on GitHub</a> •550 <a href="https://brightdata.com/blog">Read our Blog</a>551 </p>552</div>553
Full transparency — inspect the skill content before installing.