Releases: brightdata/brightdata-mcp
v2.11.0
What's Changed
Added
web_data_reddit_comments— structured Reddit comments by
post/thread URL, with optionaldays_backfilter. 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
v2.9.3
- New
codetool group - your coding agent's companionweb_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
codegroup 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
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
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
Release Notes - v2.8.3
Release Date: January 18, 2026
New Features
Configurable Polling Timeout
- Introduced
POLLING_TIMEOUTenvironment 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_batchandscrape_batchtools - 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=600v2.8.1
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_formtool 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
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_lightformat for leaner responses - Cleaned up search payloads to return only essential fields (
link,title,description) - Removed unnecessary fields like
images,pagination,related, andai_overviewfrom search results
Markdown Minification
- Added markdown stripping for
scrape_as_markdownresponses usingremarkandstrip-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.1strip-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.jsonPerformance 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
- Full Launch Week Documentation
- mcpjam CLI - Official MCP evaluation framework
- Bright Data Control Panel - Access Observability Dashboard
v2.7.0
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
GROUPSenvironment variable - Add individual tools via the
TOOLSvariable - 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
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.