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 обязателен: id счётчика даёт list_counters. |
| 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
The tools mostly have clearly distinct purposes: counters, goals, statistics, auth lifecycle, and a raw API escape hatch. The only overlap is raw_request, which can duplicate any specific tool, but its description frames it explicitly as a fallback for endpoints without a dedicated tool.
Most tools follow a readable verb_noun pattern (list_goals, get_statistics, list_counters, start_login, finish_login), with minor deviations like raw_request, auth_status, and logout. The conventions are still predictable enough for an agent to infer behavior.
Eight tools is well-scoped for a Yandex Metrica integration covering auth, counters, goals, statistics, and a generic API fallback. Each tool earns its place without excessive fragmentation.
The surface covers the core lifecycle: authentication (start/finish/status/logout), listing counters and goals, querying statistics, and a raw_request escape hatch for missing endpoints. Direct create/update/delete operations for goals or counters are absent, but raw_request prevents dead ends.