PluginBench
MCP Server
Active
MIT

io.github.brave/brave-search-mcp-server MCP Server

io.github.brave/brave-search-mcp-server

Web, image, video, news, and place search with AI summaries via Brave Search API

RepositoryRegistry
How to choose

What this kind of tool is for

  • Let your agent search the web or a document set and cite what it found.
  • Pull structured facts out of pages instead of copy-pasting by hand.
  • Track changes on a topic over days without re-reading everything.

How to compare servers like this

Source coverage:
Check which engines, sites, or document types the tool can actually reach.
Citation behavior:
Prefer tools that return links you can open, not just summarized claims.
Terms of service:
Some sources forbid automated access; make sure the tool stays inside them.
Maintenance signal:
Scrapers break silently when pages change; recent commits are the best proxy.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the io.github.brave/brave-search-mcp-server MCP server?

The Brave Search MCP Server integrates the Brave Search API to provide comprehensive search capabilities including web search, local business search, place search, image search, video search, news search, and AI-powered summarization. It supports both STDIO and HTTP transports and is designed for AI agents and LLM applications.

This server gives Claude and other AI agents access to real-time web search, image and video results, local business information, news articles, and AI-generated summaries. It's useful for agents that need current information, research capabilities, or location-based data to ground their responses in real-world facts.

How to install io.github.brave/brave-search-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • BRAVE_API_KEY
    required
    secret

    Your API key for the service

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "brave-search-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server"
      ],
      "env": {
        "BRAVE_API_KEY": "<YOUR_BRAVE_API_KEY>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • brave_web_search — Performs comprehensive web searches with rich result types, filtering options, and optional AI summaries
  • brave_local_search — Searches for local businesses and places with ratings, hours, and AI-generated descriptions
  • brave_image_search — Searches for images with metadata including URLs, dimensions, and confidence scores
  • brave_video_search — Searches for videos with comprehensive metadata and thumbnail information
  • brave_news_search — Searches for current news articles with freshness controls and breaking news indicators
  • brave_place_search — Searches for points of interest in a geographic area with structured data including hours, contact info, ratings, and photos
  • brave_summarizer — Generates AI-powered summaries from web search results using Brave's summarization API
  • brave_llm_context — Retrieves pre-extracted web content optimized for AI agents, LLM grounding, and RAG pipelines

Use cases

  • Get real-time web search results to answer current questions and fact-check claims
  • Find local businesses, restaurants, and services with ratings and hours in a specific location
  • Search for images and videos related to a topic with metadata and source URLs
  • Retrieve current news articles on a subject with freshness filtering
  • Generate AI summaries of web search results to provide concise, grounded answers
  • Retrieve optimized context from web sources for RAG and knowledge grounding in LLM applications

io.github.brave/brave-search-mcp-server MCP server FAQ

What is the Brave Search MCP Server?

It's an MCP server that integrates the Brave Search API, giving AI agents access to web search, image/video search, local business search, news, place search, and AI-powered summarization capabilities.

Is it free to use?

The server itself is free and open-source, but requires a Brave Search API key. Brave offers free and paid plans; check brave.com/search/api for pricing details.

How do I install it in Claude Desktop?

Add the server to your claude_desktop_config.json using either NPX or Docker, providing your BRAVE_API_KEY as an environment variable. See the README for exact configuration examples.

How do I install it in VS Code?

Use the one-click installation buttons in the README for VS Code or VS Code Insiders, or manually add the configuration to your User Settings (JSON) or .vscode/mcp.json file.

What authentication is required?

You need a Brave Search API key from https://brave.com/search/api/. Set it via the BRAVE_API_KEY environment variable or BRAVE_API_KEY_FILE for mounted secrets.

What transport modes does it support?

The server supports both STDIO (default) and HTTP transports. Set BRAVE_MCP_TRANSPORT=http to use HTTP mode, or use the --transport flag when launching.

README (reference)

Source of truth, from the repository.

Brave Search MCP Server

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.

Ask DeepWiki

Migration

1.x to 2.x

Default transport now STDIO

To follow established MCP conventions, the server now defaults to STDIO. If you would like to continue using HTTP, you will need to set the BRAVE_MCP_TRANSPORT environment variable to http, or provide the runtime argument --transport http when launching the server.

Response structure of brave_image_search

Version 1.x of the MCP server would return base64-encoded image data along with image URLs. This dramatically slowed down the response, as well as consumed unnecessarily context in the session. Version 2.x removes the base64-encoded data, and returns a response object that more closely reflects the original Brave Search API response. The updated output schema is defined in src/tools/images/schemas/output.ts.

Tools

Web Search (brave_web_search)

Performs comprehensive web searches with rich result types and advanced filtering options.

Parameters:

  • query (string, required): Search terms (max 400 chars, 50 words)
  • country (string, optional): Country code (default: "US")
  • search_lang (string, optional): Search language (default: "en")
  • ui_lang (string, optional): UI language (default: "en-US")
  • count (number, optional): Results per page (1-20, default: 10)
  • offset (number, optional): Pagination offset (max 9, default: 0)
  • safesearch (string, optional): Content filtering ("off", "moderate", "strict", default: "moderate")
  • freshness (string, optional): Time filter ("pd", "pw", "pm", "py", or date range)
  • text_decorations (boolean, optional): Include highlighting markers (default: true)
  • spellcheck (boolean, optional): Enable spell checking (default: true)
  • result_filter (array, optional): Filter result types (default: ["web", "query"])
  • goggles (array, optional): Custom re-ranking definitions
  • units (string, optional): Measurement units ("metric" or "imperial")
  • extra_snippets (boolean, optional): Get additional excerpts (Pro plans only)
  • summary (boolean, optional): Enable summary key generation for AI summarization

Local Search (brave_local_search)

Searches for local businesses and places with detailed information including ratings, hours, and AI-generated descriptions.

Parameters:

  • Same as brave_web_search with automatic location filtering
  • Automatically includes "web" and "locations" in result_filter

Note: Requires Pro plan for full local search capabilities. Falls back to web search otherwise.

Video Search (brave_video_search)

Searches for videos with comprehensive metadata and thumbnail information.

Parameters:

  • query (string, required): Search terms (max 400 chars, 50 words)
  • country (string, optional): Country code (default: "US")
  • search_lang (string, optional): Search language (default: "en")
  • ui_lang (string, optional): UI language (default: "en-US")
  • count (number, optional): Results per page (1-50, default: 20)
  • offset (number, optional): Pagination offset (max 9, default: 0)
  • spellcheck (boolean, optional): Enable spell checking (default: true)
  • safesearch (string, optional): Content filtering ("off", "moderate", "strict", default: "moderate")
  • freshness (string, optional): Time filter ("pd", "pw", "pm", "py", or date range)

Image Search (brave_image_search)

Searches for images with metadata including URLs, dimensions, and confidence scores.

Parameters:

  • query (string, required): Search terms (max 400 chars, 50 words)
  • country (string, optional): Country code (default: "US")
  • search_lang (string, optional): Search language (default: "en")
  • count (number, optional): Results per page (1-200, default: 50)
  • safesearch (string, optional): Content filtering ("off", "strict", default: "strict")
  • spellcheck (boolean, optional): Enable spell checking (default: true)

News Search (brave_news_search)

Searches for current news articles with freshness controls and breaking news indicators.

Parameters:

  • query (string, required): Search terms (max 400 chars, 50 words)
  • country (string, optional): Country code (default: "US")
  • search_lang (string, optional): Search language (default: "en")
  • ui_lang (string, optional): UI language (default: "en-US")
  • count (number, optional): Results per page (1-50, default: 20)
  • offset (number, optional): Pagination offset (max 9, default: 0)
  • spellcheck (boolean, optional): Enable spell checking (default: true)
  • safesearch (string, optional): Content filtering ("off", "moderate", "strict", default: "moderate")
  • freshness (string, optional): Time filter (default: "pd" for last 24 hours)
  • extra_snippets (boolean, optional): Get additional excerpts (Pro plans only)
  • goggles (array, optional): Custom re-ranking definitions

Summarizer Search (brave_summarizer)

Generates AI-powered summaries from web search results using Brave's summarization API.

Parameters:

  • key (string, required): Summary key from web search results (use summary: true in web search)
  • entity_info (boolean, optional): Include entity information (default: false)
  • inline_references (boolean, optional): Add source URL references (default: false)

Usage: First perform a web search with summary: true, then use the returned summary key with this tool.

Place Search (brave_place_search)

Searches for points of interest (POIs) in a specified geographic area using Brave's Place Search API. Returns rich, structured place data including name, address, opening hours, contact info, ratings, photos, categories, and timezone.

Parameters:

  • query (string, optional): Query string used to refine the POI search (max 400 chars, 50 words). When omitted, returns general points of interest in the supplied area.
  • latitude (number, optional): Latitude of the search center (-90 to 90). Typically paired with longitude.
  • longitude (number, optional): Longitude of the search center (-180 to 180). Typically paired with latitude.
  • location (string, optional): Location string used as an alternative to latitude/longitude. For US locations prefer the form <city> <state> <country name> (e.g., san francisco ca united states); for non-US locations use <city> <country name> (e.g., tokyo japan).
  • radius (number, optional): Search radius around the supplied coordinates, in meters. If omitted, the search is performed globally.
  • count (number, optional): Number of results to return (1-50, default 20).
  • country (string, optional): Two-letter country code (default US).
  • search_lang (string, optional): Search language (default en).
  • ui_lang (string, optional): UI language (default en-US).
  • units (string, optional): Distance units (metric or imperial, default metric).
  • safesearch (string, optional): Safe search level (off, moderate, strict, default strict).
  • spellcheck (boolean, optional): Whether to spellcheck the query (default true).
  • geoloc (string, optional): Optional geolocation token used to refine results.

Optional request headers:

  • api-version (string, optional): Brave API version (YYYY-MM-DD)
  • accept (string, optional): Response media type (application/json or */*)
  • cache-control (string, optional): Use no-cache to request fresh content
  • user-agent (string, optional): User agent originating the request

LLM Context (brave_llm_context)

Retrieves pre-extracted web content optimized for AI agents, LLM grounding, and RAG pipelines.

Parameters:

  • query (string, required): Search query (max 400 chars, 50 words)
  • country (string, optional): Search country code
  • search_lang (string, optional): Search language code
  • count (number, optional): Maximum number of search results considered (1-50)
  • spellcheck (boolean, optional): Enable spell checking
  • maximum_number_of_urls (number, optional): Maximum number of URLs to include (1-50)
  • maximum_number_of_tokens (number, optional): Approximate maximum number of context tokens (1024-32768)
  • maximum_number_of_snippets (number, optional): Maximum number of snippets to include (1-256)
  • context_threshold_mode (string, optional): Threshold mode ("disabled", "strict", "lenient", "balanced")
  • maximum_number_of_tokens_per_url (number, optional): Maximum tokens per URL (512-8192)
  • maximum_number_of_snippets_per_url (number, optional): Maximum snippets per URL (1-100)
  • goggles (string or array, optional): Goggle URL or definition for custom re-ranking
  • freshness (string, optional): Time filter ("pd", "pw", "pm", "py", or date range)
  • enable_local (boolean, optional): Enable local recall
  • enable_source_metadata (boolean, optional): Include source metadata enrichment

Optional request headers:

  • x-loc-lat (number, optional): Client latitude (-90 to 90)
  • x-loc-long (number, optional): Client longitude (-180 to 180)
  • x-loc-city (string, optional): Client city name
  • x-loc-state (string, optional): Client state or region code
  • x-loc-state-name (string, optional): Client state or region name
  • x-loc-country (string, optional): Client country code
  • x-loc-postal-code (string, optional): Client postal code
  • api-version (string, optional): Brave API version (YYYY-MM-DD)
  • accept (string, optional): Response media type ("application/json" or "/")
  • cache-control (string, optional): Use no-cache to request fresh content
  • user-agent (string, optional): User agent originating the request

Configuration

Getting an API Key

  1. Sign up for a Brave Search API account
  2. Choose a plan:
    • Search: The real-time search data your chatbots & agents need to generate answers. Complete search results (URLs, text, news, images, and more), with additional LLM context optimized for AI.
    • Answers: Summarized, completed answers to any question. Answers grounded on a single search or multiple searches for better accuracy & reduced hallucinations.
  3. Generate your API key from the developer dashboard

Environment Variables

The server supports the following environment variables:

  • BRAVE_API_KEY: Your Brave Search API key (required unless BRAVE_API_KEY_FILE is set)
  • BRAVE_API_KEY_FILE: Path to a file containing your Brave Search API key. When set, this takes precedence over BRAVE_API_KEY. Useful for Docker secrets and similar mounted-secret setups.
  • BRAVE_MCP_TRANSPORT: Transport mode ("http" or "stdio", default: "stdio")
  • BRAVE_MCP_PORT: HTTP server port (default: 8080)
  • BRAVE_MCP_HOST: HTTP server host (default: "0.0.0.0")
  • BRAVE_MCP_LOG_LEVEL: Desired logging level("debug", "info", "notice", "warning", "error", "critical", "alert", or "emergency", default: "info")
  • BRAVE_MCP_ENABLED_TOOLS: When used, specifies a space-separated whitelist for supported tools
  • BRAVE_MCP_DISABLED_TOOLS: When used, specifies a space-separated blacklist for supported tools
  • BRAVE_MCP_STATELESS: HTTP stateless mode (default: "true"). When running on Amazon Bedrock Agentcore, set to "true".

Command Line Options

node dist/index.js [options]

Options:
  --brave-api-key <string>        Brave API key
  --brave-api-key-file <string>   Path to file containing Brave API key
  --transport <stdio|http>    Transport type (default: stdio)
  --port <number>             HTTP server port (default: 8080)
  --host <string>             HTTP server host (default: 0.0.0.0)
  --logging-level <string>    Desired logging level (one of _debug_, _info_, _notice_, _warning_, _error_, _critical_, _alert_, or _emergency_)
  --enabled-tools             Tools whitelist (only the specified tools will be enabled)
  --disabled-tools            Tools blacklist (included tools will be disabled)
  --stateless  <boolean>      HTTP Stateless flag

Installation

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BRAVE_API_KEY", "docker.io/mcp/brave-search"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

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

Usage with VS Code

For quick installation, use the one-click installation buttons below:

Install with NPX in VS Code Install with NPX in VS Code Insiders
Install with Docker in VS Code Install with Docker in VS Code Insiders

For manual installation, add the following to your User Settings (JSON) or .vscode/mcp.json:

Docker

{
  "inputs": [
    {
      "password": true,
      "id": "brave-api-key",
      "type": "promptString",
      "description": "Brave Search API Key",
    }
  ],
  "servers": {
    "brave-search": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BRAVE_API_KEY", "mcp/brave-search"],
      "env": {
        "BRAVE_API_KEY": "${input:brave-api-key}"
      }
    }
  }
}

NPX

{
  "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}"
      }
    }
  }
}

Build

Docker

docker build -t mcp/brave-search:latest .

Local Build

npm install
npm run build

Development

Prerequisites

  • Node.js 22.x or higher
  • npm
  • Brave Search API key

Setup

  1. Clone the repository:
git clone https://github.com/brave/brave-search-mcp-server.git
cd brave-search-mcp-server
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

Testing via Claude Desktop

Add a reference to your local build in claude_desktop_config.json:

{
  "mcpServers": {
    "brave-search-dev": {
      "command": "node",
      "args": ["C:\\GitHub\\brave-search-mcp-server\\dist\\index.js"], // Verify your path
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Testing via MCP Inspector

  1. Build and start the server:
npm run build
node dist/index.js
  1. In another terminal, start the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.js

STDIO is the default mode. For HTTP mode testing, add --transport http to the arguments in the Inspector UI.

Available Scripts

  • npm run build: Build the TypeScript project

  • npm run watch: Watch for changes and rebuild

  • npm run format: Format code with Prettier

  • npm run format:check: Check code formatting

  • npm run prepare: Format and build (runs automatically on npm install)

  • npm run inspector: Launch an instance of MCP Inspector

  • npm run inspector:stdio: Launch a instance of MCP Inspector, configured for STDIO

Docker Compose

For local development with Docker:

docker-compose up --build

Set BRAVE_API_KEY (or BRAVE_API_KEY_FILE) in your shell or a .env file before starting the stack. The default docker-compose.yml also accepts BRAVE_API_KEY_FILE when the path is valid inside the container (for example, from a bind mount or Docker secret).

Docker Compose secrets (optional)

To avoid putting the API key in an environment variable, you can use Docker Compose secrets. The server reads the key from the path in BRAVE_API_KEY_FILE, which must exist inside the container.

  1. Copy the example secret file and add your key:
cp secrets/brave_api_key.txt.example secrets/brave_api_key.txt
  1. Start the stack with the optional secrets override:
docker compose -f docker-compose.yml -f docker-compose.secrets.example.yml up --build

The override mounts the secret at /run/secrets/brave_api_key and sets BRAVE_API_KEY_FILE accordingly. See docker-compose.secrets.example.yml for the full configuration.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Related MCP servers

Natal charts cross-verified three ways. Refuses to answer rather than guess.

2
TypeScript
MIT
View repository →

Google Ads by domain or brand: creatives, formats, dates; or bulk-check which domains advertise.

Product Hunt launches, votes, makers, comments via the official API. Pay per result.

Public Telegram channel posts, views, reactions, media and subscriber counts. No login needed.

Vealth work board: find real work, claim free with your wallet, prove it. Free onchain anchoring.

BRbrawsr logo

brawsr

Active

Browser sessions, checkpoints, rewind, fork, lineage, and lifecycle tools for brawsr.

0
TypeScript
Apache-2.0
View repository →