# Brightdata Mcp > A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access. - **Type:** MCP server - **Install:** `agentstack add mcp-brightdata-brightdata-mcp` - **Verified:** Yes โ€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [brightdata](https://agentstack.voostack.com/s/brightdata) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [brightdata](https://github.com/brightdata) - **Source:** https://github.com/brightdata/brightdata-mcp - **Website:** https://brightdata.com/ ## Install ```sh agentstack add mcp-brightdata-brightdata-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About 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](https://brightdata.com), 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 ```json { "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="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 - `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 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 ```json { "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: ```json { "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 ```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?" โœ… "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 โ†’](https://github.com/brightdata-com/brightdata-mcp/blob/main/examples/README.md) --- ## ๐Ÿ”ง 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 โ†’](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Tools.md) --- ## ๐ŸŽฎ Try It Now! ### ๐Ÿงช Online Playground Try the Web MCP without any setup: --- ## ๐Ÿ”ง Configuration ### Basic Setup ```json { "mcpServers": { "Bright Data": { "command": "npx", "args": ["@brightdata/mcp"], "env": { "API_TOKEN": "your-token-here" } } } } ``` ### Advanced Configuration ```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) } } } } ``` ### 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_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 ### โŒ "spawn npx ENOENT" Error **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 ``` ### โฑ๏ธ 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 โ†’](https://github.com/brightdata-com/brightdata-mcp#troubleshooting) --- ## ๐Ÿค Contributing We love contributions! Here's how you can help: - ๐Ÿ› [Report bugs](https://github.com/brightdata-com/brightdata-mcp/issues) - ๐Ÿ’ก [Suggest features](https://github.com/brightdata-com/brightdata-mcp/issues) - ๐Ÿ”ง [Submit PRs](https://github.com/brightdata-com/brightdata-mcp/pulls) - โญ Star this repo! Please follow [Bright Data's coding standards](https://brightdata.com/dna/js_code). --- ## ๐Ÿ“ž Support ๐Ÿ› GitHub Issues Report bugs & features ๐Ÿ“š Documentation Complete guides โœ‰๏ธ Email support@brightdata.com --- ## ๐Ÿ“œ License MIT ยฉ [Bright Data Ltd.](https://brightdata.com) --- 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](https://github.com/brightdata) - **Source:** [brightdata/brightdata-mcp](https://github.com/brightdata/brightdata-mcp) - **License:** MIT - **Homepage:** https://brightdata.com/ Install and usage instructions live in the source repository linked above. ## Pricing - **Free** โ€” Free ## Security capabilities Automated source analysis of v0.1.0 โ€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source โ€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** โ€” security scan: passed โ€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-brightdata-brightdata-mcp - Seller: https://agentstack.voostack.com/s/brightdata - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack โ€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.