Brightdata Mcp

The Web 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

🎉 Free Tier Available! 🎉 5,000 credits/month FREE No credit card required · Auto-renews monthly · Perfect for prototyping and everyday AI workflows

NEW: Code Tool group - Your Coding Agent's Best Friend Instant access to npm and PyPI package data, right from your AI agent.

Need the latest version of a package? Want to read its README without leaving your workflow? The Code tool group gives coding agents structured, reliable package metadata on demand — no scraping, no stale caches, just the data your agent needs to make smart dependency decisions.

npmPackage versions, READMEs, metadata & dependencies PyPIPython package info, versions & project details

GROUPS="code"  ·  The go-to tool for Claude Code, Cursor, Windsurf & any MCP-powered coding agent

GEO & AI Brand Visibility Tools See how ChatGPT, Grok, and Perplexity talk about your brand.

Query leading LLMs directly from your agent and get back structured, markdown-formatted answers. The ultimate feedback loop for Generative Engine Optimization (GEO) — monitor AI-generated recommendations, track brand mentions across LLMs, and understand how AI perceives your products.

ChatGPTAI-generated insights, citations & recommendations GrokReal-time AI analysis powered by X data PerplexitySearch-augmented AI answers with sources

GROUPS="geo"  ·  Works with any MCP-compatible agent

---

🌟 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 LLMClaude, GPT, Gemini, Llama 🛡️ Never Gets BlockedEnterprise-grade unblocking 🚀 5,000 Free CreditsMonthly · No card needed ⚡ Zero ConfigWorks 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
• 💻 Coding Agents - Look up npm/PyPI packages, versions, and READMEs in real time
• 🧠 GEO & Brand Visibility - See how ChatGPT, Grok, and Perplexity perceive your brand
• 📝 Content Creation - Access up-to-date information for writing
• 🎓 Academic Research - Gather data from multiple sources efficiently

---

⚡ Quick Start

Use the configuration wizard:

📡 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": ""
      }
    }
  }
}

---

🚀 Pricing & Modes

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

$0/month 5,000 credits

✅ Web Search ✅ Scraping with Web unlocker ✅ AI-ranked Discover search ❌ 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="scrapeashtml"

> 💡 How the free tier works: Your account gets 5,000 credits/month > (~$7.50 value), auto-renewed on the 1st with no credit card required. > MCP requests draw from this shared pool — base tools (search_engine, > scrape_as_markdown, discover) cost 1 credit per request, while > web_data_* tools cost 1 credit per record returned. Unused credits > don't roll over, and when they run out requests stop (no surprise > charges unless you've deposited funds). 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, discover.

• Group ID custom is reserved; use TOOLS for bespoke picks.

Group ID Description Featured tools

ecommerce Retail and marketplace datasets webdataamazonproduct, webdatawalmartproduct, webdatagoogle_shopping

social Social, community, and creator insights webdatalinkedinposts, webdatatiktokposts, webdatayoutube_videos

browser Bright Data Scraping Browser automation tools scrapingbrowsersnapshot, scrapingbrowserclickref, scrapingbrowser_screenshot

finance Financial intelligence datasets webdatayahoofinancebusiness

business Company and location intelligence datasets webdatacrunchbasecompany, webdatazoominfocompanyprofile, webdatazillowproperties_listing

research News and developer data feeds webdatagithubrepositoryfile, webdatareuter_news

appstores App store data webdatagoogleplaystore, webdataappleapp_store

travel Travel information webdatabookinghotellistings

geo GEO & LLM brand visibility webdatachatgptaiinsights, webdatagrokaiinsights, webdataperplexityaiinsights

code Package intelligence for coding agents webdatanpmpackage, webdatapypipackage

advancedscraping Batch and AI-assisted extraction helpers searchenginebatch, scrapebatch, extract

Claude Desktop example

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "",
        "GROUPS": "browser,advanced_scraping",
        "TOOLS": "extract"
      }
    }
  }
}

Coding agent example (Claude Code / Cursor / Windsurf)

Give your coding agent real-time package intelligence — latest versions, READMEs, dependencies, and metadata from npm and PyPI without scraping:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "",
        "GROUPS": "code"
      }
    }
  }
}

---

✨ Features

🔥 Core Capabilities

🔍 Smart Web SearchGoogle-quality results optimized for AI 📄 Clean MarkdownAI-ready content extraction

🌍 Global AccessBypass geo-restrictions automatically 🛡️ Anti-Bot ProtectionNever get blocked or rate-limited

🤖 Browser AutomationControl real browsers remotely (Pro) ⚡ Lightning FastOptimized 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?"
✅ "What's the latest version of express on npm?"
✅ "Get the README for the langchain-brightdata PyPI package"

---

🎬 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)

| 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 | | 🎯 discover | AI-ranked web search with intent-based relevance scoring | Deep research, RAG pipelines, competitive analysis |

💎 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 |

📚 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
        "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 webdata* tools polling (seconds) | 600 | 300, 1200 | | BASE_TIMEOUT | Request timeout for base tools in seconds (search & scrape) | No limit | 60, 120 | | BASE_MAX_RETRIES | Max retries for base tools on transient errors (0-3) | 0 | 1, 3 | | GROUPS | Comma-separated tool group IDs | - | ecommerce,browser | | TOOLS | Comma-separated individual tool names | - | extract,scrape_as_html |

Notes:

• POLLING_TIMEOUT controls how long webdata* 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

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

• 🐛 Report bugs
• 💡 Suggest features
• 🔧 Submit PRs
• ⭐ Star this repo!

Please follow Bright Data's coding standards.

---

📞 Support

🐛 GitHub Issues Report bugs & features

📚 Documentation Complete guides

✉️ Email support@brightdata.com

---

📜 License

MIT © Bright Data Ltd.

---

Built with ❤️ by

The world's #1 web data platform

⭐ Star us on GitHub • Read our Blog

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: brightdata
• Source: brightdata/brightdata-mcp
• License: MIT
• Homepage: https://brightdata.com/

Install and usage instructions live in the source repository linked above.