The Brave Search MCP Server integrates with the Brave Search API to provide various search capabilities:
- Web Search: Perform general searches across diverse web sources (maximum 20 results per request)
- Image Search: Find web images based on specific queries (maximum 3 results per request)
- News Search: Retrieve news articles and trending topics (maximum 20 results per request)
- Video Search: Search for video content and tutorials (maximum 20 results per request)
- Local Search: Find businesses, restaurants, and points of interest nearby (maximum 20 results per request, falls back to web search if no local results are found)
Provides Web Search, Local Points of Interest Search, Video Search, Image Search and News Search capabilities through the Brave Search API, allowing users to retrieve various types of search results.
Brave Search MCP Server
An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Video Search, Image Search and News Search capabilities
Features
- Web Search: Perform a regular search on the web
- Image Search: Search the web for images. Image search results will be available as a Resource
- News Search: Search the web for news
- Video Search: Search the web for videos
- Local Points of Interest Search: Search for local physical locations, businesses, restaurants, services, etc
Tools
- brave_web_search
- Execute web searches using Brave's API
- Inputs:
query
(string): The term to search the internet forcount
(number, optional): The number of results to return (max 20, default 10)offset
(number, optional, default 0): The offset for paginationfreshness
(enum, optional): Filters search results by when they were discovered- The following values are supported
- pd: Discovered within the last 24 hours.
- pw: Discovered within the last 7 Days.
- pm: Discovered within the last 31 Days.
- py: Discovered within the last 365 Days
- YYYY-MM-DDtoYYYY-MM-DD: Custom date range (e.g., 2022-04-01to2022-07-30)
- The following values are supported
- brave_image_search
- Get images from the web relevant to the query
- Inputs:
query
(string): The term to search the internet for images ofcount
(number, optional): The number of images to return (max 3, default 1)
- brave_news_search
- Searches the web for news
- Inputs:
query
(string): The term to search the internet for news articles, trending topics, or recent eventscount
(number, optional): The number of results to return (max 20, default 10)freshness
(enum, optional): Filters search results by when they were discovered- The following values are supported
- pd: Discovered within the last 24 hours.
- pw: Discovered within the last 7 Days.
- pm: Discovered within the last 31 Days.
- py: Discovered within the last 365 Days
- YYYY-MM-DDtoYYYY-MM-DD: Custom date range (e.g., 2022-04-01to2022-07-30)
- The following values are supported
- brave_local_search
- Search for local businesses, services and points of interest
- REQUIRES subscription to the Pro api plan for location results
- Falls back to brave_web_search if no location results are found
- Inputs:
query
(string): Local search termcount
(number, optional): The number of results to return (max 20, default 5)
- brave_video_search
- Search the web for videos
- Inputs:
query
: (string): The term to search for videoscount
: (number, optional): The number of videos to return (max 20, default 10)freshness
(enum, optional): Filters search results by when they were discovered- The following values are supported
- pd: Discovered within the last 24 hours.
- pw: Discovered within the last 7 Days.
- pm: Discovered within the last 31 Days.
- py: Discovered within the last 365 Days
- YYYY-MM-DDtoYYYY-MM-DD: Custom date range (e.g., 2022-04-01to2022-07-30)
- The following values are supported
Configuration
Getting an API Key
- Sign up for a Brave Search API account
- Choose a plan (Free tier available with 2,000 queries/month)
- Generate your API key from the developer dashboard
Usage with Claude Code
For Claude Code users, run this command:
Windows:
Linux/macOS:
Replace YOUR_API_KEY_HERE
with your actual Brave Search API key.
Usage with Claude Desktop
Desktop Extension (DXT)
- Download the
dxt
file from the Releases - Open it with Claude Desktop or Go to File -> Settings -> Extensions and drag the .DXT file to the window to install it
Docker
- Clone the repo
- Docker build
- Add this to your
claude_desktop_config.json
:
NPX
Add this to your claude_desktop_config.json
:
Usage with LibreChat
Add this to librechat.yaml
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Desktop Extensions (DXT)
Anthropic recently released Desktop Extensions allowing installation of local MCP Servers with one click.
Install the CLI tool to help generate both manifest.json
and final .dxt
file.
Creating the manifest.json file
- In this folder/directory which contains the local MCP Server, run
dxt init
. The command will start an interactive CLI to help create themanifest.json
.
Creating the dxt
file
- First install dev dependencies and build
- Then install only the production dependencies, generate a smaller nodule_modules directory
- Run
dxt pack
to create adxt
file. This will also validate the manifest.json that was created. Thedxt
is essentially a zip file and will contain everything in this directory.
Disclaimer
This library is not officially associated with Brave Software. It is a third-party implementation of the Brave Search API with a MCP Server.
License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides Web Search, Local Points of Interest Search, Video Search, Image Search and News Search capabilities through the Brave Search API, allowing users to retrieve various types of search results.
Related MCP Servers
- -securityAlicense-qualityAn MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.Last updated -216,84765,360MIT License
- -securityAlicense-qualityAn MCP server that integrates the Brave Search API to provide both web and local search capabilities, with features like pagination, filtering, and smart fallbacks.Last updated -12MIT License
Brave Search MCP Serverofficial
-securityAlicense-qualityAn MCP implementation that integrates the Brave Search API, providing comprehensive search capabilities including web, local business, image, video, news searches, and AI-powered summarization.Last updated -1,07196MIT License