Brave Search MCP Server (official)

Brave's official server for web, news, image, video and local search on the independent Brave Search index. The maintained successor to the original reference server; requires a Brave Search API key.

Local (stdio)Credential

Set up Brave Search MCP Server

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-official --env BRAVE_API_KEY="$BRAVE_API_KEY" -- npx -y @brave/brave-search-mcp-server

Cursor

Merge into ~/.cursor/mcp.json

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

Codex

Run in your terminal.

codex mcp add brave-search-official --env BRAVE_API_KEY="$BRAVE_API_KEY" -- npx -y @brave/brave-search-mcp-server

Gemini CLI

Merge into ~/.gemini/settings.json

{
  "mcpServers": {
    "brave-search-official": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server"
      ],
      "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-official": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@brave/brave-search-mcp-server"
      ],
      "enabled": true,
      "environment": {
        "BRAVE_API_KEY": "REPLACE_WITH_BRAVE_API_KEY"
      }
    }
  }
}

VS Code

Merge into .vscode/mcp.json

{
  "servers": {
    "brave-search-official": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server"
      ],
      "env": {
        "BRAVE_API_KEY": "${input:BRAVE_API_KEY}"
      }
    }
  },
  "inputs": [
    {
      "id": "BRAVE_API_KEY",
      "type": "promptString",
      "description": "BRAVE_API_KEY",
      "password": true
    }
  ]
}

Using more than one server?Add to a config with other servers

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

The Brave Search MCP Server is Brave's own implementation, published as @brave/brave-search-mcp-server and maintained in brave/brave-search-mcp-server. It takes over from the archived reference server that this registry lists as brave-search. Version 2.1.4 shipped on 17 September 2026.

It gives an agent search results from Brave's independent index, not a reseller of another engine. The tools are brave_web_search, brave_news_search, brave_image_search, brave_video_search, brave_local_search and brave_place_search, plus brave_summarizer and brave_llm_context for condensed answers and model-ready context. Some features depend on your Brave Search API plan: full local search needs a Pro plan and otherwise falls back to web search, and extra snippets are Pro-only.

The example runs the package locally with npx -y @brave/brave-search-mcp-server over stdio, which is the default transport. It needs a BRAVE_API_KEY from the Brave Search API dashboard; set it in your shell before running the CLI commands, or let VS Code prompt for it. Setting BRAVE_MCP_TRANSPORT to http runs it as an HTTP server instead. Queries are sent to Brave under your key and count toward its usage limits, so treat the key like any other paid credential.

Example tools

  • brave_web_search
  • brave_news_search
  • brave_local_search
  • brave_image_search
  • brave_video_search
  • brave_summarizer

Tool names are upstream examples. The server's live tool list can differ.

Browse 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.