@microagents/server-brave-search v0.0.7

Brave Search MCP Server

An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities for Claude.

Installation

npm install @microagents/server-brave-search
# or
yarn add @microagents/server-brave-search

Usage

Direct Execution

# Set your API key and run
BRAVE_API_KEY=your_api_key_here npx @microagents/server-brave-search

With Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["@microagents/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Getting an API Key

1. Sign up for a Brave Search API account at https://api.search.brave.com/
2. Choose a plan (Free tier available with 2,000 queries/month)
3. Generate your API key from the developer dashboard

Features

• Web Search: General queries, news, articles, with pagination and freshness controls
• Local Search: Find businesses, restaurants, and services with detailed information
• Flexible Filtering: Control result types, safety levels, and content freshness
• Smart Fallbacks: Local search automatically falls back to web when no results are found

Tools

brave_web_search

Execute web searches with pagination and filtering.

Inputs:

• query (string): Search terms
• count (number, optional): Results per page (max 20)
• offset (number, optional): Pagination offset (max 9)

brave_local_search

Search for local businesses and services.

Inputs:

• query (string): Local search terms
• count (number, optional): Number of results (max 20)

Automatically falls back to web search if no local results found.

License

MIT

Credits

Based on the original MCP server by the Model Context Protocol team.