Brave Search MCP reference server (archived)
Archived reference implementation; no longer maintained. Private web search and local business search powered by the independent Brave Search global index.
Local (stdio)CredentialArchived upstream
Archived upstream. This server is no longer maintained by its authors and receives no fixes or security updates. The configuration below is kept for existing users; review the upstream notice before installing it. For new setups, see the maintained Brave Search MCP Server listing.
Set up Brave Search
Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.
Claude Code
Run in your terminal.
claude mcp add brave-search --env BRAVE_API_KEY="$BRAVE_API_KEY" -- npx -y @modelcontextprotocol/server-brave-search
Cursor
Merge into ~/.cursor/mcp.json
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-brave-search"
],
"env": {
"BRAVE_API_KEY": "REPLACE_WITH_BRAVE_API_KEY"
}
}
}
}
Codex
Run in your terminal.
codex mcp add brave-search --env BRAVE_API_KEY="$BRAVE_API_KEY" -- npx -y @modelcontextprotocol/server-brave-search
Gemini CLI
Merge into ~/.gemini/settings.json
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-brave-search"
],
"env": {
"BRAVE_API_KEY": "REPLACE_WITH_BRAVE_API_KEY"
}
}
}
}
OpenCode
Merge into ~/.config/opencode/opencode.jsonc
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"brave-search": {
"type": "local",
"command": [
"npx",
"-y",
"@modelcontextprotocol/server-brave-search"
],
"enabled": true,
"environment": {
"BRAVE_API_KEY": "REPLACE_WITH_BRAVE_API_KEY"
}
}
}
}
VS Code
Merge into .vscode/mcp.json
{
"servers": {
"brave-search": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-brave-search"
],
"env": {
"BRAVE_API_KEY": "${input:BRAVE_API_KEY}"
}
}
},
"inputs": [
{
"id": "BRAVE_API_KEY",
"type": "promptString",
"description": "BRAVE_API_KEY",
"password": true
}
]
}
Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, the Cursor JSON goes in claude_desktop_config.json. This is a local server that runs on your machine; see remote vs local servers and authentication and security basics.
Overview
This Brave Search server was a Model Context Protocol reference implementation, published as @modelcontextprotocol/server-brave-search. It is now in the servers-archived repository, which states that the archived servers are no longer maintained and come with no security guarantees.
The server connected an agent to the Brave Search API, which is built on Brave's independent search index. It had two tools. brave_web_search ran general web queries, including news and articles, with pagination and freshness controls. brave_local_search looked up local businesses and services, and fell back to a web search when no local results were found. The use case was simple: give a model without built-in browsing a way to look things up on the live web.
Setup caveats: you need a Brave Search API key, provided as the BRAVE_API_KEY environment variable. The snippets below read it from your environment or use a placeholder. Brave's API requires choosing a plan; upstream noted a free tier of 2,000 queries a month, but check Brave's current terms. Search results pulled into a conversation are untrusted web content. As an archived package it will not receive fixes, so prefer a maintained search integration for new work. We keep this page so people who already run it can find their configuration and its status in one place.
Example tools
brave_web_searchbrave_local_search
Tool names are upstream examples. The server's live tool list can differ.
Related Developer Tools servers
Sources
This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.