An MCP interface into the Bright Data toolset
npm install @brightdata/mcp
๐ Give your AI real-time web superpowers
Seamlessly connect LLMs to the live web without getting blocked
Quick Start โข
Features โข
Pricing โข
Demos โข
Docs โข
Support
5,000 requests/month FREE
Perfect for prototyping and everyday AI workflows
5 Days of Major Releases!
| ๐ฆ Tool Groups | ๐ง Setup Wizard | โก Token Efficiency | ๐ข Enterprise Integrations | ๐ Observability |
---
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 |
---
- ๐ 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
---
Use the configuration wizard:
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 Webhttps://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
3. URL:
4. Click "Add" and you're done! โจ
`json`
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "
}
}
}
}
---
| โก Rapid Mode (Free tier) | ๐ Pro Mode | ๐ง Custom Mode |
|---|---|---|
$0/month5,000 requests โ
Web Search Default Mode | Pay-as-you-goEverything in rapid plus 60+ tools โ
Browser Control | Usage-basedPick the tools you need โ
Combine tool groups GROUPS="browser"TOOLS="scrape_as_html" |
> ๐ก Note: Pro mode is not included in the free tier and incurs
> additional charges based on usage.
---
- GROUPS lets you enable curated tool bundles. Use comma-separated groupecommerce,browser
IDs such as .TOOLS
- adds explicit tool names on top of the selected groups.PRO_MODE=true
- Mode priority: (all tools) โ GROUPS / TOOLSsearch_engine
(whitelist) โ default rapid mode (base toolkit).
- Base tools always enabled: , search_engine_batch,scrape_as_markdown
, scrape_batch.custom
- Group ID 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 |
advanced_scraping | Batch and AI-assisted extraction helpers | search_engine_batch,scrape_batch,extract |
`json`
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "
"GROUPS": "browser,advanced_scraping",
"TOOLS": "extract"
}
}
}
}
---
| ๐ 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 |
`yaml`
โ
"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?"
---
> Note: These videos show earlier versions. New demos coming soon! ๐ฅ
View Demo Videos
๐บ More tutorials on YouTube โ
---
| 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 |
Click to see all Pro tools
| Category | Tools | Description |
|----------|-------|-------------|
| Browser Control | scraping_browser.* | Full browser automation |web_data_*
| Web Data APIs | | 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 โ
---
---
json
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here"
}
}
}
}
`$3
`json
{
"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)
}
}
}
}
`$3
| 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
---
๐จ Common Issues & Solutions
๐ง Troubleshooting Guide
$3
Solution: Install Node.js or use the full path to node:
`json
"command": "/usr/local/bin/node" // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe" // Windows
``---
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.
---
๐ GitHub Issues Report bugs & features | ๐ Documentation Complete guides | โ๏ธ Email support@brightdata.com |
---
MIT ยฉ Bright Data Ltd.
---