drio
Open app

Brave Search

Source

Web and local search using Brave's Search API

Catalog onlyCatalog onlyDocker

Overview

Brave Search is an MCP server implementation that utilizes the Brave Search API to provide both web and local search capabilities.

To use Brave Search, sign up for a Brave Search API account to get an API key, then configure the server in your application with the provided API key and start making search queries.

  • Web Search: Execute general queries, news, and articles with pagination and freshness controls. - Local Search: Find businesses and services with detailed descriptions, automatically falling back to web search if no local results are found. - Flexible Filtering: Control types of results, safety levels, and content freshness. - Smart Fallbacks: Automatically fallback to web search for local queries when no results are found.
  1. Conducting general web searches for news articles.
  2. Finding local businesses or services quickly.
  3. Custom filtering of search results based on user-defined criteria.

Add to your AI client

Use these steps to connect Brave Search in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "brave-search-modelcontextprotocol": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

How do I obtain an API Key for Brave Search?

Sign up for a Brave Search API account, select a plan, and generate your API key from the developer dashboard.

Is there a free tier available?

Yes, the free tier allows up to 2,000 queries per month.

What happens if no local search results are found?

The service automatically falls back to a web search to continue providing relevant results.

Knowledge and memory