MCP Hub
Back to servers

brightdata-mcp

Validation Failed

A robust web access MCP server by Bright Data that provides AI agents with unblockable web search, markdown scraping, and structured data extraction from major retail, social, and financial platforms.

Stars
1,860
Forks
237
Tools
23
Updated
Jan 8, 2026
Validated
Jan 9, 2026

Validation Error:

Process exited with code 1. stderr: file:///home/runner/.npm/_npx/a50edfa03303c0a4/node_modules/@brightdata/mcp/server.js:63 throw new Error('Cannot run MCP server without API_TOKEN env'); ^ Error: Cannot run MCP server without API_TOKEN env at file:///home/runner/.npm/_npx/a50edfa03303c0a4/node_modules/@brightdata/mcp/server.js:63:11 at ModuleJob.run (node:internal/modules/esm/module_job:325:25) at async ModuleLoader.import (node:internal/modules/esm/loader:606:24) at async asyncRunEntryPointWithESM

Quick Install

npx -y @brightdata/mcp
Bright Data Logo

The Web MCP

🌐 Give your AI real-time web superpowers
Seamlessly connect LLMs to the live web without getting blocked

npm version npm downloads License

Quick StartFeaturesPricingDemosDocsSupport

🎉 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

Use the configuration wizard:

GIF for day2

📡 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": "<your-api-token-here>"
      }
    }
  }
}

🚀 Pricing & Modes

⚡ Rapid Mode (Free tier)💎 Pro Mode🔧 Custom Mode

$0/month

5,000 requests


✅ Web Search
✅ Scraping with Web unlocker
❌ Browser Automation
❌ Web data tools


Default Mode

Pay-as-you-go

Everything in rapid plus 60+ tools


✅ Browser Control
✅ Web Data APIs



PRO_MODE=true

Usage-based

Pick the tools you need


✅ Combine tool groups
✅ Add individual tools
❌ Overrides Pro eligibility


GROUPS="browser"
TOOLS="scrape_as_html"

💡 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.
Group IDDescriptionFeatured tools
ecommerceRetail and marketplace datasetsweb_data_amazon_product, web_data_walmart_product, web_data_google_shopping
socialSocial, community, and creator insightsweb_data_linkedin_posts, web_data_tiktok_posts, web_data_youtube_videos
browserBright Data Scraping Browser automation toolsscraping_browser_snapshot, scraping_browser_click_ref, scraping_browser_screenshot
financeFinancial intelligence datasetsweb_data_yahoo_finance_business
businessCompany and location intelligence datasetsweb_data_crunchbase_company, web_data_zoominfo_company_profile, web_data_zillow_properties_listing
researchNews and developer data feedsweb_data_github_repository_file, web_data_reuter_news
app_storesApp store dataweb_data_google_play_store, web_data_apple_app_store
travelTravel informationweb_data_booking_hotel_listings
advanced_scrapingBatch and AI-assisted extraction helperssearch_engine_batch, scrape_batch, extract

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

🔍 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

📺 More tutorials on YouTube →


🔧 Available Tools

⚡ Rapid Mode Tools (Default - Free)

ToolDescriptionUse Case
🔍 search_engineWeb search with AI-optimized resultsResearch, fact-checking, current events
📄 scrape_as_markdownConvert any webpage to clean markdownContent extraction, documentation

💎 Pro Mode Tools (60+ Tools)

Click to see all Pro tools
CategoryToolsDescription
Browser Controlscraping_browser.*Full browser automation
Web Data APIsweb_data_*Structured data extraction
E-commerceProduct scrapersAmazon, eBay, Walmart data
Social MediaSocial scrapersTwitter, LinkedIn, Instagram
Maps & LocalLocation toolsGoogle Maps, business data

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

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

Please follow Bright Data's coding standards.


📞 Support


📜 License

MIT © Bright Data Ltd.


Built with ❤️ by
Bright Data

The world's #1 web data platform


⭐ Star us on GitHubRead our Blog

Reviews

No reviews yet

Sign in to write a review