WEB SEARCH / Brave
Brave Search MCP
Provides web, news, image, video and place search using the Brave Search API.
“This project supports both STDIO and HTTP transports, with STDIO as the default mode.”
01 / THE REASONING
Why this made the selection.
- A publisher-maintained replacement for the archived reference Brave adapter.
- Documents transport defaults, tool selection and secret-file support for API credentials.
- The pinned README is Brave's search API behind MCP, covering web, news, image, video, and local queries.
- HTTP mode binds to loopback unless the host is changed, and a Brave API key is required.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- README.md setup, configuration and operating-limit sections at e4866a959a635038f8f889804aba6061ed214bf4
- LICENSE at the same revision
- package.json
- src/index.ts
- src/server.ts
- src/protocols/http.ts
- README.md
- LICENSE
- Round 2 reread of acquired publisher setup and permission evidence; see immutable wave review.
Our findings
- The README and HTTP transport distinguish loopback binding, origin validation and optional Host validation from actual authentication.
- The selected configuration uses the documented tool allowlist; BRAVE_API_KEY_FILE has precedence over BRAVE_API_KEY.
- The server calls the Brave Search API and now defaults to stdio; HTTP requires BRAVE_MCP_TRANSPORT or --transport http.
- The HTTP host defaults to 127.0.0.1 and binds to loopback only until set otherwise, and browser origins outside the allowlist are rejected.
- A Brave API key is required. Local search needs a Pro plan for the full response and otherwise falls back to web search. Version 2 no longer returns base64 image bytes.
- BRAVE_MCP_DISABLED_TOOLS is a space-separated tool blacklist; search response options include a distinct context-threshold mode.
Not established by this review
- Server startup, authentication and live tool calls were not tested.
- Published package/container parity with the inspected source commit and security isolation were not tested.
- The server was not started and its tools were not called.
- A pin does not verify transitive dependencies.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
npx -y @brave/brave-search-mcp-server --transport stdio Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Configure BRAVE_API_KEY or BRAVE_API_KEY_FILE in the client/server environment.
- Select the needed tools and retain local stdio unless a controlled HTTP deployment is intended.
- The command above is the command and args of the README’s VS Code NPX block (npx with -y @brave/brave-search-mcp-server --transport stdio), not a separate installer. It was not run.
Before you start
- Node.js and a Brave Search API account/key.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"inputs": [
{
"password": true,
"id": "brave-api-key",
"type": "promptString",
"description": "Brave Search API Key",
}
],
"servers": {
"brave-search-mcp-server": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
"env": {
"BRAVE_API_KEY": "${input:brave-api-key}"
}
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/README.md
Supports: summary, upstreamDescription, install, configExample, access, limitations, bestFor, review
https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/LICENSE
Supports: license
https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/package.json
Supports: review, install, language
https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/src/index.ts
Supports: review, install, language
https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/src/server.ts
Supports: review, install, language
https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/src/protocols/http.ts
Supports: review, install, language