Yandex Metrika MCP: Documentation
Updated:
Connection
npx -y yandex-metrika-mcp (stdio, Node.js). Monorepo github.com/altrr2/yandex-tools-mcp (52+ stars, MIT), package at packages/yandex-metrika-mcp. Auth: YANDEX_METRIKA_TOKEN, an OAuth token scoped to metrika:read, issued at oauth.yandex.ru for an app with "Yandex Metrika: read-only" access.
Capabilities
43 tools by category: summaries and dictionaries (get-counters, get-counter, get-goals, get-traffic-summary, get-traffic-sources, get-geography, get-devices, get-popular-pages, get-search-phrases, get-report — free-form reports by dimension and metric), organic-SEO diagnostics (get-critical-pages, get-high-bounce-pages-organic, get-bounce-comparison-search-engines, get-entry-exit-paths and more), conversions (get-conversions-by-search-engine, get-conversions-by-search-phrases, get-conversions-by-devices, get-conversions-by-regions), referrals and social (get-referral-donors-behavior, get-quality-referral-traffic, get-social-networks-traffic, get-social-networks-quality), audience and trends (get-demographics-organic, get-audience-interests, get-organic-traffic-dynamics, get-organic-seasonality).
Agent flow
"How has organic traffic changed over the last month?", "which phrases drive conversions toward the "order" goal?", "compare bounce rate by device for organic traffic".
Note
A community project (altrr2 / Alternex), not affiliated with Yandex. The package is fresh: release 1.2.1 on 05.07.2026, ~872 npm installs/month. An older implementation, atomkraft/yandex-metrika-mcp (a different 25-tool set, unmaintained since August 2025), also exists — this card covers the active altrr2 version.