Brave Search
Integrates the Brave Search API to provide web and local search capabilities, including news, articles, and business information. It features smart fallbacks from local to web search and supports pagination and freshness controls.
What is Brave Search?
Brave Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to integrates the brave search api to provide web and local search capabilities, including news, articles, and business information. it features smart fallbacks from local to web search and supports pagi...
Integrates the Brave Search API to provide web and local search capabilities, including news, articles, and business information. It features smart fallbacks from local to web search and supports pagination and freshness controls.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Integrates the Brave Search API to provide web and local sea
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @brave/brave-search-mcp-serverManual Installation
npx -y @brave/brave-search-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Brave Search
The Brave Search MCP Server is the official integration from Brave that brings the full Brave Search API into AI assistants via MCP, providing eight distinct search tools covering web search, local business discovery, news, video, images, place lookups, AI summarization, and pre-extracted LLM context. It supports both stdio and HTTP transport modes, includes smart fallback logic from local to web search when local results are sparse, and offers fine-grained control over which tools are active. Developers and researchers use it to ground AI responses in real-time web data without relying on training-cutoff knowledge.
Prerequisites
- Node.js 22.x or later
- A Brave Search API key from https://brave.com/search/api/ (free tier available)
- An MCP client such as Claude Desktop or VS Code with MCP extension
Get a Brave Search API key
Visit https://brave.com/search/api/ and sign up for an API key. The free tier provides 2,000 queries per month. Copy your BRAVE_API_KEY for use in the configuration.
Add the server to your MCP client configuration
Add the Brave Search MCP server to your claude_desktop_config.json using npx. The server runs locally and calls the Brave API with your key.
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server"],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Or use Docker for an isolated environment
Alternatively, run the server via Docker to avoid any local Node.js dependency.
{
"mcpServers": {
"brave-search": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "BRAVE_API_KEY", "docker.io/mcp/brave-search"],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Restart your MCP client
Restart Claude Desktop or your MCP client. The eight Brave Search tools (brave_web_search, brave_local_search, brave_news_search, brave_video_search, brave_image_search, brave_summarizer, brave_place_search, brave_llm_context) will be available.
Optionally restrict which tools are active
Use BRAVE_MCP_ENABLED_TOOLS or BRAVE_MCP_DISABLED_TOOLS environment variables to control which tools Claude can use, reducing the tool surface if desired.
{
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE",
"BRAVE_MCP_ENABLED_TOOLS": "brave_web_search brave_news_search brave_summarizer"
}
}Brave Search Examples
Client configuration
Full claude_desktop_config.json entry for Brave Search MCP Server using npx.
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server"],
"env": {
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY",
"BRAVE_MCP_LOG_LEVEL": "info"
}
}
}
}Prompts to try
Example prompts that exercise the eight Brave Search tools for web, local, news, and AI-summarized results.
- "Search the web for the latest news about MCP server integrations"
- "Find coffee shops near downtown Seattle with good reviews"
- "What are the top tech news stories from the past 24 hours?"
- "Search for videos explaining how transformers work in machine learning"
- "Give me an AI-summarized answer to: what is the current state of fusion energy?"
- "Find the address and hours for Apple Store locations in Chicago"Troubleshooting Brave Search
401 or 403 errors when performing searches
Verify your BRAVE_API_KEY is valid and active in the Brave Search API dashboard. The key must be passed exactly in the env block — check for accidental spaces or newlines.
Local search returns no results and falls back to web
This is expected behavior — brave_local_search automatically falls back to web search when local results are insufficient. If you need strictly local results, check that your query includes a specific city or region.
Server fails to start with Node.js version error
Brave Search MCP Server requires Node.js 22.x or higher. Run 'node --version' to check your version and upgrade via https://nodejs.org if needed.
Frequently Asked Questions about Brave Search
What is Brave Search?
Brave Search is a Model Context Protocol (MCP) server that integrates the brave search api to provide web and local search capabilities, including news, articles, and business information. it features smart fallbacks from local to web search and supports pagination and freshness controls. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Brave Search?
Install via npm with the command: npx -y @brave/brave-search-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Brave Search?
Brave Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Brave Search free to use?
Yes, Brave Search is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Brave Search Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Brave Search? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Brave Search in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Brave Search?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.