Skip to main content
Glama
nikolaymokh-dev

yandex-metrika-mcp

by nikolaymokh-dev
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

yandex-metrika-mcp

Hardened форк atomkraft/yandex-metrika-mcp. Доступ к аналитике Яндекс.Метрики из MCP-клиента (Claude Code, Cursor и другие). Только чтение — сервер отдаёт исключительно отчёты Stat API, ничего в аккаунте Метрики не меняет. Ставится через npx прямо из git.

Почему read-only и зачем форк

У Метрики есть write-операции (создание счётчиков, загрузка данных), но в этом MCP они не реализованы — только отчётные инструменты. Поэтому, в отличие от yandex-direct-mcp, здесь нет флагов «включить запись»: гейтить нечего, безопасный режим — единственный.

Что добавил форк поверх upstream:

  • npx-установка (bin + shebang) — не нужно вручную собирать и звать node build/index.js.

  • Фикс бага: get_visits теперь учитывает date_from/date_to (в upstream даты игнорировались); даты прокинуты во все пресетные отчёты.

  • Error handling: сбои возвращаются как MCP-результат с isError: true, а не заворачиваются в обычный текст.

  • Провенанс (NOTICE), docs/SECURITY.md, запиненное дерево зависимостей, метаданные репо.

Related MCP server: ya-metrics-mcp

Токен

Сервер авторизуется статичным OAuth-токеном в переменной YANDEX_API_KEY. Запрашивай только scope metrika:read (см. docs/SECURITY.md).

  1. Создай приложение: платформа — веб-сервисы; redirect URI — https://oauth.yandex.ru/verification_code; доступ — только metrika:read.

  2. Скопируй ClientID приложения.

  3. Открой ссылку https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>.

  4. Скопируй токен со страницы — это значение YANDEX_API_KEY.

Установка

Claude Code (рекомендуемо — npx из git)

claude mcp add yandex-metrika \
  --env YANDEX_API_KEY=ВАШ_ТОКЕН \
  -- npx -y github:nikolaymokh-dev/yandex-metrika-mcp

Пин на тег (после релиза):

claude mcp add yandex-metrika \
  --env YANDEX_API_KEY=ВАШ_ТОКЕН \
  -- npx -y github:nikolaymokh-dev/yandex-metrika-mcp#v0.1.0

.mcp.json / .claude.json / Cursor

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "github:nikolaymokh-dev/yandex-metrika-mcp"],
      "env": { "YANDEX_API_KEY": "ВАШ_ТОКЕН" }
    }
  }
}

Из локальной сборки

git clone https://github.com/nikolaymokh-dev/yandex-metrika-mcp
cd yandex-metrika-mcp && npm ci && npm run build
YANDEX_API_KEY=ВАШ_ТОКЕН node build/index.js

Инструменты (26, все read-only)

Каждый принимает counter_id; большинство — опциональные date_from/date_to (YYYY-MM-DD).

Группа

Инструменты

Аккаунт / визиты

get_account_info, get_visits, get_data_by_time

Источники трафика

sources_summary, sources_search_phrases, get_traffic_sources_types, get_search_engines_data, get_new_users_by_source

Контент-аналитика

get_content_analytics_sources, ..._categories, ..._authors, ..._topics, ..._articles

Аудитория / устройства

get_user_demographics, get_device_analysis, get_browsers_report, get_mobile_vs_desktop

Гео

get_regional_data, get_geographical_organic_traffic

Поведение / конверсии

get_page_depth_analysis, get_page_performance, get_goals_conversion, get_conversion_rate_by_source_and_landing

Поиск / эксперименты

get_organic_search_performance, get_yandex_direct_experiment

E-commerce

get_ecommerce_performance

Полное описание каждого инструмента (на английском) — в README_en.md.

Разработка

npm ci
npm run build        # tsc → build/
npm run inspector    # MCP Inspector

Лицензия

MIT. Форк atomkraft/yandex-metrika-mcp (© Vadim Bezymiannyi). Изменения © 2026 nikolaymokh-dev. См. NOTICE и LICENSE.

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Yandex Metrika MCP

    Vadosdavos
    F
    license
    -
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides access to Yandex Metrika analytics data through various tools and functions. This server allows AI assistants and applications to retrieve comprehensive analytics data from Yandex Metrika accounts.
    Last updated
    1

  • meta-mcp

    nourpups
    A
    license
    C
    quality
    C
    maintenance
    Read-only MCP server for Meta (Facebook) Graph API, enabling access to Marketing API, Pages, Instagram, and WhatsApp Business data through Claude Code and any MCP-compatible client.
    Last updated
    30
    23
    1
    MIT

  • appmetrica-mcp

    pavellunev
    A
    license
    A
    quality
    B
    maintenance
    MCP server for Yandex AppMetrica analytics, enabling Claude to access reports, raw event logs, crash data, and push notification campaigns.
    Last updated
    11
    24
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • Yandex Metrika MCP

    Read-only Yandex Metrika MCP. Query visits, sources, geo, devices and more in plain language.

  • classquill-mcp

    Read-only MCP server for ClassQuill, a tutoring-business-management platform.

  • KrystalView Analytics

    Read-only MCP access to sessions, funnels, campaigns, errors, live visitors, and anomalies.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nikolaymokh-dev/yandex-metrika-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server