Yandex Metrica MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YANDEX_METRIKA_LANG | No | Заголовок Accept-Language. | ru |
| YANDEX_METRIKA_TOKEN | Yes | OAuth-токен Метрики (scope metrika:read). | |
| YANDEX_METRIKA_API_BASE | No | Корень API. | https://api-metrika.yandex.net |
| YANDEX_METRIKA_COUNTER_ID | No | Счётчик по умолчанию, если в вызове не задан counterId. | |
| YANDEX_METRIKA_TIMEOUT_MS | No | Таймаут запроса, мс. | 60000 |
| YANDEX_METRIKA_MAX_RETRIES | No | Повторы при 429/5xx. | 3 |
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 |
|---|---|
| auth_statusA | Показывает, подключена ли Яндекс Метрика: есть ли токен, откуда он взят (переменная окружения YANDEX_METRIKA_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть и не показывает сам токен. Вызовите это, если инструменты Метрики отвечают, что подключение не настроено. |
| start_loginA | Первый шаг подключения Яндекс Метрики без правки конфигурации и без перезапуска клиента. Возвращает ссылку на страницу Яндекс OAuth. Покажите ссылку пользователю целиком и попросите: открыть её в браузере под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердить доступ и прислать показанный код подтверждения. Полученный код передайте в finish_login. Код действует 10 минут. Сам по себе код бесполезен для постороннего: обменять его может только этот сервер. |
| finish_loginA | Второй шаг подключения: обменивает код подтверждения из start_login на токен доступа, сохраняет его в файл только для владельца (0600) и сразу проверяет живым запросом к Метрике. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Код одноразовый и живёт 10 минут: если он не принят, вызовите start_login заново и попросите свежий. |
| logoutA | Удаляет сохранённый токен Метрики с диска. Токен, заданный переменной окружения YANDEX_METRIKA_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. Доступ, выданный приложению, остаётся активным на стороне Яндекса: отозвать его можно в Яндекс ID. |
| list_countersA | Возвращает счётчики Яндекс Метрики, доступные токену (Management API). У каждого счётчика есть id, name и site2 (домен сайта) — id используется в get_statistics и list_goals. Фильтр по подстроке имени или сайта задаётся параметром |
| list_goalsA | Возвращает цели (конверсии), настроенные на счётчике Метрики (Management API). Идентификаторы целей нужны, чтобы запросить метрики конверсий (ym:s:goalreaches / ym:s:goalconversionRate) в get_statistics. Если counterId не передан, берётся YANDEX_METRIKA_COUNTER_ID. |
| get_statisticsA | Запрашивает Reporting API Яндекс Метрики (stat/v1/data) по счётчику. ПО УМОЛЧАНИЮ возвращает одну строку, агрегированную за период (без измерений), с visits/users/pageviews/bounceRate/avgVisitDurationSeconds. |
| raw_requestA | Универсальный запрос: обращается напрямую к любому пути API Яндекс Метрики — например "management/v1/counters", "management/v1/counter/{id}/goals", "stat/v1/data". Нужен для эндпоинтов, у которых нет отдельного инструмента. |
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 8 tools
Each tool has a clear, distinct role: auth status, login/logout flow, listing counters/goals, fetching statistics, and a generic raw request. No two tools overlap in purpose, and even similar operations (list_goals vs list_counters) are clearly differentiated by resource type.
The naming is predominantly verb_noun in lowercase snake_case (list_goals, get_statistics, start_login, finish_login). Minor deviations: 'auth_status' and 'logout' are not strictly verb_noun, but they follow the same case style and are idiomatic for their actions. The overall pattern is consistent.
Eight tools is a well‑scoped set for a Yandex Metrica MCP server. It covers authentication (3 tools), resource listing (3 tools), statistics (1 tool), and a flexible raw API access (1 tool) without being bloated or insufficient.
The tool set comprehensively addresses the core Yandex Metrica workflows: authentication, listing counters and goals, retrieving statistics, and raw access to any API endpoint. The inclusion of raw_request fills any gaps for operations not covered by dedicated tools, ensuring no dead ends.