← Explore all mcp servers

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.

Upstream setup instructions ↗

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.

  1. Configure BRAVE_API_KEY or BRAVE_API_KEY_FILE in the client/server environment.
  2. Select the needed tools and retain local stdio unless a controlled HTTP deployment is intended.
  3. 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.

  1. https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/README.md

    Supports: summary, upstreamDescription, install, configExample, access, limitations, bestFor, review

  2. https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/LICENSE

    Supports: license

  3. https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/package.json

    Supports: review, install, language

  4. https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/src/index.ts

    Supports: review, install, language

  5. https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/src/server.ts

    Supports: review, install, language

  6. https://github.com/brave/brave-search-mcp-server/blob/e4866a959a635038f8f889804aba6061ed214bf4/src/protocols/http.ts

    Supports: review, install, language

Evidence & Ask