Brave Search

Brave Search

Search the Web for pages, images, news, videos, and more using the Brave Search API.

10K+

20

6 Tools

Signed
Built by Docker
Requires Secrets
Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Use cases

About

Brave Search MCP Server

Search the Web for pages, images, news, videos, and more using the Brave Search API.

What is an MCP Server?

Characteristics

AttributeDetails
Docker Imagemcp/brave-search
Authorbrave
Repositoryhttps://github.com/brave/brave-search-mcp-server
Dockerfilehttps://github.com/brave/brave-search-mcp-server/blob/main/Dockerfile
Docker Image built byDocker Inc.
Docker Scout Health ScoreDocker Scout Health Score
Verify SignatureCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/brave-search --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
LicenceMIT License

Available Tools (6)

Tools provided by this ServerShort Description
brave_image_searchBrave Image Search
brave_local_searchBrave Local Search
brave_news_searchBrave News Search
brave_summarizerBrave Summarizer
brave_video_searchBrave Video Search
brave_web_searchBrave Web Search

Tools Details

Tool: 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., image.title).

ParametersTypeDescription
querystringThe user's search query. Query cannot be empty. Limited to 400 characters and 50 words.
countintegeroptionalNumber of results (1-200, default 50). Combine this parameter with offset to paginate search results.
countrystringoptionalSearch query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
safesearchstringoptionalFilters search results for adult content. The following values are supported: 'off' - No filtering. 'strict' - Drops all adult content from search results.
search_langstringoptionalSearch language preference. The 2 or more character language code for which the search results are provided.
spellcheckbooleanoptionalWhether to spellcheck provided query.

This tool interacts with external entities.


Tool: 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.
ParametersTypeDescription
querystringSearch query (max 400 chars, 50 words)
countintegeroptionalNumber of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.)
countrystringoptionalSearch query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
extra_snippetsbooleanoptionalA 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.
freshnessstringoptionalFilters 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.
gogglesarrayoptionalGoggles 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).
offsetintegeroptionalPagination offset (max 9, default 0)
result_filterarrayoptionalResult filter (default ['web', 'query'])
safesearchstringoptionalFilters 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_langstringoptionalSearch language preference. The 2 or more character language code for which the search results are provided.
spellcheckbooleanoptionalWhether to spellcheck the provided query.
summarybooleanoptionalThis parameter enables summary key generation in web search results. This is required for summarizer to be enabled.
text_decorationsbooleanoptionalWhether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).
ui_langstringoptionalThe language of the UI. The 2 or more character language code for which the search results are provided.
unitsstringoptionalThe measurement units. If not provided, units are derived from search country.

This tool interacts with external entities.


Tool: 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".
ParametersTypeDescription
querystringSearch query (max 400 chars, 50 words)
countintegeroptionalNumber of results (1-50, default 20)
countrystringoptionalSearch query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
extra_snippetsbooleanoptionalA 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.
freshnessstringoptionalFilters 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.
gogglesarrayoptionalGoggles 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).
offsetintegeroptionalPagination offset (max 9, default 0)
safesearchstringoptionalFilters 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_langstringoptionalSearch language preference. The 2 or more character language code for which the search results are provided.
spellcheckbooleanoptionalWhether to spellcheck provided query.
ui_langstringoptionalUser interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.

This tool interacts with external entities.


Tool: 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.
ParametersTypeDescription
keystringThe key is equal to value of field key as part of the Summarizer response model.
entity_infobooleanoptionalReturns extra entities info with the summary response.
inline_referencesbooleanoptionalAdds inline references to the summary response.

This tool interacts with external entities.


Tool: 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.
ParametersTypeDescription
querystringThe user's search query. Query cannot be empty. Limited to 400 characters and 50 words.
countintegeroptionalNumber of results (1-50, default 20). Combine this parameter with offset to paginate search results.
countrystringoptionalSearch query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
freshnessstringoptionalFilters 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').
offsetintegeroptionalPagination offset (max 9, default 0). Combine this parameter with count to paginate search results.
safesearchstringoptionalFilters 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_langstringoptionalSearch language preference. The 2 or more character language code for which the search results are provided.
spellcheckbooleanoptionalWhether to spellcheck provided query.
ui_langstringoptionalUser interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.

This tool interacts with external entities.


Tool: 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.
ParametersTypeDescription
querystringSearch query (max 400 chars, 50 words)
countintegeroptionalNumber of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.)
countrystringoptionalSearch query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
extra_snippetsbooleanoptionalA 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.
freshnessstringoptionalFilters 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.
gogglesarrayoptionalGoggles 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).
offsetintegeroptionalPagination offset (max 9, default 0)
result_filterarrayoptionalResult filter (default ['web', 'query'])
safesearchstringoptionalFilters 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_langstringoptionalSearch language preference. The 2 or more character language code for which the search results are provided.
spellcheckbooleanoptionalWhether to spellcheck the provided query.
summarybooleanoptionalThis parameter enables summary key generation in web search results. This is required for summarizer to be enabled.
text_decorationsbooleanoptionalWhether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).
ui_langstringoptionalThe language of the UI. The 2 or more character language code for which the search results are provided.
unitsstringoptionalThe measurement units. If not provided, units are derived from search country.

This tool interacts with external entities.


Use this MCP Server

{
  "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"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?

Manual installation

You can install the MCP server using:

Installation for

Related servers