
Bright Data
โ 2,500from brightdata
Discover, extract, and interact with the web - one interface powering automated access across the public internet.
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.
npm**** Package versions, READMEs, metadata & dependencies PyPI**** Python 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.
ChatGPT** AI-generated insights, citations & recommendations Grok**** Real-time AI analysis powered by X data Perplexity**** Search-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 LLM Claude, GPT, Gemini, Llama ๐ก๏ธ Never Gets Blocked Enterprise-grade unblocking ๐ 5,000 Free Credits Monthly ยท No card needed โก 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
-
๐ป 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
๐ 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="scrape_as_html"
๐ก 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
-
GROUPSlets you enable curated tool bundles. Use comma-separated group IDs such asecommerce,browser. -
TOOLSadds 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
customis reserved; useTOOLSfor 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
geo GEO & LLM brand visibility web_data_chatgpt_ai_insights,
web_data_grok_ai_insights,
web_data_perplexity_ai_insights
code Package intelligence for coding agents web_data_npm_package,
web_data_pypi_package
advanced_scraping Batch and AI-assisted extraction helpers search_engine_batch,
scrape_batch,
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:
๐ Documentation
๐ค 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 [emailย protected]
๐ License
MIT ยฉ Bright Data Ltd.
Built with โค๏ธ by
The world's #1 web data platform
โก 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:
-
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! โจ
Run locally on your machine
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": " "
}
}
}
}
๐ง 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 web_data_* 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_TIMEOUTcontrols 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.
๐จ 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