Prerequisites:Node.js and npm (v22.x or later recommended), Git.
- Obtain a Brave Search API Key:Follow the steps in the "Getting Started" section.
- Clone the repository:

git clone <repository_url> # Replace with the actual URL cd brave-search-mcp-sse

BRAVE_API_KEY=YOUR_API_KEY_HERE PORT=8080 # LOG_LEVEL=debug

npm start # Or for development with auto-reloading (if nodemon/ts-node-dev is configured) # npm run dev

Clients connect to this server via HTTP GET request to establish an SSE connection. The specific endpoint depends on your deployment (e.g.,http://localhost:8080/,http://<k8s-service-ip>:8080/, or through an Ingress).

Once connected, the server and client communicate using MCP messages over the SSE stream.

The server exposes the following tools to connected clients:

- Description: Performs a general web search using the Brave Search API.
- Inputs:

- query(string, required): The search query.
- count(number, optional): Number of results to return (1-20, default 10).
- offset(number, optional): Pagination offset (0-9, default 0).
- (Other Brave API parameters likesearch_lang,country,freshness,result_filter,safesearchmight be supported - checksrc/services/braveSearchApi.ts)

- Description: Performs a search for local businesses and places using the Brave Search API. Falls back to web search if no local results are found.
- Inputs:

- query(string, required): The local search query (e.g., "pizza near me", "cafes in downtown").
- count(number, optional): Maximum number of results (1-20, default 5).

(Example usingcurl- Note: Actual MCP interaction requires a client library)

# Example: Connect to SSE endpoint (won't show MCP messages directly) curl -N http://localhost:8080/ # Or your deployed endpoint

To use this server with an MCP client like Cursor, you need to configure the client to connect to the server's SSE endpoint.

Add the following configuration to your Cursor settings (mcp.jsonor similar configuration file), replacing the URL with the actual address and port where yourbrave-search-mcp-sseserver is accessible:

{ "mcpServers": { "brave-search": { "transport": "sse", "url": "http://localhost:8080/sse" } } }

- transport: Must be set to"sse"for this server.
- url: This is the crucial part.

- If running locally via Docker (as shown in the example),http://localhost:8080/sseis likely correct.
- If running in Kubernetes, replacelocalhost:8080with the appropriate Kubernetes Service address/port or the Ingress hostname/path configured to reach the server's port 8080.
- Ensure the URL path ends with/sse.

(Similar configuration steps might apply to other MCP clients that support the SSE transport, like recent versions of Claude Desktop, but refer to their specific documentation.)

. ├── Dockerfile # Container build definition ├── helm/ # Helm chart for Kubernetes deployment │ └── brave-search-mcp-sse/ ├── node_modules/ # Project dependencies (ignored by git) ├── src/ # Source code (TypeScript) │ ├── config/ # Configuration loading │ ├── services/ # Brave API interaction logic │ ├── tools/ # Tool definitions for MCP │ ├── transport/ # SSE/MCP communication handling │ ├── types/ # TypeScript type definitions │ ├── utils/ # Utility functions │ └── index.ts # Main application entry point ├── dist/ # Compiled JavaScript output (ignored by git) ├── package.json # Project metadata and dependencies ├── tsconfig.json # TypeScript compiler options ├── .env.example # Example environment file ├── .gitignore └── README.md # This file

Contributions are welcome! Please feel free to submit a Pull Request with your changes. Ensure your code adheres to the existing style and includes tests where applicable. I will review PRs as time permits.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search the web using Kagi's search API

Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.

A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.

Perform web, news, and image searches using the Microsoft Bing Search API.

An MCP server for web and local search using the Brave Search API.

Integrates the Brave Search API for both web and local search capabilities. Requires a BRAVE_API_KEY.

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

Search for cocktail recipes using the cezzis.com API.

Free search API for AI agents — 105 engines, 22 profiles, 94.3% SimpleQA accuracy, MCP server with 5 tools