Brave

Provides web and local Brave Search capabilities through an MCP endpoint with key-based API access.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

The Brave Search MCP Server integrates the Brave Search API to provide both web and local search capabilities through a unified MCP interface. You can run it locally or via an MCP-compatible runner and connect from your client to perform fast, configurable searches with smart fallbacks and filtering.

How to use

You run the Brave Search MCP Server as an MCP endpoint and connect your client to it using its MCP URL or standard IO channel. You can perform web searches for general queries, news, and articles with pagination and freshness controls, or run local searches to find nearby businesses and services. If a local search yields no results, the server automatically falls back to a web search to provide useful results.

How to install

Prerequisites: ensure you have a compatible runtime environment on your system. You will need either Docker or an MCP-capable runtime that can execute NPX commands.

Option 1: Run with Docker

Option 2: Run with NPX

Additional setup notes

API key: you must obtain a Brave Search API key and provide it to the server via an environment variable named BRAVE_API_KEY. This key is required for authentication with the Brave Search API.

Environment variables: you can set BRAVE_API_KEY in the running environment for the server configuration. Leave placeholders until you replace them with your actual key.

Tools and inputs

brave_web_search: Executes web searches with pagination and filtering. Inputs include query (string), count (optional, max 20), and offset (optional, max 9).
brave_local_search: Searches for local businesses and services. Inputs include query (string) and count (optional, max 20). If no local results are found, the server automatically falls back to a web search.

Security and keys

Keep your BRAVE_API_KEY secure. Do not expose it in client-side code or public repositories. Use environment-scoped configuration where possible.

Troubleshooting

If you encounter authentication errors, verify your BRAVE_API_KEY is correct and has the required permissions on the Brave Search API dashboard. If you experience no results, check your query terms and consider adjusting the count or freshness controls.

Available tools

brave_web_search

Execute web searches with pagination and filtering. Inputs: query (string), count (optional, max 20), offset (optional, max 9).

brave_local_search

Search for local businesses and services. Inputs: query (string), count (optional, max 20). Automatically falls back to web search if no local results are found.