Brave Search MCP Server
About
# Brave Search MCP Server An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities. ## Features - **Web Search**: General queries, news, articles, with pagination and freshness controls - **Local Search**: Find businesses, restaurants, and services with…
Explore
- Web Search: General queries, news, articles, with pagination and freshness controls
- Local Search: Find businesses, restaurants, and services with detailed information
- Flexible Filtering: Control result types, safety levels, and content freshness
- Smart Fallbacks: Local search automatically falls back to web when no results are found
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Brave Search MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Sign up for a Brave Search API account
2. Choose a plan (Free tier available with 2,000 queries/month)
3. Generate your API key from the developer dashboard
Add this to your claude_desktop_config.json:
For quick installation, use the one-click installation buttons below...
For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).
Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.
> Note that the mcp key is not needed in the .vscode/mcp.json file.
query
(string): Search terms
count
(number, optional): Results per page (max 20)
offset
(number, optional): Pagination offset (max 9)
- brave_web_search
- Execute web searches with pagination and filtering
- Inputs:
- query (string): Search terms
- count (number, optional): Results per page (max 20)
- offset (number, optional): Pagination offset (max 9)
- brave_local_search
- Search for local businesses and services
- Inputs:
- query (string): Local search terms
- count (number, optional): Number of results (max 20)
- Automatically falls back to web search if no local results found
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"brave search mcp server": {
"portfolio-mcp-server": {
"command": "docker",
"args": [
"build",
"-t",
"mcp/brave-search:latest",
"-f",
"src/brave-search/Dockerfile",
"."
]
}
}
}
}McpServers
{
"portfolio-mcp-server": {
"command": "docker",
"args": [
"build",
"-t",
"mcp/brave-search:latest",
"-f",
"src/brave-search/Dockerfile",
"."
]
}
}An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.
Features
- Web Search: General queries, news, articles, with pagination and freshness controls
- Local Search: Find businesses, restaurants, and services with detailed information
- Flexible Filtering: Control result types, safety levels, and content freshness
- Smart Fallbacks: Local search automatically falls back to web when no results are found
Tools
- brave_web_search
- Execute web searches with pagination and filtering
- Inputs:
- query (string): Search terms
- count (number, optional): Results per page (max 20)
- offset (number, optional): Pagination offset (max 9)
- brave_local_search
- Search for local businesses and services
- Inputs:
- query (string): Local search terms
- count (number, optional): Number of results (max 20)
- Automatically falls back to web search if no local results found
Configuration
Getting an API Key
1. Sign up for a Brave Search API account
2. Choose a plan (Free tier available with 2,000 queries/month)
3. Generate your API key from the developer dashboard
Usage with Claude Desktop
Add this to your claude_desktop_config.json:
Docker
{
"mcpServers": {
"brave-search": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BRAVE_API_KEY",
"mcp/brave-search"
],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
NPX
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-brave-search"
],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
Usage with VS Code
For quick installation, use the one-click installation buttons below...
For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).
Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.
> Note that the mcp key is not needed in the .vscode/mcp.json file.
Docker
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "brave_api_key",
"description": "Brave Search API Key",
"password": true
}
],
"servers": {
"brave-search": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BRAVE_API_KEY",
"mcp/brave-search"
],
"env": {
"BRAVE_API_KEY": "${input:brave_api_key}"
}
}
}
}
}
NPX
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "brave_api_key",
"description": "Brave Search API Key",
"password": true
}
],
"servers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "${input:brave_api_key}"
}
}
}
}
}
Build
Docker build:
docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
