Search the Web for pages, images, news, videos, and more using the Brave Search API.
10K+
20
6 Tools
Version 4.43 or later needs to be installed to add the server automatically
Use cases
About
Search the Web for pages, images, news, videos, and more using the Brave Search API.
Attribute | Details |
---|---|
Docker Image | mcp/brave-search |
Author | brave |
Repository | https://github.com/brave/brave-search-mcp-server |
Dockerfile | https://github.com/brave/brave-search-mcp-server/blob/main/Dockerfile |
Docker Image built by | Docker Inc. |
Docker Scout Health Score | |
Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/brave-search --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
Licence | MIT License |
Tools provided by this Server | Short Description |
---|---|
brave_image_search | Brave Image Search |
brave_local_search | Brave Local Search |
brave_news_search | Brave News Search |
brave_summarizer | Brave Summarizer |
brave_video_search | Brave Video Search |
brave_web_search | Brave Web Search |
brave_image_search
Performs an image search using the Brave Search API. Helpful for when you need pictures of people, places, things, graphic design ideas, art inspiration, and more. When relaying results in a markdown environment, it may be helpful to include images in the results (e.g., ).
Parameters | Type | Description |
---|---|---|
query | string | The user's search query. Query cannot be empty. Limited to 400 characters and 50 words. |
count | integer optional | Number of results (1-200, default 50). Combine this parameter with offset to paginate search results. |
country | string optional | Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. |
safesearch | string optional | Filters search results for adult content. The following values are supported: 'off' - No filtering. 'strict' - Drops all adult content from search results. |
search_lang | string optional | Search language preference. The 2 or more character language code for which the search results are provided. |
spellcheck | boolean optional | Whether to spellcheck provided query. |
This tool interacts with external entities.
brave_local_search
Brave Local Search API provides enrichments for location search results. Access to this API is available only through the Brave Search API Pro plans; confirm the user's plan before using this tool (if the user does not have a Pro plan, use the brave_web_search tool). Searches for local businesses and places using Brave's Local Search API. Best for queries related to physical locations, businesses, restaurants, services, etc.
Returns detailed information including:
- Business names and addresses
- Ratings and review counts
- Phone numbers and opening hours
Use this when the query implies 'near me', 'in my area', or mentions specific locations (e.g., 'in San Francisco'). This tool automatically falls back to brave_web_search if no local results are found.
Parameters | Type | Description |
---|---|---|
query | string | Search query (max 400 chars, 50 words) |
count | integer optional | Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.) |
country | string optional | Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. |
extra_snippets | boolean optional | A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts. Only available under Free AI, Base AI, Pro AI, Base Data, Pro Data and Custom plans. |
freshness | string 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' - Timeframe is also supported by specifying the date range e.g. 2022-04-01to2022-07-30. |
goggles | array optional | Goggles act as a custom re-ranking on top of Brave's search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart). |
offset | integer optional | Pagination offset (max 9, default 0) |
result_filter | array optional | Result filter (default ['web', 'query']) |
safesearch | string optional | Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filters explicit content (e.g., images and videos), but allows adult domains in search results. 'strict' - Drops all adult content from search results. The default value is 'moderate'. |
search_lang | string optional | Search language preference. The 2 or more character language code for which the search results are provided. |
spellcheck | boolean optional | Whether to spellcheck the provided query. |
summary | boolean optional | This parameter enables summary key generation in web search results. This is required for summarizer to be enabled. |
text_decorations | boolean optional | Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters). |
ui_lang | string optional | The language of the UI. The 2 or more character language code for which the search results are provided. |
units | string optional | The measurement units. If not provided, units are derived from search country. |
This tool interacts with external entities.
brave_news_search
This tool searches for news articles using Brave's News Search API based on the user's query. Use it when you need current news information, breaking news updates, or articles about specific topics, events, or entities.
When to use:
- Finding recent news articles on specific topics
- Getting breaking news updates
- Researching current events or trending stories
- Gathering news sources and headlines for analysis
Returns a JSON list of news-related results with title, url, and description. Some results may contain snippets of text from the article.
When relaying results in markdown-supporting environments, always cite sources with hyperlinks.
Examples:
- "According to [Reuters](https://www.reuters.com/technology/china-bans/), China bans uncertified and recalled power banks on planes".
- "The [New York Times](https://www.nytimes.com/2025/06/27/us/technology/ev-sales.html) reports that Tesla's EV sales have increased by 20%".
- "According to [BBC News](https://www.bbc.com/news/world-europe-65910000), the UK government has announced a new policy to support renewable energy".
Parameters | Type | Description |
---|---|---|
query | string | Search query (max 400 chars, 50 words) |
count | integer optional | Number of results (1-50, default 20) |
country | string optional | Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. |
extra_snippets | boolean optional | A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts. Only available under Free AI, Base AI, Pro AI, Base Data, Pro Data and Custom plans. |
freshness | string 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' - Timeframe is also supported by specifying the date range e.g. 2022-04-01to2022-07-30. |
goggles | array optional | Goggles act as a custom re-ranking on top of Brave's search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart). |
offset | integer optional | Pagination offset (max 9, default 0) |
safesearch | string optional | Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filter out explicit content. 'strict' - Filter out explicit and suggestive content. The default value is 'moderate'. |
search_lang | string optional | Search language preference. The 2 or more character language code for which the search results are provided. |
spellcheck | boolean optional | Whether to spellcheck provided query. |
ui_lang | string optional | User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110. |
This tool interacts with external entities.
brave_summarizer
Retrieves AI-generated summaries of web search results using Brave's Summarizer API. This tool processes search results to create concise, coherent summaries of information gathered from multiple sources.
When to use:
- When you need a concise overview of complex topics from multiple sources
- For quick fact-checking or getting key points without reading full articles
- When providing users with summarized information that synthesizes various perspectives
- For research tasks requiring distilled information from web searches
Returns a text summary that consolidates information from the search results. Optional features include inline references to source URLs and additional entity information.
Requirements: Must first perform a web search using brave_web_search with summary=true parameter. Requires a Pro AI subscription to access the summarizer functionality.
Parameters | Type | Description |
---|---|---|
key | string | The key is equal to value of field key as part of the Summarizer response model. |
entity_info | boolean optional | Returns extra entities info with the summary response. |
inline_references | boolean optional | Adds inline references to the summary response. |
This tool interacts with external entities.
brave_video_search
Searches for videos using Brave's Video Search API and returns structured video results with metadata.
When to use:
- When you need to find videos related to a specific topic, keyword, or query.
- Useful for discovering video content, getting video metadata, or finding videos from specific creators/publishers.
Returns a JSON list of video-related results with title, url, description, duration, and thumbnail_url.
Parameters | Type | Description |
---|---|---|
query | string | The user's search query. Query cannot be empty. Limited to 400 characters and 50 words. |
count | integer optional | Number of results (1-50, default 20). Combine this parameter with offset to paginate search results. |
country | string optional | Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. |
freshness | string 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' - timeframe is also supported by specifying the date range (e.g. '2022-04-01to2022-07-30'). |
offset | integer optional | Pagination offset (max 9, default 0). Combine this parameter with count to paginate search results. |
safesearch | string optional | Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filter out explicit content. 'strict' - Filter out explicit and suggestive content. The default value is 'moderate'. |
search_lang | string optional | Search language preference. The 2 or more character language code for which the search results are provided. |
spellcheck | boolean optional | Whether to spellcheck provided query. |
ui_lang | string optional | User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110. |
This tool interacts with external entities.
brave_web_search
Performs web searches using the Brave Search API and returns comprehensive search results with rich metadata.
When to use:
- General web searches for information, facts, or current topics
- Location-based queries (restaurants, businesses, points of interest)
- News searches for recent events or breaking stories
- Finding videos, discussions, or FAQ content
- Research requiring diverse result types (web pages, images, reviews, etc.)
Returns a JSON list of web results with title, description, and URL.
When the "results_filter" parameter is empty, JSON results may also contain FAQ, Discussions, News, and Video results.
Parameters | Type | Description |
---|---|---|
query | string | Search query (max 400 chars, 50 words) |
count | integer optional | Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.) |
country | string optional | Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries. |
extra_snippets | boolean optional | A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts. Only available under Free AI, Base AI, Pro AI, Base Data, Pro Data and Custom plans. |
freshness | string 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' - Timeframe is also supported by specifying the date range e.g. 2022-04-01to2022-07-30. |
goggles | array optional | Goggles act as a custom re-ranking on top of Brave's search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart). |
offset | integer optional | Pagination offset (max 9, default 0) |
result_filter | array optional | Result filter (default ['web', 'query']) |
safesearch | string optional | Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filters explicit content (e.g., images and videos), but allows adult domains in search results. 'strict' - Drops all adult content from search results. The default value is 'moderate'. |
search_lang | string optional | Search language preference. The 2 or more character language code for which the search results are provided. |
spellcheck | boolean optional | Whether to spellcheck the provided query. |
summary | boolean optional | This parameter enables summary key generation in web search results. This is required for summarizer to be enabled. |
text_decorations | boolean optional | Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters). |
ui_lang | string optional | The language of the UI. The 2 or more character language code for which the search results are provided. |
units | string optional | The measurement units. If not provided, units are derived from search country. |
This tool interacts with external entities.
{
"mcpServers": {
"brave": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BRAVE_MCP_TRANSPORT",
"-e",
"BRAVE_API_KEY",
"mcp/brave-search"
],
"env": {
"BRAVE_MCP_TRANSPORT": "stdio",
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
Manual installation
You can install the MCP server using:
Installation for