Brave Search MCP Server

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

claude mcp add --env BRAVE_API_KEY=your-value --transport stdio brave-search-mcp-server -- npx -y @brave/brave-search-mcp-server

{
  "mcpServers": {
    "brave-search-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server"
      ],
      "env": {
        "BRAVE_API_KEY": "your-value"
      }
    }
  }
}

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

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• query

  Search terms (max 400 chars, 50 words)

• country

  Country code (default: "US")

• search_lang

  Search language (default: "en")

• ui_lang

  UI language (default: "en-US")

• count

  Results per page (1-20, default: 10)

• offset

  Pagination offset (max 9, default: 0)

• safesearch

  Content filtering ("off", "moderate", "strict", default: "moderate")

• freshness

  Time filter ("pd", "pw", "pm", "py", or date range)

• text_decorations

  Include highlighting markers (default: true)

• spellcheck

  Enable spell checking (default: true)

• result_filter

  Filter result types (default: ["web", "query"])

• goggles

  Custom re-ranking definitions

• units

  Measurement units ("metric" or "imperial")

• extra_snippets

  Get additional excerpts (Pro plans only)

• summary

  Enable summary key generation for AI summarization

• entity_info

  Include entity information (default: false)

• inline_references

  Add source URL references (default: false)

• latitude

  Latitude of the search center (-90 to 90). Typically paired with longitude.

• longitude

  Longitude of the search center (-180 to 180). Typically paired with latitude.

• location

  Location string used as an alternative to latitude/longitude. For US locations prefer the form (e.g., san francisco ca…

• radius

  Search radius around the supplied coordinates, in meters. If omitted, the search is performed globally.

• geoloc

  Optional geolocation token used to refine results.

• api-version

  Brave API version (YYYY-MM-DD)

• accept

  Response media type (application/json or /)

• cache-control

  Use no-cache to request fresh content

• user-agent

  User agent originating the request

• maximum_number_of_urls

  Maximum number of URLs to include (1-50)

• maximum_number_of_tokens

  Approximate maximum number of context tokens (1024-32768)

• maximum_number_of_snippets

  Maximum number of snippets to include (1-256)

• context_threshold_mode

  Threshold mode ("disabled", "strict", "lenient", "balanced")

• maximum_number_of_tokens_per_url

  Maximum tokens per URL (512-8192)

• maximum_number_of_snippets_per_url

  Maximum snippets per URL (1-100)

• enable_local

  Enable local recall

• enable_source_metadata

  Include source metadata enrichment

• x-loc-lat

  Client latitude (-90 to 90)

• x-loc-long

  Client longitude (-180 to 180)

• x-loc-city

  Client city name

• x-loc-state

  Client state or region code

• x-loc-state-name

  Client state or region name

• x-loc-country

  Client country code

An MCP server implementation that integrates the Brave Search API, providing comprehensive search capabilities including web search, local business search, place search, image search, video search, news search, LLM context, and AI-powered summarization. This project supports both STDIO and HTTP transports, with STDIO as the default mode.