yandex-metrika-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| METRIKA_TOOLS | No | Отбор инструментов через запятую: раздел (stat, logs, management), префикс имени (metrika_goal) или точное имя. По умолчанию пусто - все 108 инструментов. | |
| YANDEX_API_KEY | Yes | OAuth-токен с scope direct:api / metrika. Без него сервер не стартует. | |
| METRIKA_API_BASE | No | Подмена адреса API (прокси, заглушка в тестах). По умолчанию пусто. | |
| METRIKA_ALLOW_WRITES | No | Если установлено в '1', разрешает вызовы, меняющие данные. По умолчанию не задана - запись отключена. | |
| METRIKA_TRAFFIC_FILTER | No | Условие сегментации, добавляемое к отчётам Stat. Задаётся целиком. | ym:s:isRobot=='no' |
| METRIKA_MAX_OUTPUT_CHARS | No | Потолок длины ответа одного вызова. Урезание объявляется в _meta.truncated_by_server. | 120000 |
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 | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| metrika_counter_getB | Информация о счетчике. Возвращает информацию об указанном счетчике. [GET https://api-metrika.yandex.net/management/v1/counter/{counterId}] Документация: https://yandex.ru/dev/metrika/ru/management/openapi/counter/counter.md |
| metrika_counter_listB | Список доступных счетчиков. Возвращает список существующих счетчиков, доступных пользователю. [GET https://api-metrika.yandex.net/management/v1/counters] Документация: https://yandex.ru/dev/metrika/ru/management/openapi/counter/counters.md |
| metrika_goal_listA | Список целей. Возвращает информацию о целях счетчика. [GET https://api-metrika.yandex.net/management/v1/counter/{counterId}/goals] Документация: https://yandex.ru/dev/metrika/ru/management/openapi/goal/goals.md |
| metrika_segment_listA | Список сегментов для счетчика. Возвращает список сегментов, созданных с помощью API и относящихся к заданному счетчику. [GET https://api-metrika.yandex.net/management/v1/counter/{counterId}/apisegment/segments] Документация: https://yandex.ru/dev/metrika/ru/management/openapi/segment/getSegmentsForCounter.md |
| metrika_stat_bytimeA | Получение данных по времени. Позволяет получить данные с разбивкой по времени (например, по дням, неделям, месяцам). Используйте данный тип запроса для построения графиков и отслеживания динамики. [GET https://api-metrika.yandex.net/stat/v1/data/bytime] Документация: https://yandex.ru/dev/metrika/ru/stat/openapi/bytime.md |
| metrika_stat_comparisonA | Сравнение сегментов. Позволяет сравнить два сегмента данных, указанные в запросе. Сегменты идентифицируются как сегмент А и сегмент B. Для каждого сегмента можно задать разные диапазоны дат и фильтры сегментации. Данные будут представлены в виде таблицы. [GET https://api-metrika.yandex.net/stat/v1/data/comparison] Документация: https://yandex.ru/dev/metrika/ru/stat/openapi/comparison_1.md |
| metrika_stat_comparison_drilldownA | Сравнение - drill down. С помощью данного метода можно комбинировать методы Drill down и Сравнение сегментов. Таким образом позволяет получить данные по ветвям дерева для сравнения сегментов. Для каждого значения группировки API возвращает два набора метрик. Например, для сегмента A и сегмента B. Для каждого сегмента можно задать разные диапазоны дат и фильтры сегментации. [GET https://api-metrika.yandex.net/stat/v1/data/comparison/drilldown] Документация: https://yandex.ru/dev/metrika/ru/stat/openapi/comparison_drilldown.md |
| metrika_stat_dataC | Таблица. Предоставляет доступ к статистическим данным Яндекс Метрики, включая данные, доступные в отчетах. Возвращает результат в виде таблицы. [GET https://api-metrika.yandex.net/stat/v1/data] Документация: https://yandex.ru/dev/metrika/ru/stat/openapi/data_1.md |
| metrika_stat_drilldownB | Drill down. Позволяет сформировать многоуровневый (древовидный) отчет. При этом каждому уровню соответствует одна группировка. [GET https://api-metrika.yandex.net/stat/v1/data/drilldown] Документация: https://yandex.ru/dev/metrika/ru/stat/openapi/drilldown.md |
| metrika_stat_pivotB | Получение сводной таблицы. Позволяет получить данные с разбивкой по времени (например, по дням, неделям, месяцам). Используйте данный тип запроса для построения графиков и отслеживания динамики. [GET https://api-metrika.yandex.net/stat/v1/data/pivot] Документация: https://yandex.ru/dev/metrika/ru/stat/openapi/pivot.md |
| metrika_catalog_listA | Список инструментов Яндекс Метрики: какие объявлены сейчас, какие скрыты профилем и как их включить. Зови, когда нужного инструмента Метрики не видно в списке или пользователь спрашивает, что ещё умеет сервер. Не обращается к API Метрики и не требует токена. |
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 11 tools
Most tools map to distinct resources and stat report types, but metrika_stat_bytime and metrika_stat_pivot have nearly identical descriptions despite representing different report modes. This creates a real misselection risk for agents relying on tool descriptions.
All tools share the metrika_ prefix and follow a metrika_<domain>_<suffix> pattern. However, suffixes mix actions (get, list) with report types (data, bytime, pivot, drilldown), so it is predictable but not a strict verb_noun convention.
11 tools is well within the ideal range and covers the main management query surface plus the core stat report modes without redundancy. Each tool corresponds to a distinct Yandex Metrika API endpoint or function.
The server covers counter list/get, goals, segments, catalogs, and the main stat report types (table, drilldown, bytime, comparison, pivot). Missing create/update/delete operations for managed resources are a minor gap, but the read-only analytics focus is fairly complete.