{"id":28567690,"url":"https://github.com/brightdata/brightdata-mcp","last_synced_at":"2026-01-16T23:26:25.640Z","repository":{"id":288076531,"uuid":"966718614","full_name":"brightdata/brightdata-mcp","owner":"brightdata","description":"A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.","archived":false,"fork":false,"pushed_at":"2026-01-15T07:53:52.000Z","size":66783,"stargazers_count":1898,"open_issues_count":16,"forks_count":244,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-01-15T14:36:36.708Z","etag":null,"topics":["ai-agents","ai-integrations","anti-bot-detection","browser-automation","data-collection","data-extraction","llm","mcp","mcp-server","modelcontextprotocol","scraping","scraping-tools","structured-data","web-crawling","web-data","web-scraping"],"latest_commit_sha":null,"homepage":"https://brightdata.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brightdata.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-15T10:55:56.000Z","updated_at":"2026-01-15T14:05:31.000Z","dependencies_parsed_at":"2025-08-07T13:13:39.989Z","dependency_job_id":"12be834b-0c92-43cf-91f4-d60282ce3f26","html_url":"https://github.com/brightdata/brightdata-mcp","commit_stats":null,"previous_names":["luminati-io/brightdata-mcp","brightdata-com/brightdata-mcp","brightdata/brightdata-mcp"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/brightdata/brightdata-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brightdata%2Fbrightdata-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brightdata%2Fbrightdata-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brightdata%2Fbrightdata-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brightdata%2Fbrightdata-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brightdata","download_url":"https://codeload.github.com/brightdata/brightdata-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brightdata%2Fbrightdata-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28487586,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T22:54:02.790Z","status":"ssl_error","status_checked_at":"2026-01-16T22:50:10.344Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-integrations","anti-bot-detection","browser-automation","data-collection","data-extraction","llm","mcp","mcp-server","modelcontextprotocol","scraping","scraping-tools","structured-data","web-crawling","web-data","web-scraping"],"created_at":"2025-06-10T16:00:17.837Z","updated_at":"2026-01-16T23:26:25.630Z","avatar_url":"https://github.com/brightdata.png","language":"JavaScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://brightdata.com/ai/mcp-server\"\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/c21b3f7b-7ff1-40c3-b3d8-66706913d62f\" alt=\"Bright Data Logo\"\u003e\n  \u003c/a\u003e\n\n  \u003ch1\u003eThe Web MCP\u003c/h1\u003e\n  \n  \u003cp\u003e\n    \u003cstrong\u003e🌐 Give your AI real-time web superpowers\u003c/strong\u003e\u003cbr/\u003e\n    \u003ci\u003eSeamlessly connect LLMs to the live web without getting blocked\u003c/i\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://www.npmjs.com/package/@brightdata/mcp\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/v/@brightdata/mcp?style=for-the-badge\u0026color=blue\" alt=\"npm version\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.npmjs.com/package/@brightdata/mcp\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/dw/@brightdata/mcp?style=for-the-badge\u0026color=green\" alt=\"npm downloads\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/brightdata-com/brightdata-mcp/blob/main/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/license-MIT-purple?style=for-the-badge\" alt=\"License\"/\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"#-quick-start\"\u003eQuick Start\u003c/a\u003e •\n    \u003ca href=\"#-features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#-pricing--modes\"\u003ePricing\u003c/a\u003e •\n    \u003ca href=\"#-demos\"\u003eDemos\u003c/a\u003e •\n    \u003ca href=\"#-documentation\"\u003eDocs\u003c/a\u003e •\n    \u003ca href=\"#-support\"\u003eSupport\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cdiv\u003e\n    \u003ch3\u003e🎉 \u003cstrong\u003eFree Tier Available!\u003c/strong\u003e 🎉\u003c/h3\u003e\n    \u003cp\u003e\u003cstrong\u003e5,000 requests/month FREE\u003c/strong\u003e \u003cbr/\u003e\n    \u003csub\u003ePerfect for prototyping and everyday AI workflows\u003c/sub\u003e\u003c/p\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\n  \u003cbr/\u003e\n  \n  \u003cdiv align=\"center\"\u003e\n    \u003ch3\u003e🚀 \u003ca href=\"https://brightdata.com/ai/mcp-server/launch-week\"\u003eLaunch Week - January 2026\u003c/a\u003e 🚀\u003c/h3\u003e\n    \u003cp\u003e\u003cstrong\u003e5 Days of Major Releases!\u003c/strong\u003e\u003c/p\u003e\n    \u003ctable\u003e\n      \u003ctr\u003e\n        \u003ctd align=\"center\"\u003e📦 \u003ca href=\"https://brightdata.com/ai/mcp-server/launch-week/day1\"\u003eTool Groups\u003c/a\u003e\u003c/td\u003e\n        \u003ctd align=\"center\"\u003e🧙 \u003ca href=\"https://brightdata.com/ai/mcp-server/launch-week/day2\"\u003eSetup Wizard\u003c/a\u003e\u003c/td\u003e\n        \u003ctd align=\"center\"\u003e⚡ \u003ca href=\"https://brightdata.com/ai/mcp-server/launch-week/day3\"\u003eToken Efficiency\u003c/a\u003e\u003c/td\u003e\n        \u003ctd align=\"center\"\u003e🏢 \u003ca href=\"https://brightdata.com/ai/mcp-server/launch-week/day4\"\u003eEnterprise Integrations\u003c/a\u003e\u003c/td\u003e\n        \u003ctd align=\"center\"\u003e📊 \u003ca href=\"https://brightdata.com/ai/mcp-server/launch-week/day5\"\u003eObservability\u003c/a\u003e\u003c/td\u003e\n      \u003c/tr\u003e\n    \u003c/table\u003e\n  \u003c/div\u003e\n\n\n\n---\n\n## 🌟 Overview\n\n**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.\n\nBuilt 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.\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e✅ \u003cstrong\u003eWorks with Any LLM\u003c/strong\u003e\u003cbr/\u003e\u003csub\u003eClaude, GPT, Gemini, Llama\u003c/sub\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e🛡️ \u003cstrong\u003eNever Gets Blocked\u003c/strong\u003e\u003cbr/\u003e\u003csub\u003eEnterprise-grade unblocking\u003c/sub\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e🚀 \u003cstrong\u003e5,000 Free Requests\u003c/strong\u003e\u003cbr/\u003e\u003csub\u003eMonthly\u003c/sub\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e⚡ \u003cstrong\u003eZero Config\u003c/strong\u003e\u003cbr/\u003e\u003csub\u003eWorks out of the box\u003c/sub\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## 🎯 Perfect For\n\n- 🔍 **Real-time Research** - Get current prices, news, and live data\n- 🛍️ **E-commerce Intelligence** - Monitor products, prices, and availability  \n- 📊 **Market Analysis** - Track competitors and industry trends\n- 🤖 **AI Agents** - Build agents that can actually browse the web\n- 📝 **Content Creation** - Access up-to-date information for writing\n- 🎓 **Academic Research** - Gather data from multiple sources efficiently\n\n---\n\n## ⚡ Quick Start\n\n**Use the configuration wizard:** \n\n![GIF for day2](https://github.com/user-attachments/assets/b3917553-6cf9-4264-bc7a-9b8b74df0a17)\n\n\n\u003csummary\u003e\u003cb\u003e📡 Use our hosted server - No installation needed!\u003c/b\u003e\u003c/summary\u003e\n\nPerfect for users who want zero setup. Just add this URL to your MCP client:\n\n```\nhttps://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE\n```\n\n**Setup in Claude Desktop:**\n1. Go to: Settings → Connectors → Add custom connector\n2. Name: `Bright Data Web`\n3. URL: `https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN`\n4. Click \"Add\" and you're done! ✨\n\n\n\u003csummary\u003e\u003cb\u003eRun locally on your machine\u003c/b\u003e\u003c/summary\u003e\n\n```json\n{\n  \"mcpServers\": {\n    \"Bright Data\": {\n      \"command\": \"npx\",\n      \"args\": [\"@brightdata/mcp\"],\n      \"env\": {\n        \"API_TOKEN\": \"\u003cyour-api-token-here\u003e\"\n      }\n    }\n  }\n}\n```\n\n\n---\n\n## 🚀 Pricing \u0026 Modes\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003cth width=\"33%\"\u003e⚡ Rapid Mode (Free tier)\u003c/th\u003e\n      \u003cth width=\"33%\"\u003e💎 Pro Mode\u003c/th\u003e\n      \u003cth width=\"34%\"\u003e🔧 Custom Mode\u003c/th\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ch3\u003e$0/month\u003c/h3\u003e\n        \u003cp\u003e\u003cstrong\u003e5,000 requests\u003c/strong\u003e\u003c/p\u003e\n        \u003chr/\u003e\n        \u003cp\u003e✅ Web Search\u003cbr/\u003e\n        ✅ Scraping with Web unlocker\u003cbr/\u003e\n        ❌ Browser Automation\u003cbr/\u003e\n        ❌ Web data tools\u003c/p\u003e\n        \u003cbr/\u003e\n        \u003ccode\u003eDefault Mode\u003c/code\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ch3\u003ePay-as-you-go\u003c/h3\u003e\n        \u003cp\u003e\u003cstrong\u003eEverything in rapid plus 60+ tools\u003c/strong\u003e\u003c/p\u003e\n        \u003chr/\u003e\n        \u003cp\u003e✅ Browser Control\u003cbr/\u003e\n        ✅ Web Data APIs\u003cbr/\u003e\n        \u003cbr/\u003e\n        \u003cbr/\u003e\n        \u003cbr/\u003e\n        \u003ccode\u003ePRO_MODE=true\u003c/code\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ch3\u003eUsage-based\u003c/h3\u003e\n        \u003cp\u003e\u003cstrong\u003ePick the tools you need\u003c/strong\u003e\u003c/p\u003e\n        \u003chr/\u003e\n        \u003cp\u003e✅ Combine tool groups\u003cbr/\u003e\n        ✅ Add individual tools\u003cbr/\u003e\n        ❌ Overrides Pro eligibility\u003c/p\u003e\n        \u003cbr/\u003e\n        \u003ccode\u003eGROUPS=\"browser\"\u003c/code\u003e\u003cbr/\u003e\n        \u003ccode\u003eTOOLS=\"scrape_as_html\"\u003c/code\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n\u003e **💡 Note:** Pro mode is **not included** in the free tier and incurs\n\u003e additional charges based on usage.\n\n---\n\n## 🧠 Advanced Tool Selection\n\n- `GROUPS` lets you enable curated tool bundles. Use comma-separated group\n  IDs such as `ecommerce,browser`.\n- `TOOLS` adds explicit tool names on top of the selected groups.\n- Mode priority: `PRO_MODE=true` (all tools) → `GROUPS` / `TOOLS`\n  (whitelist) → default rapid mode (base toolkit).\n- Base tools always enabled: `search_engine`, `search_engine_batch`,\n  `scrape_as_markdown`, `scrape_batch`.\n- Group ID `custom` is reserved; use `TOOLS` for bespoke picks.\n\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth align=\"left\"\u003eGroup ID\u003c/th\u003e\n    \u003cth align=\"left\"\u003eDescription\u003c/th\u003e\n    \u003cth align=\"left\"\u003eFeatured tools\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003eecommerce\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eRetail and marketplace datasets\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003eweb_data_amazon_product\u003c/code\u003e,\n    \u003ccode\u003eweb_data_walmart_product\u003c/code\u003e,\n    \u003ccode\u003eweb_data_google_shopping\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003esocial\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eSocial, community, and creator insights\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003eweb_data_linkedin_posts\u003c/code\u003e,\n    \u003ccode\u003eweb_data_tiktok_posts\u003c/code\u003e,\n    \u003ccode\u003eweb_data_youtube_videos\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003ebrowser\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eBright Data Scraping Browser automation tools\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003escraping_browser_snapshot\u003c/code\u003e,\n    \u003ccode\u003escraping_browser_click_ref\u003c/code\u003e,\n    \u003ccode\u003escraping_browser_screenshot\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003efinance\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eFinancial intelligence datasets\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003eweb_data_yahoo_finance_business\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003ebusiness\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eCompany and location intelligence datasets\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003eweb_data_crunchbase_company\u003c/code\u003e,\n    \u003ccode\u003eweb_data_zoominfo_company_profile\u003c/code\u003e,\n    \u003ccode\u003eweb_data_zillow_properties_listing\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003eresearch\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eNews and developer data feeds\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003eweb_data_github_repository_file\u003c/code\u003e,\n    \u003ccode\u003eweb_data_reuter_news\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003eapp_stores\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eApp store data\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003eweb_data_google_play_store\u003c/code\u003e,\n    \u003ccode\u003eweb_data_apple_app_store\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003etravel\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eTravel information\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003eweb_data_booking_hotel_listings\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ccode\u003eadvanced_scraping\u003c/code\u003e\u003c/td\u003e\n    \u003ctd\u003eBatch and AI-assisted extraction helpers\u003c/td\u003e\n    \u003ctd\u003e\u003ccode\u003esearch_engine_batch\u003c/code\u003e,\n    \u003ccode\u003escrape_batch\u003c/code\u003e,\n    \u003ccode\u003eextract\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### Claude Desktop example\n\n```json\n{\n  \"mcpServers\": {\n    \"Bright Data\": {\n      \"command\": \"npx\",\n      \"args\": [\"@brightdata/mcp\"],\n      \"env\": {\n        \"API_TOKEN\": \"\u003cyour-api-token-here\u003e\",\n        \"GROUPS\": \"browser,advanced_scraping\",\n        \"TOOLS\": \"extract\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## ✨ Features\n\n### 🔥 Core Capabilities\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e🔍 \u003cb\u003eSmart Web Search\u003c/b\u003e\u003cbr/\u003eGoogle-quality results optimized for AI\u003c/td\u003e\n    \u003ctd\u003e📄 \u003cb\u003eClean Markdown\u003c/b\u003e\u003cbr/\u003eAI-ready content extraction\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e🌍 \u003cb\u003eGlobal Access\u003c/b\u003e\u003cbr/\u003eBypass geo-restrictions automatically\u003c/td\u003e\n    \u003ctd\u003e🛡️ \u003cb\u003eAnti-Bot Protection\u003c/b\u003e\u003cbr/\u003eNever get blocked or rate-limited\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e🤖 \u003cb\u003eBrowser Automation\u003c/b\u003e\u003cbr/\u003eControl real browsers remotely (Pro)\u003c/td\u003e\n    \u003ctd\u003e⚡ \u003cb\u003eLightning Fast\u003c/b\u003e\u003cbr/\u003eOptimized for minimal latency\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### 🎯 Example Queries That Just Work\n\n```yaml\n✅ \"What's Tesla's current stock price?\"\n✅ \"Find the best-rated restaurants in Tokyo right now\"\n✅ \"Get today's weather forecast for New York\"\n✅ \"What movies are releasing this week?\"\n✅ \"What are the trending topics on Twitter today?\"\n```\n\n---\n\n## 🎬 Demos\n\n\u003e **Note:** These videos show earlier versions. New demos coming soon! 🎥\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eView Demo Videos\u003c/b\u003e\u003c/summary\u003e\n\n### Basic Web Search Demo\nhttps://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33\n\n### Advanced Scraping Demo\nhttps://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d\n\n[📺 More tutorials on YouTube →](https://github.com/brightdata-com/brightdata-mcp/blob/main/examples/README.md)\n\n\u003c/details\u003e\n\n---\n\n## 🔧 Available Tools\n\n### ⚡ Rapid Mode Tools (Default - Free)\n\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| 🔍 `search_engine` | Web search with AI-optimized results | Research, fact-checking, current events |\n| 📄 `scrape_as_markdown` | Convert any webpage to clean markdown | Content extraction, documentation |\n\n### 💎 Pro Mode Tools (60+ Tools)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClick to see all Pro tools\u003c/b\u003e\u003c/summary\u003e\n\n| Category | Tools | Description |\n|----------|-------|-------------|\n| **Browser Control** | `scraping_browser.*` | Full browser automation |\n| **Web Data APIs** | `web_data_*` | Structured data extraction |\n| **E-commerce** | Product scrapers | Amazon, eBay, Walmart data |\n| **Social Media** | Social scrapers | Twitter, LinkedIn, Instagram |\n| **Maps \u0026 Local** | Location tools | Google Maps, business data |\n\n[📚 View complete tool documentation →](https://github.com/brightdata-com/brightdata-mcp/blob/main/assets/Tools.md)\n\n\u003c/details\u003e\n\n---\n\n## 🎮 Try It Now!\n\n### 🧪 Online Playground\nTry the Web MCP without any setup:\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://brightdata.com/ai/playground-chat\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Try_on-Playground-00C7B7?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMyA3VjE3TDEyIDIyTDIxIDE3VjdMMTIgMloiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMiIvPgo8L3N2Zz4=\" alt=\"Playground\"/\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n## 🔧 Configuration\n\n### Basic Setup\n```json\n{\n  \"mcpServers\": {\n    \"Bright Data\": {\n      \"command\": \"npx\",\n      \"args\": [\"@brightdata/mcp\"],\n      \"env\": {\n        \"API_TOKEN\": \"your-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Advanced Configuration\n```json\n{\n  \"mcpServers\": {\n    \"Bright Data\": {\n      \"command\": \"npx\",\n      \"args\": [\"@brightdata/mcp\"],\n      \"env\": {\n        \"API_TOKEN\": \"your-token-here\",\n        \"PRO_MODE\": \"true\",              // Enable all 60+ tools\n        \"RATE_LIMIT\": \"100/1h\",          // Custom rate limiting\n        \"WEB_UNLOCKER_ZONE\": \"custom\",   // Custom unlocker zone\n        \"BROWSER_ZONE\": \"custom_browser\" // Custom browser zone\n      }\n    }\n  }\n}\n```\n\n---\n\n## 📚 Documentation\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://docs.brightdata.com/mcp-server/overview\"\u003e\n          \u003cimg src=\"https://img.shields.io/badge/📖-API_Docs-blue?style=for-the-badge\" alt=\"API Docs\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/brightdata-com/brightdata-mcp/blob/main/examples\"\u003e\n          \u003cimg src=\"https://img.shields.io/badge/💡-Examples-green?style=for-the-badge\" alt=\"Examples\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/brightdata-com/brightdata-mcp/blob/main/CHANGELOG.md\"\u003e\n          \u003cimg src=\"https://img.shields.io/badge/📝-Changelog-orange?style=for-the-badge\" alt=\"Changelog\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://brightdata.com/blog/ai/web-scraping-with-mcp\"\u003e\n          \u003cimg src=\"https://img.shields.io/badge/📚-Tutorial-purple?style=for-the-badge\" alt=\"Tutorial\"/\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## 🚨 Common Issues \u0026 Solutions\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🔧 Troubleshooting Guide\u003c/b\u003e\u003c/summary\u003e\n\n### ❌ \"spawn npx ENOENT\" Error\n**Solution:** Install Node.js or use the full path to node:\n```json\n\"command\": \"/usr/local/bin/node\"  // macOS/Linux\n\"command\": \"C:\\\\Program Files\\\\nodejs\\\\node.exe\"  // Windows\n```\n\n### ⏱️ Timeouts on Complex Sites\n**Solution:** Increase timeout in your client settings to 180s\n\n### 🔑 Authentication Issues\n**Solution:** Ensure your API token is valid and has proper permissions\n\n### 📡 Remote Server Connection\n**Solution:** Check your internet connection and firewall settings\n\n[More troubleshooting →](https://github.com/brightdata-com/brightdata-mcp#troubleshooting)\n\n\u003c/details\u003e\n\n---\n\n## 🤝 Contributing\n\nWe love contributions! Here's how you can help:\n\n- 🐛 [Report bugs](https://github.com/brightdata-com/brightdata-mcp/issues)\n- 💡 [Suggest features](https://github.com/brightdata-com/brightdata-mcp/issues)\n- 🔧 [Submit PRs](https://github.com/brightdata-com/brightdata-mcp/pulls)\n- ⭐ Star this repo!\n\nPlease follow [Bright Data's coding standards](https://brightdata.com/dna/js_code).\n\n---\n\n## 📞 Support\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/brightdata-com/brightdata-mcp/issues\"\u003e\n          \u003cstrong\u003e🐛 GitHub Issues\u003c/strong\u003e\u003cbr/\u003e\n          \u003csub\u003eReport bugs \u0026 features\u003c/sub\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://docs.brightdata.com/mcp-server/overview\"\u003e\n          \u003cstrong\u003e📚 Documentation\u003c/strong\u003e\u003cbr/\u003e\n          \u003csub\u003eComplete guides\u003c/sub\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"mailto:support@brightdata.com\"\u003e\n          \u003cstrong\u003e✉️ Email\u003c/strong\u003e\u003cbr/\u003e\n          \u003csub\u003esupport@brightdata.com\u003c/sub\u003e\n        \u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## 📜 License\n\nMIT © [Bright Data Ltd.](https://brightdata.com)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eBuilt with ❤️ by\u003c/strong\u003e\u003cbr/\u003e\n    \u003ca href=\"https://brightdata.com\"\u003e\n      \u003cimg src=\"https://idsai.net.technion.ac.il/files/2022/01/Logo-600.png\" alt=\"Bright Data\" height=\"120\"/\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\n    \u003csub\u003eThe world's #1 web data platform\u003c/sub\u003e\n  \u003c/p\u003e\n  \n  \u003cbr/\u003e\n  \n  \u003cp\u003e\n    \u003ca href=\"https://github.com/brightdata-com/brightdata-mcp\"\u003e⭐ Star us on GitHub\u003c/a\u003e • \n    \u003ca href=\"https://brightdata.com/blog\"\u003eRead our Blog\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n","funding_links":[],"categories":["Web Scraping","🔌 MCP Servers (Model Context Protocol)","Content Extraction \u0026 Summarization Mcp Servers","📚 Projects (1974 total)","MCP Servers","Official Servers","HarmonyOS","Search \u0026 Data Extraction","Cloud Services","📦 Other","Web Automation and UI Interaction","MCP Servers \u0026 Protocol","JavaScript","Web Scraping (4)"],"sub_categories":["SIEM \u0026 SecOps","MCP Servers","Browser Automation","Windows Manager","How to Submit"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrightdata%2Fbrightdata-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrightdata%2Fbrightdata-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrightdata%2Fbrightdata-mcp/lists"}