Skip to main content
Glama
Yandex Metrica MCP

Yandex Metrica MCP

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
YANDEX_METRIKA_LANGNoЗаголовок Accept-Language.ru
YANDEX_METRIKA_TOKENYesOAuth-токен Метрики (scope metrika:read).
YANDEX_METRIKA_API_BASENoКорень API.https://api-metrika.yandex.net
YANDEX_METRIKA_COUNTER_IDNoСчётчик по умолчанию, если в вызове не задан counterId.
YANDEX_METRIKA_TIMEOUT_MSNoТаймаут запроса, мс.60000
YANDEX_METRIKA_MAX_RETRIESNoПовторы при 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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. Фильтр по подстроке имени или сайта задаётся параметром search. На один сайт бывает несколько счётчиков (старый и новый, тестовый, отдельный для поддомена) — у каждого свои данные.

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. dimensions разбивает результат на строки (ym:s:date — динамика по дням, ym:s:lastTrafficSource — источники трафика, ym:s:deviceCategory — устройства), metrics задаёт нужные метрики — для конверсий это ym:s:goalreaches / ym:s:goalconversionRate (идентификаторы целей даёт list_goals). Префиксы не смешиваются: ym:s:* (визиты) и ym:pv:* (просмотры страниц) в одном запросе сочетаются только через filters. Ответ 400 «Incorrectly specified attribute» значит, что такого поля нет: не перебирать варианты имени, а взять поле из списка в dimensions. В ответе есть totals (итог по ВСЕМ строкам — для вопросов «сколько всего» суммировать не нужно), total_rows и sampled/sample_share (sampled=true означает, что данные приблизительные, посчитаны по доле sample_share; для точных цифр нужно сузить период или передать accuracy=full). Ответ 400 «Query is too complicated» значит, что Метрика не успела посчитать отчёт: сократить период (длинный — запросить частями по месяцу), accuracy при этом не снижать — не помогает. users — уникальные посетители за весь период: сумма users по дням их не даёт. counterId обязателен: id счётчика даёт list_counters.

raw_requestA

Универсальный запрос: обращается напрямую к любому пути API Яндекс Метрики — например "management/v1/counters", "management/v1/counter/{id}/goals", "stat/v1/data". Нужен для эндпоинтов, у которых нет отдельного инструмента. query уходит в строку запроса, body отправляется как JSON для POST. GET выполняется свободно; POST и DELETE — это запись, им нужен confirmWrite=true.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 8 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues