Bright Data Docs home pagelight logodark logo
  • Support
  • Sign up
  • Sign up
Welcome
Proxy Infrastructure
Web Access APIs
Data Feeds
MCP Server
API Reference
General
Integrations
MCP Server
Free Tier
  • Overview
  • Quick Start
  • Tools
  • Usage Examples
  • FAQs
MCP Clients
  • Claude
  • CrewAI
  • Cursor
  • LlamaIndex
  • OpenAI
MCP Server

FAQ: MCP

Find answers to common questions about integrating, configuring, and using Bright Data’s MCP server.

What is Bright Data MCP Server?

how to set country for browser api mcpBright Data MCP (Model Context Protocol) is a server that enables LLMs, AI agents, and applications to access, discover, and extract web data in real-time.
It allows MCP clients like Claude Desktop, Cursor, and Windsurf to search the web, navigate websites, take actions, and retrieve data without getting blocked, making it perfect for web scraping tasks.

*For our new MCP users, we are offering a FREE tier

The MCP server provides advanced capabilities, including:
  • Bypassing geo-restrictions to access content regardless of location
  • Navigating websites with bot detection protection using unlocker technology
  • Structured data extraction from platforms like Amazon, LinkedIn, Instagram, and many other data feeds
  • Remote browser automation for complex web interactions
  • Access to a global IP network to avoid blocking or rate limiting Get started with Bright Data MCP:
  1. Explore the MCP GitHub repository to review the source code, contribute, or deploy your own instance.
  2. Read the MCP documentation to understand the API, request structure, and supported features.
  3. Get your API key
  4. Try out the MCP Smithery playground to test and experiment with live requests in a no-code environment.

There are limitations for Bright Data free tier?

Yes, there is a limit of 5000 request per month.

Where do I get my API keys?

You can get your API token from the user settings page in your Bright Data account. Make sure you have an account on brightdata.com - new users get free credit for testing, and pay-as-you-go options are available after that.

How do I use Bright Data MCP Server?

Bright Data MCP (Model Context Protocol) is a local server that allows AI agents, LLMs, and dev tools to access and extract real-time web data using Bright Data’s infrastructure.To get started: BrightData-MCPHelpful links:
  • MCP GitHub Repository
  • MCP API Documentation
  • Try MCP in Smithery Playground

What can I do with Bright Data MCP Server?

Bright Data MCP allows you to integrate real-time web access into your AI agents or dev tools. It supports:** Search & Scraping:**
  • search_engine: Search Google, Bing, Yandex
  • scrape_as_markdown, scrape_as_html: Get content in clean formats
  • session_stats: Monitor tool usage
** Structured Data Extraction:**
  • Amazon: web_data_amazon_product, web_data_amazon_product_reviews
  • LinkedIn: web_data_linkedin_person_profile, web_data_linkedin_company_profile
  • Instagram: web_data_instagram_profiles, web_data_instagram_posts, web_data_instagram_reels
  • Facebook: web_data_facebook_posts, web_data_facebook_marketplace_listings
  • Others: web_data_x_posts, web_data_youtube_videos, web_data_zillow_properties_listing
** Browser Automation:**
  • scraping_browser_navigate, scraping_browser_click, scraping_browser_type
  • scraping_browser_get_html, scraping_browser_screenshot, scraping_browser_wait_for
🔗 Full list of tools: MCP Tools on GitHub

Which AI agents and tools can integrate with Bright Data MCP Server?

Bright Data MCP is designed to work with a wide range of AI tools and agents, including:
  • Claude Desktop (Anthropic)
  • Cursor IDE
  • Windsurf
  • LangChain
  • AutoGPT / AgentGPT
  • Smithery
  • Custom LLMs or AI agents that support HTTP requests
These tools can use MCP to:
  • Perform real-time web searches
  • Scrape structured data
  • Automate browser interactions
  • Access geo-restricted or protected content
Try it live: Smithery Playground

How do I enable browser control tools?

To enable browser control tools:
  1. Visit your Bright Data control panel at brightdata.com/cp/zones
  2. Create a new ‘Browser API’ zone
  3. Once created, copy the authentication string from the Browser API overview tab
  4. The authentication string will be formatted like: brd-customer-[your-customer-ID]-zone-[your-zone-ID]:[your-password]
  5. Add this authentication string to your MCP configuration as the BROWSER_AUTH environment variable

What tools are available in the Bright Data MCP Server?

For the full list of tools, please refer to our GitHub repo: MCP Tools Bright Data MCP offers a comprehensive set of tools, including: Search and basic scraping:
  • search_engine: Scrape search results from Google, Bing or Yandex
  • scrape_as_markdown: Scrape a webpage and get results in Markdown format
  • scrape_as_html: Scrape a webpage and get results in HTML format
  • session_stats: View tool usage during the current session Structured data extraction:
  • Amazon: web_data_amazon_product, web_data_amazon_product_reviews
  • LinkedIn: web_data_linkedin_person_profile, web_data_linkedin_company_profile
  • ZoomInfo: web_data_zoominfo_company_profile
  • Instagram: web_data_instagram_profiles, web_data_instagram_posts, web_data_instagram_reels, web_data_instagram_comments
  • Facebook: web_data_facebook_posts, web_data_facebook_marketplace_listings, web_data_facebook_company_reviews
  • Various others: web_data_x_posts, web_data_zillow_properties_listing, web_data_booking_hotel_listings, web_data_youtube_videos Browser automation:
  • scraping_browser_navigate: Navigate to a URL
  • scraping_browser_go_back/scraping_browser_go_forward: Navigate browser history
  • scraping_browser_click: Click on an element
  • scraping_browser_links: Get all links on the current page
  • scraping_browser_type: Type text into an element
  • scraping_browser_wait_for: Wait for an element to appear
  • scraping_browser_screenshot: Take a screenshot
  • scraping_browser_get_html/scraping_browser_get_text: Get page content

How do I handle timeout issues when using Bright Data MCP Server?

Some web data tools can take longer to execute, especially when dealing with complex websites. To ensure your agent can consume the data:
  1. Set a high enough timeout in your agent settings (180 seconds is recommended for 99% of requests)
  2. For particularly slow sites, you may need to increase this value further
  3. Use the specialized web_data_* tools when available, as they’re often faster than general scraping
  4. For browser automation sequences, keep operations close together in time

What security considerations should I keep in mind?

Always treat scraped web content as untrusted data. Never use raw scraped content directly in LLM prompts to avoid potential prompt injection risks. Instead:
  • Filter and validate all web data before passing it to the LLM
  • Use structured data extraction rather than raw text when possible
  • Be cautious with executing JavaScript from scraped content

Why am I getting a 'spawn npx ENOENT' error?

This error occurs when your system cannot find the npx command. To fix it:
  1. Find your Node.js path:
    • On macOS: Run which node in Terminal
    • On Windows: Run where node in Command Prompt
  2. Update your MCP configuration to use the full path instead of npx:
Copy
{
  "mcpServers": {
    "Bright Data": {
      "command": "/usr/local/bin/node", // Replace with your actual Node.js path
      "args": ["node_modules/@brightdata/mcp/index.js"],
      "env": {
        "API_TOKEN": "<your-api-token>"
      }
    }
  }
}

How do I monitor my usage and costs?

You can use the session_stats tool to check your usage during the current session. For comprehensive usage tracking and billing information, log in to your Bright Data account dashboard. The session_stats tool will show you information about:
  • Number of requests made during the current session
  • Tools used and their frequency

Is there a playground where I can try Bright Data MCP Server?

Yes, you can try Bright Data MCP without any setup using the playground on Smithery. This platform provides an easy way to explore the capabilities of Bright Data MCP without any local setup. Just sign in and start experimenting with web data collection!

How to connect my AI agent with Bright Data's MCP?

You can connect your AI agent with bright data by:
  • Install Node.js package
  • Create A Bright Data account (new users get free credit for testing)
  • And copy your API key from the user settings page (New users receive an API key in the welcome email.)
  • Then configure your agent with your API key. For more detailed examples, visit us on GitHub or check our MCP documentation.

When using MCP, should I create zones or configure them?

No, we will create thoes for you :) All you need is NodeJS and your BrightData API key. If you want to change your zone name to something specific, you always can do it.

There is a free tier for Bright Data MCP?

Yes! Bright Data provid a free tier for our new MCP users

How to set country for browser api mcp?

Currently, the MCP (Model Context Protocol) integration does not support direct country targeting via a dedicated country parameter in the MCP configuration itself. However, you can control the country selection by specifying a custom zone in your MCP setup, and then configure that zone in your Bright Data Control Panel to target the country you want.Here’s how you can achieve country targeting with MCP:
  1. Create a Zone for the Desired Country:
    • In your Bright Data Control Panel, create a new zone (e.g., Residential, Mobile, or Browser API) and set the geolocation targeting to your desired country in the zone’s configuration.
  2. Specify the Zone in Your MCP Configuration:
    • In your MCP client configuration, use the environment variable for the relevant zone:
      • For web scraping: WEB_UNLOCKER_ZONE
      • For browser automation: BROWSER_ZONE
    • Example (for a custom browser zone): json
      Copy
      {
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your_api_key>",
        "BROWSER_ZONE": "<your_zone_name>"
      }
    }
  }
}
    • Make sure <your_zone_name> is the zone you configured for the specific country.
  3. Requests through MCP will now use the country targeting set in your zone.
For more details, see the MCP Server documentation and Browser API location targeting.

Was this page helpful?

Usage ExamplesClaude
linkedinyoutubegithub
Powered by Mintlify
Assistant
Responses are generated using AI and may contain mistakes.