Yandex Metrika MCP server
Полное покрытие API Яндекс Метрики: Stat, Management и Logs — 108 методов, 108 инструментов
2 stars68 downloads/wk
Reviews
Write oneNobody has reviewed Yandex Metrika yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Yandex Metrika tools (1)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
metrika_catalog_listСписок инструментов Яндекс Метрики: какие объявлены сейчас, какие скрыты профилем и как их включить.
Public scan report
scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it
- Code scan9 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 17 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Yandex Metrika compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,243 servers
- Tools
- 1
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 75% of 28,706 servers
- Downloads a week
- 68
- more than 52% of 12,306 servers with a package
What its tools let an agent do: 1 read
Install Yandex Metrika in Claude Code, Cursor or VS Code
Runs npx -y yandex-metrika-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add yandex-metrika-mcp-server -- npx -y yandex-metrika-mcp-server
What the publisher says
From the Yandex Metrika repository's README, as published. We do not edit it. Read it on GitHub
Yandex Metrika MCP Server
MCP-сервер к API Яндекс Метрики. Покрыты все 108 методов; по умолчанию объявляются десять — те, которыми считают. Остальное включается одной переменной.
mcp-name: io.github.artgas1/yandex-metrika-mcp-server
English
npx -y yandex-metrika-mcp-serverФорк atomkraft/yandex-metrika-mcp (апстрим — Vadim Bezymianyi, MIT). С версии 2.0.0 инструменты не пишутся руками, а порождаются из спеки, собранной по официальной документации.
Покрытие
Имя инструмента — metrika<ресурс><действие>, где ресурс взят из URL самого API без переименований. Поэтому metrikagoallist однозначно отображается в GET /management/v1/counter/{id}/goals и в свою страницу документации.
Контракт
Сервер переписан из-за двух наблюдавшихся отказов: он отдавал не то, что просили, и молча подмешивал фильтр. Отсюда четыре правила, каждое закрыто тестом.
ни измерений, ни периода, ни фильтров.
- Никакой молчаливой подмены. Что попросили — то и уходит в API. Сервер не досочиняет
{"meta": {...}, "data": {...}}, где meta.appliedbyserver перечисляет добавленное, а _meta.notes — принятые за вызывающего решения.
- Всё, что сервер добавил от себя, видно в ответе. Ответ приходит как
Повтор делается по статусу (429/500/502/503/504 и сетевые сбои), а не по подстроке в тексте; у 429 соблюдается Retry-After с потолком 30 секунд. Число повторов всегда видно в _meta.retries.
- Отказ остаётся отказом. Ошибка API возвращается с isError: true и телом ответа Метрики.
Метрика режет ответ по умолчанию, и молчать об этом нельзя. Если сервер сам урезал ответ по потолку длины, это отдельно объявлено в meta.truncatedby_server с числом выброшенных строк.
- Обрезание выдачи видно. В meta едут rowsreturned, rows_total и truncated —
в показанном meta.requesturl его значение заменено на REDACTED. Сам OAuth-токен уходит только заголовком и в ответе не появляется никогда.
- Секреты не уезжают в ответ. У metrikameasurementdelete есть параметр token;
Фильтр роботов
В отчётах Stat API по умолчанию применяется собственный флаг робота Метрики, и только он:
ym:s:isRobot=='no'Он объявлен: виден в схеме инструмента, отключается параметром humantrafficonly: false и всегда перечислен в meta.appliedbyserver. Если в запросе есть метрики ym:ad: или ym:ev:, фильтр не применяется (Метрика отвечает на такое сочетание 400) — и это попадает в meta.notes, а не остаётся молчаливым исключением.
Своё условие задаётся переменной METRIKATRAFFICFILTER — целиком, включая isRobot, если он нужен:
METRIKA_TRAFFIC_FILTER="ym:s:isRobot=='no' AND ym:s:browserName!='HeadlessChrome'"Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Yandex Metrika: common questions
- Is Yandex Metrika MCP server safe?
- Mostly: it is graded B (83/100). Read the Yandex Metrika safety report
- How do I install Yandex Metrika?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Yandex Metrika need an API key?
- Yes. The registry entry asks for
YANDEX_API_KEY. - Is Yandex Metrika maintained?
- The last commit was 38 days ago (2026-09-28). The latest release is v3.3.1.
- How does Yandex Metrika compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,243 servers); tools 1 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.