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.
Яндекс Метрика — это веб-аналитика сайта: визиты, источники, поведение и конверсии по целям одного счётчика, а не Яндекс Директ: здесь ничто не создаёт рекламные кампании, не останавливает их и не меняет ставки. Ни один инструмент не создаёт и не редактирует счётчик или цель: специализированные инструменты работают только на чтение, единственный путь записи — raw_request, и он ходит только на хост Метрики, общий для Management (management/v1/...) и Reporting (stat/v1/data). Имена метрик и измерений передаются без проверки, поэтому должны быть точными; подписи в ответе зависят от Accept-Language, по умолчанию ru. Чтения уже повторяются при 429/5xx с нарастающей паузой, таймаут запроса — 60 с, поэтому немедленный повтор упавшего вызова не поможет. Пустой ответ list_counters без фильтров означает, что токен принадлежит аккаунту Яндекса без доступа к этим счётчикам, а не сбой API; 403 с error_type invalid_token означает, что просрочен или неверен сам токен. У Метрики нет песочницы: любой вызов идёт по живым боевым данным, а POST/DELETE через raw_request меняет реальные объекты Метрики — ему нужен confirmWrite=true, и откатить это нечем.
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
Most tools target clearly distinct operations: reporting (get_statistics), discovery (list_counters, list_goals), auth lifecycle (start_login/finish_login/auth_status/logout), and one escape hatch (raw_request). The only real overlap is that raw_request can hit stat/v1/data and management endpoints, duplicating get_statistics/list_counters, but its description frames it as a fallback for endpoints lacking a dedicated tool.
Core tools follow a clean verb_noun snake_case pattern (get_statistics, list_counters, list_goals, start_login, finish_login). Minor deviations are auth_status (noun_phrase) and raw_request/logout, but all remain readable and predictable.
Eight tools is well-scoped for a Yandex Metrica reporting server: reporting, two discovery tools, four auth-lifecycle tools, and a generic fallback. Nothing feels padded or missing at the count level.
Read-oriented coverage is solid and the auth lifecycle is complete (status, login start/finish, logout), with raw_request covering write/edge endpoints. Minor gaps: no tool to enumerate valid dimension/metric fields despite references to such a list, no counter/goal detail or write operations, and logout doesn't revoke the token server-side.