Yandex Metrica MCP server
MCP server for Yandex Metrica API: list counters, goals and pull web-analytics statistics.
4 stars1.6k downloads/wk
Reviews
Write oneNobody has reviewed Yandex Metrica MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Yandex Metrica MCP tools (8)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
auth_statusПоказывает, подключена ли Яндекс Метрика: есть ли токен, откуда он взят (переменная окружения YANDEX_METRIKA_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть и не показывает сам токен. Вызовите это, если инструменты Метрики отвечают, что подключение не настроено.
finish_loginВторой шаг подключения: обменивает код подтверждения из start_login на токен доступа, сохраняет его в файл только для владельца (0600) и сразу проверяет живым запросом к Метрике. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Код одноразовый и живёт 10 минут: если он не принят, вызовите start_login заново и попросите свежий.
get_statisticslist_countersВозвращает счётчики Яндекс Метрики, доступные токену (Management API). У каждого счётчика есть id, name и site2 (домен сайта) — id используется в get_statistics и list_goals. Фильтр по подстроке имени или сайта задаётся параметром `search`.
list_goalsВозвращает цели (конверсии), настроенные на счётчике Метрики (Management API). Идентификаторы целей нужны, чтобы запросить метрики конверсий (ym:s:goal<id>reaches / ym:s:goal<id>conversionRate) в get_statistics.
logoutУдаляет сохранённый токен Метрики с диска. Токен, заданный переменной окружения YANDEX_METRIKA_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. Доступ, выданный приложению, остаётся активным на стороне Яндекса: отозвать его можно в Яндекс ID.
raw_requestУниверсальный запрос: обращается напрямую к любому пути API Яндекс Метрики — например "management/v1/counters", "management/v1/counter/{id}/goals", "stat/v1/data". Нужен для эндпоинтов, у которых нет отдельного инструмента. `query` уходит в строку запроса, `body` отправляется как JSON для POST. GET выполняется свободно; POST и DELETE — это запись, им нужен confirmWrite=true.
start_loginПервый шаг подключения Яндекс Метрики без правки конфигурации и без перезапуска клиента. Возвращает ссылку на страницу Яндекс OAuth. Покажите ссылку пользователю целиком и попросите: открыть её в браузере под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердить доступ и прислать показанный код подтверждения. Полученный код передайте в finish_login. Код действует 10 минут. Сам по себе
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Yandex Metrica MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,243 servers
- Tools
- 8
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4
- more than 82% of 28,706 servers
- Downloads a week
- 1,629
- more than 95% of 12,306 servers with a package
What its tools let an agent do: 7 read · 1 run or deploy
Release history: 5 versions in the registry since 2026-08-18, latest 2026-11-01, typically one every 1 day.
Install Yandex Metrica MCP in Claude Code, Cursor or VS Code
Runs npx -y mcp-yandex-metrica on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-yandex-metrica -- npx -y mcp-yandex-metrica
What the publisher says
From the Yandex Metrica MCP repository's README, as published. We do not edit it. Read it on GitHub
Яндекс Метрика MCP
Яндекс Метрика MCP подключает AI-приложение к веб-аналитике сайта. Спросите на естественном языке, откуда приходят посетители, как меняется конверсия или где растёт доля отказов — ассистент возьмёт данные из вашего счётчика и объяснит результат. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.
- Восемь инструментов. Счётчики, цели и отчёты Метрики, подключение и отключение доступа, а также один универсальный запрос к API.
- Отчёты и конверсии. Визиты, пользователи, просмотры, отказы, длительность визита, источники, устройства и цели за выбранный период.
- Подключение в чате. Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к счётчикам сразу после подключения.
- Обычные запросы — только чтение. Специализированные инструменты не меняют счётчики, цели или данные Метрики.
- Без молчаливого обрезания. В отчёте видны итоговые значения и признак выборки; при большой выдаче сервер отмечает, если упёрся в лимит.
Попробуйте первым сообщением:
Сколько визитов, пользователей и отказов было у моего сайта за последнюю неделю?
Подключить сервер · Посмотреть сценарии · Открыть техническую документацию
Увидеть работу за минуту
Вы: Подключи Яндекс Метрику.
Ассистент: Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердите доступ и пришлите показанный код.
Вы: Отправляет код из страницы Яндекса.
Ассистент: Подключает Метрику, проверяет, видны ли счётчики, и сообщает результат. Перезапускать приложение не нужно.
Вы: За последние 30 дней покажи источники трафика и конверсию по цели «Оформление заказа».
Ассистент: Находит цель, строит отчёт по источникам и показывает визиты, достижения цели и конверсию. Если Метрика применила выборку, отмечает, что цифры приблизительные.
Содержание
- Быстрый старт
- Что можно поручить
- Как это работает
- Что может изменить данные
- Подключение и настройка
- Данные и телеметрия
- Ограничения
- Техническая документация
- Поддержка
Быстрый старт
Нужен Node.js 20 или новее. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется.
- Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.
- Напишите: «Подключи Яндекс Метрику». Ассистент проведёт через вход в Яндекс и сразу проверит, что ему видны ваши счётчики.
- Задайте первый вопрос, например: «Какие источники дали больше всего визитов за прошлый месяц?»
Codex
Через интерфейс приложения:
- Откройте Settings → Plugins → MCP servers.
- Нажмите Add server.
- Добавьте команду запуска npx -y mcp-yandex-metrica@latest.
Через командную строку:
codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latestПроверьте подключение:
codex mcp listЗатем в чате Codex попросите: «Подключи Яндекс Метрику».
Официальная инструкция Codex
Claude Code
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Yandex Metrica MCP: common questions
- Is Yandex Metrica MCP server safe?
- Mostly: it is graded B (82/100). Read the Yandex Metrica MCP safety report
- How do I install Yandex Metrica MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Yandex Metrica MCP need an API key?
- Yes. The registry entry asks for
YANDEX_METRIKA_TOKEN. - Is Yandex Metrica MCP maintained?
- The last commit was 4 days ago (2026-11-01). The latest release is v1.5.5.
- How does Yandex Metrica MCP compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,243 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.