Каталог MCP
Brave Search MCP Server

Brave Search MCP Server

MCP-сервер для интеграции Brave Search API: веб-поиск, изображения, видео, новости, локальные места и AI-суммаризация. Полезен разработчикам AI-агентов, чат-ботов и RAG-пайплайнов. Поддерживает STD...

README

8 инструментов

Версии

Установить сервер

Brave Search MCP Server

An MCP server implementation that integrates the Brave Search API, providing comprehensive search capabilities including web search, local business search, place search, image search, video search, news search, LLM context, and AI-powered summarization. This project supports both STDIO and HTTP transports, with STDIO as the default mode.

Migration

1.x to 2.x

Default transport now STDIO

To follow established MCP conventions, the server now defaults to STDIO. If you would like to continue using HTTP, you will need to set the BRAVE_MCP_TRANSPORT environment variable to http, or provide the runtime argument --transport http when launching the server.

Response structure of `brave_image_search`

Version 1.x of the MCP server would return base64-encoded image data along with image URLs. This dramatically slowed down the response, as well as consumed unnecessarily context in the session. Version 2.x removes the base64-encoded data, and returns a response object that more closely reflects the original Brave Search API response. The updated output schema is defined in src/tools/images/schemas/output.ts.

Инструменты были проиндексированы: 11.09.2026

brave_image_searchвнешний мир

Выполняет поиск изображений через Brave Search API. Полезен, когда нужны фотографии людей, мест, предметов, идеи для графического дизайна, вдохновение и другое. При передаче результатов в среде Markdown может быть удобно включать в них изображения (например, image.title).

Параметры

countinteger
Number of results (1-200, default 50). Combine this parameter with offset to paginate search results.
countrystring
Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
querystringобязательный
The user's search query. Query cannot be empty. Limited to 400 characters and 50 words.
safesearchstring
Filters search results for adult content. The following values are supported: 'off' - No filtering. 'strict' - Drops all adult content from search results.
search_langstring
Search language preference. The 2 or more character language code for which the search results are provided.
spellcheckboolean
Whether to spellcheck provided query.

brave_llm_contextвнешний мир

Извлекает предварительно обработанный веб-контент, ранжированный по релевантности, с помощью Brave LLM Context API, оптимизирован для AI-агентов, обоснования LLM и пайплайнов RAG. В отличие от обычного веб-поиска, который возвращает ссылки и короткие описания, этот инструмент возвращает реальное содержимое подходящих страниц — фрагменты текста, таблицы, блоки кода и структурированные данные, чтобы модель могла напрямую анализировать их. Когда использовать: - Для обоснования ответов свежим релевантным веб-контентом (RAG) - Для передачи AI-агенту готового к использованию контента страниц из одного поискового запроса - Для ответов на вопросы и проверки фактов по актуальным источникам - Для сбора исходного материала для исследований без ручного извлечения страниц - Когда нужно содержимое страниц, а не только заголовки, описания и URL При передаче результатов в средах, поддерживающих Markdown, указывайте исходные URL из карты «sources».

Параметры

acceptenum
The default supported media type is application/json.
api-versionstring
The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning at https://api-dashboard.search.brave.com/documentation/guides/versioning.
cache-controlstring
Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.
context_threshold_modeenum
The mode to use to determine the threshold for including content in context. Default is balanced.
countinteger
The maximum number of search results considered to select the LLM context data. The default is 20 and the maximum is 50.
countryenum
The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
enable_localboolean
Whether to enable local recall. Not setting this value means auto-detect and uses local recall if any of the localization headers are provided.
enable_source_metadataboolean
Enable source metadata enrichment (site_name, favicon) in the sources attribute of the response.
freshnessenum | string
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.
gogglesstring | string[]
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. Multiple goggle URLs and/or definitions can be provided in an array. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart).
maximum_number_of_snippetsinteger
Maximum number of different snippets (or chunks of text) to include in LLM context. The default is 50 and maximum is 256.
maximum_number_of_snippets_per_urlinteger
Maximum number of snippets to include per URL. The default is 50 and maximum is 100.
maximum_number_of_tokensinteger
Approximate maximum number of tokens to include in context. The default is 8192 and maximum is 32768.
maximum_number_of_tokens_per_urlinteger
Maximum number of tokens to include per URL. The default is 4096 and maximum is 8192.
maximum_number_of_urlsinteger
Maximum number of different URLs to include in LLM context.
querystringобязательный
The user's search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.
search_langenum
The search language preference. The 2 or more character language code for which the search results are provided.
spellcheckboolean
Whether to enable spellcheck on the query.
user-agentstring
The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.
x-loc-citystring
The generic name of the client city
x-loc-countrystring
The two letter country code for the client’s country. For a list of country codes, see ISO 3166-1 alpha-2
x-loc-latnumber
The latitude of the client's geographical location in degrees, to provide relevant local results. The latitude must be greater than or equal to -90.0 degrees and less than or equal to +90.0 degrees.
x-loc-longnumber
The longitude of the client's geographical location in degrees, to provide relevant local results. The longitude must be greater than or equal to -180.0 and less than or equal to +180.0 degrees.
x-loc-postal-codestring
The client’s postal code
x-loc-statestring
A code which could be up to three characters, that represent the client's state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.
x-loc-state-namestring
The name of the client’s state/region. The region is the first-level subdivision (the broadest or least specific) of the ISO 3166-2 code.

brave_local_searchвнешний мир

Brave Local Search API обогащает результаты поиска по местоположению. Доступ к этому API предоставляется только по подписке Brave Search API Pro; перед использованием этого инструмента убедитесь, что у пользователя есть Pro-план (если нет, используйте инструмент brave_web_search). Выполняет поиск местных предприятий и заведений через Brave Local Search API. Лучше всего подходит для запросов, связанных с физическими локациями, бизнесами, ресторанами, услугами и т. д. Возвращает подробную информацию, включая: - Названия и адреса заведений - Оценки и количество отзывов - Номера телефонов и часы работы Используйте этот инструмент, когда запрос подразумевает «рядом со мной», «в моем районе» или упоминает конкретное местоположение (например, «в Сан-Франциско»). Если локальные результаты не найдены, инструмент автоматически переключается на brave_web_search.

Параметры

countinteger
Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.)
countryenum
Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
extra_snippetsboolean
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.
freshnessenum | string
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.
gogglesstring | string[]
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. Multiple goggle URLs and/or definitions can be provided in an array. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart).
offsetinteger
Pagination offset (max 9, default 0)
querystringобязательный
Search query (max 400 chars, 50 words)
result_filterenum[]
Result filter (default ['web', 'query'])
safesearchenum
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_langenum
Search language preference. The 2 or more character language code for which the search results are provided.
spellcheckboolean
Whether to spellcheck the provided query.
summaryboolean
This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.
text_decorationsboolean
Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).
ui_langenum
The language of the UI. The 2 or more character language code for which the search results are provided.
unitsstring
The measurement units. If not provided, units are derived from search country.

brave_news_searchвнешний мир

Этот инструмент ищет новостные статьи через Brave News Search API на основе запроса пользователя. Используйте его, когда нужна актуальная информация, срочные новости или статьи о конкретных темах, событиях или персонах. Когда использовать: - Поиск свежих новостей по определённым темам. - Получение обновлений срочных новостей. - Изучение текущих событий или трендовых историй. - Сбор новостных источников и заголовков для анализа. Возвращает JSON-список новостных результатов с заголовком, URL и описанием. Некоторые результаты могут содержать фрагменты текста из статьи. В средах, поддерживающих Markdown, всегда указывайте источники в виде гиперссылок. Примеры: - «Согласно Reuters, Китай запрещает несертифицированные и отозванные пауэрбанки в самолётах». - «The New York Times сообщает, что продажи электромобилей Tesla выросли на 20%». - «По данным BBC News, правительство Великобритании объявило о новой политике поддержки возобновляемой энергии».

Параметры

countinteger
Number of results (1-50, default 20)
countrystring
Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
extra_snippetsboolean
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.
freshnessenum | string
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.
gogglesstring | string[]
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. Multiple goggle URLs and/or definitions can be provided in an array. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart).
offsetinteger
Pagination offset (max 9, default 0)
querystringобязательный
Search query (max 400 chars, 50 words)
safesearchstring
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_langstring
Search language preference. The 2 or more character language code for which the search results are provided.
spellcheckboolean
Whether to spellcheck provided query.
ui_langstring
User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.

brave_place_searchвнешний мир

Ищет через Brave's Place Search API. Один вызов может заполнить любую комбинацию из 'results' (точки интереса), 'cities', 'addresses', 'streets' и 'location' (разрешенная область поиска) — в зависимости от формы запроса. Когда использовать: - Точки интереса рядом с координатами или именованной областью (например, "кофейни в Париже") -> 'results', каждый со структурированными данными о бизнесе (почтовый адрес, часы работы, контакты, рейтинги, фото, категории, часовой пояс). - Просмотр общих точек интереса (опустите 'query'; укажите 'latitude'+'longitude' или 'location'). - Уточнение названия города без контекста (например, "спрингфилд") -> 'cities'. - Определение конкретного адреса (например, "350 5th avenue" с координатами Нью-Йорка) -> 'addresses' (часто также 'streets'). - Поиск улицы по названию (например, "michigan avenue" с координатами Чикаго) -> 'streets'. Входные данные: - Привяжите поиск через 'latitude'+'longitude' или 'location' (или оба). Без них обязательно указывать 'query'. - 'addresses' / 'streets' появляются только когда запрос имеет форму адреса/улицы И привязан к географической точке. - Формат 'location': США — '<city> <state> <country>' (например, 'san francisco ca united states'); не США — '<city> <country>' (например, 'tokyo japan'). Регистр и запятые не важны. - 'count' ограничивает результаты (макс. 50, по умолчанию 20). 'radius' (в метрах) смещает результаты в сторону более близких; он НЕ задаёт жёстких границ области поиска.

Параметры

acceptenum
The default supported media type is application/json.
api-versionstring
The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning at https://api-dashboard.search.brave.com/documentation/guides/versioning.
cache-controlstring
Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort.
countinteger
Number of results to return. Maximum is 50. Default is 20.
countryenum
Two-letter country code (ISO 3166-1 alpha-2) used to scope the search. Defaults to 'US'.
geolocstring
Optional geolocation token used to refine results.
latitudenumber
Latitude of the geographical coordinates around which to search, in degrees (-90 to 90). Typically paired with longitude.
locationstring
Location string to search around, used as an alternative to latitude and longitude. For US locations prefer the form '<city> <state> <country name>' (e.g. 'san francisco ca united states'); for non-US locations use '<city> <country name>' (e.g. 'tokyo japan'). No commas or special characters needed; capitalization does not matter.
longitudenumber
Longitude of the geographical coordinates around which to search, in degrees (-180 to 180). Typically paired with latitude.
querystring
Query string. Shape influences the response: POI-like queries -> results; bare/ambiguous city names -> cities; address- or street-shaped queries with a geographic anchor -> addresses and/or streets. If omitted, returns general POIs in the supplied area.
radiusnumber
Bias toward results closer to the supplied coordinates, in meters. NOT a hard cutoff -- the API may still return more distant results. If omitted, the search is performed globally.
safesearchenum
Safe search level for the query results. 'off' - No filtering. 'moderate' - Filter out explicit content. 'strict' - Filter out explicit and suggestive content. Defaults to 'strict'.
search_langenum
Language for the search results. Defaults to 'en'.
spellcheckboolean
Whether to apply spellcheck before executing the search. Defaults to true.
ui_langenum
User interface language for the response, usually of the form '<language>-<region>'. Defaults to 'en-US'.
unitsenum
Units of measurement for distance values. Defaults to 'metric'.
user-agentstring
The user agent originating the request. Brave Search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110.

brave_summarizerвнешний мир

Получает сводки результатов веб-поиска, созданные ИИ, с помощью Brave Summarizer API. Инструмент обрабатывает результаты поиска и формирует краткие связные обобщения информации из нескольких источников. Когда использовать: - Когда нужен сжатый обзор сложных тем из множества источников - Для быстрой проверки фактов или выделения главного без чтения полных статей - Чтобы выдать пользователю обобщённую информацию, объединяющую разные точки зрения - Для исследовательских задач, требующих сжатых данных из веб-поиска Возвращает текстовую сводку, объединяющую информацию из результатов поиска. Опционально можно добавить встроенные ссылки на исходные URL и дополнительные сведения об объектах. Требования: сначала нужно выполнить веб-поиск через brave_web_search с параметром summary=true. Для доступа к функционалу сводок требуется подписка Pro AI.

Параметры

entity_infoboolean
Returns extra entities info with the summary response.
inline_referencesboolean
Adds inline references to the summary response.
keystringобязательный
The key is equal to value of field key as part of the Summarizer response model.

brave_video_searchвнешний мир

Ищет видео через Brave's Video Search API и возвращает структурированные результаты поиска с метаданными. Когда использовать: - Когда нужно найти видео по теме, ключевому слову или запросу. - Полезно для поиска видеоконтента, получения метаданных видео или поиска видео от конкретных авторов/издателей. Возвращает JSON-список результатов с полями title, url, description, duration и thumbnail_url.

Параметры

countinteger
Number of results (1-50, default 20). Combine this parameter with offset to paginate search results.
countrystring
Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
freshnessenum | string
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').
offsetinteger
Pagination offset (max 9, default 0). Combine this parameter with count to paginate search results.
querystringобязательный
The user's search query. Query cannot be empty. Limited to 400 characters and 50 words.
safesearchstring
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_langstring
Search language preference. The 2 or more character language code for which the search results are provided.
spellcheckboolean
Whether to spellcheck provided query.
ui_langstring
User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110.

brave_web_searchвнешний мир

Выполняет веб-поиск через Brave Search API и возвращает полные результаты поиска с богатыми метаданными. Когда использовать: - Общий веб-поиск по информации, фактам или актуальным темам - Запросы по местоположению (рестораны, компании, достопримечательности) - Поиск новостей о последних событиях или срочных новостях - Поиск видео, обсуждений или FAQ-контента - Исследования, требующие разнообразных типов результатов (веб-страницы, изображения, отзывы и т.д.) Возвращает JSON-список результатов веб-поиска с заголовком, описанием и URL. Когда параметр "results_filter" пуст, результаты JSON могут также содержать FAQ, Discussions, News и Video результаты.

Параметры

countinteger
Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.)
countryenum
Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries.
extra_snippetsboolean
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.
freshnessenum | string
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.
gogglesstring | string[]
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. Multiple goggle URLs and/or definitions can be provided in an array. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart).
offsetinteger
Pagination offset (max 9, default 0)
querystringобязательный
Search query (max 400 chars, 50 words)
result_filterenum[]
Result filter (default ['web', 'query'])
safesearchenum
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_langenum
Search language preference. The 2 or more character language code for which the search results are provided.
spellcheckboolean
Whether to spellcheck the provided query.
summaryboolean
This parameter enables summary key generation in web search results. This is required for summarizer to be enabled.
text_decorationsboolean
Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters).
ui_langenum
The language of the UI. The 2 or more character language code for which the search results are provided.
unitsstring
The measurement units. If not provided, units are derived from search country.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@brave/brave-search-mcp-server",
    "--transport",
    "stdio"
  ],
  "env": {
    "BRAVE_API_KEY": "${input:brave-api-key}"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер подключает AI-агентов к поисковой системе Brave. Через него ассистенты могут искать веб-страницы, новости, видео, изображения и локальные заведения, а также получать AI-сводки результатов. Всё это работает напрямую из диалога, без отдельного API и лишних телодвижений.

Что он умеет?

Сервер выполняет поиск через Brave: ищет веб-страницы, видео, изображения, новости, местные заведения и объекты (POI). Получает AI-сгенерированные сводки результатов и LLM-контекст с релевантным содержимым для RAG-пайплайнов. Поддерживает настройку страны, языка, фильтров по времени и безопасного поиска, а также управляет количеством и смещением выдач.

Информация о сервере

Номер в рейтинге: #82
Звезд на Github: 1434
Форков на Github: 200
Загрузок: 393 565
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Да
Дата обновления данных: 10.09 в 23:49
Идентификатор: NURlKOxNI6LQHCJz
Категории: RAG-системы, Геолокационные сервисы, ИИ и машинное обучение, Инструменты для разработчиков, Поиск, Суммаризация текста