mcp-brave-search

NimbleBrainInc/mcp-brave-search

3.2

If you are the rightful owner of mcp-brave-search and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Brave Search MCP Server provides a privacy-focused web search API with various search capabilities.

Tools
6
Resources
0
Prompts
0

Brave Search MCP Server

mpak NimbleBrain Discord

A Model Context Protocol (MCP) server that provides web search capabilities using the Brave Search API. Search the web from any MCP client with support for safe search, freshness filters, and country-specific results.

View on mpak registry | Built by NimbleBrain

Install

Install with mpak:

mpak install @nimblebraininc/brave-search

Configuration

Get your API key from Brave Search API, then configure:

mpak config set @nimblebraininc/brave-search api_key YOUR_API_KEY

Claude Code

claude mcp add brave-search -- mpak run @nimblebraininc/brave-search

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "brave-search": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/brave-search"]
    }
  }
}

See the mpak registry page for full install options.

Tools

web_search

Search the web using Brave Search. Returns relevant web pages with titles, URLs, descriptions, and age.

ParameterTypeRequiredDescription
querystringYesSearch keywords or natural language question
countintegerNoNumber of results to return, max 20 (default: 10)
safesearchstringNoFilter level: "off", "moderate", "strict" (default: "moderate")
freshnessstringNoTime filter: "pd" (day), "pw" (week), "pm" (month), "py" (year)
countrystringNo2-letter country code (default: "us")

Example call:

{
  "name": "web_search",
  "arguments": {
    "query": "Model Context Protocol",
    "count": 5,
    "freshness": "pw"
  }
}

Example response:

{
  "query": "Model Context Protocol",
  "results": [
    {
      "position": 1,
      "title": "Model Context Protocol",
      "url": "https://modelcontextprotocol.io",
      "description": "The Model Context Protocol is an open standard...",
      "age": "3 days ago"
    }
  ],
  "total_results": 5
}

Quick Start

Local Development

git clone https://github.com/NimbleBrainInc/mcp-brave-search.git
cd mcp-brave-search

# Install dependencies
uv sync

# Set API key
cp .env.example .env
# Edit .env with your API key

# Run the server (stdio mode)
uv run python -m mcp_brave_search.server

The server supports HTTP transport with:

  • Health check: GET /health
  • MCP endpoint: POST /mcp

Development

# Install with dev dependencies
uv sync --group dev

# Run all checks (format, lint, typecheck, unit tests)
make check

# Run unit tests
make test

# Run with coverage
make test-cov

About

Brave Search MCP Server is published on the mpak registry and built by NimbleBrain. mpak is an open registry for Model Context Protocol servers.

License

MIT