README Documentation
The Web MCP
🌐 Give your AI real-time web superpowers
Seamlessly connect LLMs to the live web without getting blocked
</a>
<a href="https://www.npmjs.com/package/@brightdata/mcp">
</a>
<a href="https://github.com/brightdata-com/brightdata-mcp/blob/main/LICENSE">
</a>
Quick Start • Features • Pricing • Demos • Docs • Support
🎉 Free Tier Available! 🎉
5,000 requests/month FREE
Perfect for prototyping and everyday AI workflows
🌟 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
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:
- Go to: Settings → Connectors → Add custom connector
- Name:
Bright Data Web
- URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
- Click "Add" and you're done! ✨
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
🚀 Pricing & Modes
⚡ Rapid Mode (Free tier) | 💎 Pro Mode |
---|---|
$0/month5,000 requests ✅ Web Search Default Mode
|
Pay-as-you-goEvery thing in rapid and 60+ Advanced Tools ✅ Browser Control |
💡 Note: Pro mode is not included in the free tier and incurs additional charges based on usage.
✨ 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
🔧 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)
Click to see all Pro tools
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 |
🎮 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
🤝 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.