Brave Search

v2.0.58Search & Data Extractionstable

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.

apibravemcpsearch
Share:
1,060
Stars
0
Downloads
0
Weekly
0/5

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

Search the web using Brave Search API for news and articles.
Access business information and local search results.
Control search freshness and pagination.
brave

Maintainer

LicenseMIT
Languagetypescript
Versionv2.0.58
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @brave/brave-search-mcp-server

Manual Installation

npx -y @brave/brave-search-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

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
1

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.

2

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"
      }
    }
  }
}
3

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"
      }
    }
  }
}
4

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.

5

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.

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.

Quick Config Preview

{ "mcpServers": { "brave-search-mcp-server": { "command": "npx", "args": ["-y", "@brave/brave-search-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides