yandex-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YANDEX_MCP_KEYSTORE | No | Force a specific credential store: `keychain`, `secret-tool`, or `file`. | |
| YANDEX_MCP_CLIENT_ID | No | Yandex application ID, if you don't want to keep it in the credential store. | |
| YANDEX_MCP_SECRET_TOKEN | No | A ready token bypassing the credential store (convenient for Docker and CI). | |
| YANDEX_MCP_WORDSTAT_WAIT | No | How many seconds to wait for the Wordstat report, default is 170. | |
| YANDEX_MCP_DIRECT_SANDBOX | No | `1` makes Direct respond from the sandbox so API points are not spent. | |
| YANDEX_MCP_DEFAULT_COUNTER | No | Default Metrika counter ID. Optional; if not set, it must be specified in each request. | |
| YANDEX_MCP_DIRECT_CLIENT_LOGIN | No | Client login for agency accounts. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| metrika_summaryB | Сводка Яндекс Метрики за период: визиты, посетители, отказы, длительность, глубина и достижения всех целей счётчика. |
| metrika_reportB | Произвольный отчёт Reporting API Метрики. Метрики: ym:s:visits, ym:s:users, ym:s:bounceRate, ym:s:goalreaches, ym:s:goalconversionRate, ym:pv:pageviews. Измерения: ym:s:lastsignTrafficSource, ym:s:lastsignSourceEngine, ym:s:searchPhrase, ym:s:startURLPath, ym:pv:URLPath, ym:s:regionCity, ym:s:deviceCategory, ym:s:UTMSource, ym:s:UTMCampaign, ym:s:date, ym:s:referalSource. ID целей смотри через metrika_summary — там они перечислены с достижениями. |
| metrika_compareA | Сравнение метрик между двумя периодами — для вопросов вроде «как изменился трафик за последний месяц». Период B по умолчанию: такой же длины, вплотную перед периодом A (можно задать явно через prev_date1/prev_date2). Если задан dimensions — сравнение построчно по значениям измерения, иначе только по итогам. |
| metrika_countersB | Список доступных счётчиков Метрики с их сайтами и статусом. |
| webmaster_summaryB | Состояние сайтов в Яндекс Вебмастере: ИКС, страниц в поиске, исключено, список активных проблем диагностики. |
| webmaster_queriesB | Поисковые запросы, по которым сайт показывается в Яндексе: показы, клики, средняя позиция. |
| webmaster_indexingB | Динамика количества страниц сайта в поиске Яндекса по датам (GET .../search-urls/in-search/history) — рост/падение индексации во времени. |
| webmaster_sitemapsB | Sitemap-файлы, которые видит Яндекс для сайта: URL, число адресов в нём, количество ошибок, дата последнего обращения робота. |
| webmaster_recrawlA | Ставит URL в очередь на переобход Яндексом (POST, мутирующий вызов — единственный в этом сервере). До 20 URL за раз, квота Вебмастера 150 в сутки на весь сайт. Необратимо: требует confirm: true, и перед этим список URL нужно показать пользователю. |
| direct_campaignsB | Список кампаний Яндекс Директа (только чтение) и остаток баллов API. Пока не подана заявка на доступ к API Директа, вернёт код 58. |
| direct_reportA | Отчёт по расходу/показам/кликам Директа (Reports API v5) — то, чего нет в direct_campaigns: реальные цифры эффективности по кампаниям, объявлениям, группам или поисковым запросам. Период — либо готовый диапазон Директа (date_range, по умолчанию LAST_30_DAYS: LAST_7_DAYS, THIS_MONTH, ALL_TIME и т.д.), либо явные date1/date2 в формате YYYY-MM-DD (относительные вроде 30daysAgo, как в Метрике, не поддерживаются). Отчёт может готовиться асинхронно — тул сам ждёт и повторяет запрос, суммарно до нескольких минут. |
| wordstat_phrasesA | Частотности Яндекс Вордстата: сколько раз в месяц ищут фразу и что ищут вместе с ней. Работает через Live v4 API Директа по тому же токену. Отчёт готовится у Яндекса около трёх минут; если вызов вернул «ещё готовится» — повтори его с теми же фразами, результат подхватится. |
| yandex_auth_statusA | Что уже подключено: какое хранилище секретов используется, есть ли ClientID приложения и токены, когда они истекают. Сам токен не показывается — только отпечаток. Вызывай первым, если какой-то инструмент ответил «нет токена». |
| yandex_loginA | Шаг 1 входа в Яндекс: выдаёт ссылку авторизации, которую нужно показать пользователю. Терминал не нужен. После подтверждения вызови yandex_submit_code. |
| yandex_submit_codeA | Шаг 2 входа: обменивает код подтверждения на токен и кладёт его в хранилище ОС. В режиме localhost вызывается без аргументов. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Each tool has a clearly distinct purpose, helped by service prefixes (metrika_, webmaster_, direct_, wordstat_, yandex_). Within each service, the operations are well separated, such as summary vs. custom report vs. period comparison vs. counter listing. No overlapping tools cause meaningful misselection risk.
All tool names use consistent snake_case with a predictable service prefix followed by a noun or action. The pattern is clear across Metrika, Webmaster, Direct, Wordstat, and auth tools. There are no mixed conventions or vague naming styles.
The 15 tools are well-scoped for a multi-service Yandex integration, with only a few focused tools per service. Each tool appears to earn its place without excessive surface area. This falls comfortably in the appropriate range.
The server covers core read/analytics workflows across Metrika, Webmaster, Direct, Wordstat, and authentication, including one mutation for Webmaster recrawl. Minor gaps exist, such as Direct campaign management and possible auth token refresh/revoke operations, but the main agent workflows are covered.