Skip to main content
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.
Yes, there is a limit of 5000 request per month.
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.
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:
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
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
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
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
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
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
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:
{
  "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>"
      }
    }
  }
}
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
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!
You can connect your AI agent with bright data by:
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.
Yes! Bright Data provid a free tier for our new MCP users
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 
      {
  "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.