Skip to content

Releases: brightdata/brightdata-mcp

v2.11.0

16 Jun 09:28

Choose a tag to compare

What's Changed

Added

  • web_data_reddit_comments — structured Reddit comments by
    post/thread URL, with optional days_back filter. Dataset
    gd_lvzdpsdlw09j6t702. Completes Reddit parity alongside
    web_data_reddit_posts. (#154)

Note: this is the first GitHub Release since v2.11.0's predecessor
v2.9.3, so it also rolls up the changes below from v2.10.0 / v2.9.x.

Added (since v2.9.3)

  • search_dataset — search supported datasets by filter and get
    matching records directly via the fast search API. (#142)
  • list_dataset_fields — discover a dataset's filterable fields
    (name, type, description) before building a filter. (#142)
  • discover — discovery tool for finding sources/pages by intent.
    (#130)

v2.9.3

29 Mar 16:16
41e90c1

Choose a tag to compare

v2.9.3

  • New code tool group - your coding agent's companion
    • web_data_npm_package - look up any npm package by name and get back
      structured metadata: latest version, README, dependencies, and more
      (e.g. @brightdata/sdk, express, fastify)
    • web_data_pypi_package - look up any PyPI package by name and get back
      structured metadata: latest version, README, dependencies, and more
      (e.g. langchain-brightdata, requests, numpy)
    • Enable with GROUPS="code" - works with Claude Code, Cursor, Windsurf,
      and any MCP-powered coding agent
  • Added code group row to the tool groups table in README
  • Added coding agent configuration example in README

Why this matters

Coding agents constantly need to answer questions like "what's the latest
version of X?"
or "what does this package do?". Until now that meant
scraping registry pages or relying on stale training data. The code group
gives agents a single, reliable tool to query npm and PyPI directly —
structured data, no scraping, no blocking, always up to date.

v2.8.6

01 Mar 08:28

Choose a tag to compare

What's New

scrape_batch now returns minified markdown, consistent with scrape_as_markdown.
Decorative markdown formatting is stripped from each scraped page while preserving links, code blocks, and inline code - reducing token usage when processing multiple URLs in a single call.

v2.8.5

25 Feb 07:26

Choose a tag to compare

v2.8.5 - Geo-targeted Search

Geo-targeted SERP results

Both search_engine and search_engine_batch now accept an optional geo_location parameter - a 2-letter country code (e.g. "us", "uk", "de") that lets you retrieve Google search results as seen from a specific country.

Example: Search for "best laptops" as seen from Germany:

{ "query": "best laptops", "engine": "google", "geo_location": "de" }

v2.8.3

18 Jan 11:18

Choose a tag to compare

Release Notes - v2.8.3

Release Date: January 18, 2026

New Features

Configurable Polling Timeout

  • Introduced POLLING_TIMEOUT environment variable for dataset collection timeout configuration
  • Default timeout: 600 seconds (10 minutes)
  • Allows users to customize timeout based on their specific needs
  • Applies to all web data collection tools

Browser Tools Country Targeting

  • Added optional country targeting support to browser automation tools
  • Enables geo-specific browser sessions for testing localized content
  • Configurable via country parameter in browser tool calls

Improvements

Batch Operation Optimizations

  • Reduced batch size limits from 10 to 5 for search_engine_batch and scrape_batch tools
  • Updated tool descriptions to reflect new batch size constraints
  • Improved reliability and performance of batch operations
  • Changed batch operations to use Promise.allSettled() for better error handling

Polling Status Fixes

  • Fixed polling status handling for dataset collection tools
  • Improved error handling during data collection polling
  • Better reliability when waiting for dataset snapshots

MCPB Bundle Update

  • Updated MCPB bundle to v2.7.1
  • Fixed handling of optional environment variables that could crash the server when unset
  • Improved server stability and configuration handling

Configuration

New Environment Variables

# Optional: Configure polling timeout (default: 600 seconds)
POLLING_TIMEOUT=600

v2.8.1

15 Jan 15:53

Choose a tag to compare

Release Notes - v2.8.1

New Features

Tool Annotations for Enhanced LLM Understanding (#97)

  • Added comprehensive tool annotations to improve how LLMs interpret and use Bright Data tools
  • Enhanced tool descriptions and parameter metadata across browser and server tools
  • Improved tool understanding for better autonomous agent performance

Browser Form Filling Tool (#96)

  • Introduced scraping_browser_fill_form tool for efficient automated form filling
  • Enables streamlined form interaction in browser automation workflows
  • Added to browser tool group for enhanced web automation capabilities

Country Targeting Support (#92)

  • Added optional country parameter to browser tools for geo-targeted scraping
  • Enables region-specific data collection and testing
  • Seamlessly integrated with existing browser tool interfaces

CI/CD Improvements

Test Workflow (#79)

  • Added automated test workflow for continuous integration
  • Includes server health tests
  • Ensures code quality and stability before releases

v2.8.0

07 Jan 08:20

Choose a tag to compare

Release Notes - v2.8.0 🚀

Token Optimization

This release focuses on reducing token consumption for AI agents, making interactions more efficient and cost-effective.

Changes

Search Engine Improvements

  • Switched web search results to parsed_light format for leaner responses
  • Cleaned up search payloads to return only essential fields (link, title, description)
  • Removed unnecessary fields like images, pagination, related, and ai_overview from search results

Markdown Minification

  • Added markdown stripping for scrape_as_markdown responses using remark and strip-markdown
  • Preserves essential elements (links, code blocks) while removing formatting overhead
  • Achieves 30-60% reduction in tool response tokens

Data Sanitization

  • Removed null values from dataset API responses to reduce payload size

New Dependencies

  • remark: ^15.0.1
  • strip-markdown: ^6.0.0

MCP Evaluations Framework

We've added a comprehensive evaluations suite powered by mcpjam to validate agent behavior before production.

Structure

mcp-evals/
├── server-configs/           # Server connection configs per tool group
├── tool-groups.json/         # Test cases per tool group
└── llms.json                 # LLM provider API keys

Coverage

Eval suites for all 8 Tool Groups:

  • ecommerce - Amazon, Walmart, Best Buy product searches
  • social - TikTok, Instagram, Twitter content
  • business - LinkedIn profiles, Crunchbase, Google Maps
  • research - GitHub repos, Reuters news, academic sources
  • finance - Stock data, market trends
  • app_stores - iOS App Store, Google Play
  • browser - Scraping Browser automation
  • advanced_scraping - Batch operations, custom scraping

Quick Start

# Install mcpjam
npm install -g @mcpjam/cli

# Run e-commerce evals
mcpjam evals run \
  -t mcp-evals/tool-groups.json/tool-groups.ecommerce.json \
  -e mcp-evals/server-configs/server-config.ecommerce.json \
  -l mcp-evals/llms.json

Performance Impact

Combined with Tool Groups and Custom Tools from previous releases:

Configuration Total Tokens Cost Reduction
Full Suite (No Optimization) 37,500 -
+ Tool Groups 28,500 24%
+ Custom Tools 24,750 34%
+ Token Optimization (v2.8.0) 14,500 61%

Resources

v2.7.0

16 Dec 07:50

Choose a tag to compare

What's New

Tool Groups System

Introducing flexible tool selection with curated groups! Instead of choosing between Rapid (limited) and Pro (everything), you can now:

  • Mix and match tool groups using GROUPS environment variable
  • Add individual tools via the TOOLS variable
  • 9 curated groups: ecommerce, social, browser, finance, business, research, app_stores, travel, advanced_scraping

Example configuration:

{
  "env": {
    "GROUPS": "browser,ecommerce",
    "TOOLS": "scrape_as_markdown"
  }
}

All Changes

Features

  • Add tool groups system with 9 curated categories (c23af1b)

🚀 Upgrade Guide

No breaking changes! Existing configurations continue to work:

  • PRO_MODE=true still enables all tools
  • Default Rapid mode unchanged
  • New GROUPS/TOOLS variables are optional

v2.6.2

01 Dec 13:46

Choose a tag to compare

Bright Data MCP Server - Release 2.6.2

Release Date: Dec 1, 2025

  • Added DOM-based interactive element capture with stable data-fastmcp-ref refs, improving click/scroll/type tooling on custom clickable elements not present in the filtered ARIA snapshot.
  • Extended snapshot output to include a compact “DOM Interactive Elements” section when available.
  • scraping_browser_snapshot now accepts filtered (default: false) to choose between raw and compacted snapshots.

v2.6.1

17 Nov 06:58

Choose a tag to compare

Bright Data MCP Server - Release 2.6.1

Release Date: Nov 16, 2025

  • Pinned @modelcontextprotocol/sdk to 1.21.2 to avoid the completions capability mismatch that caused “Server does not support completions” on fresh installs.

  • No other changes.