Yandex Metrika MCP: 25 analytics tools

Yandex Metrika MCP Server (Node.js)

A Node.js MCP server with 25 Yandex Metrika tools: traffic, content, devices, geography, conversions and e-commerce

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Reads site visitor stats and demographics
  • The access token can be issued with write scope even though all server tools only read data
All reasons and checks
Russian stack

dsh-ai/yandex-metrika-mcp

A similar tool with a larger community: Yandex Metrika MCP, 24 ★ on the repository

Install

Manual install

git clone https://github.com/dsh-ai/yandex-metrika-mcp.git
cd yandex-metrika-mcp
npm install
npm run build

Build the server before connecting it.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Reads site visitor stats and demographics
  • The access token can be issued with write scope even though all server tools only read data

This is third-party code. Review the repository files before installing.

What it does

The server wraps the Yandex Metrika Reporting API into 25 named tools instead of one generic report: traffic source summary, search phrases, source types, search engine performance, content analytics by article and category, demographics and devices, mobile vs desktop comparison, page depth, regional data, page performance, goal conversions, e-commerce by category, and time-series data grouped by day, week, month, quarter or year. The README exists in English and a separate Russian version.

Who it is for. For marketers and analysts who prefer calling a ready named tool rather than assembling report parameters by hand.

Good fit when

  • You need a quick ready-made report like demographics or mobile vs desktop without tuning parameters
  • You run a content site and want reports by article, author and category
  • You need e-commerce analytics by product category and region

Not a fit when

  • You need a custom report with an unusual combination of dimensions and metrics: the ready tools do not cover that
  • You need Management API access to manage counters and goals

Example request

Compare mobile and desktop user behavior on the site for the last month

MCP

Transport
stdio
Authentication
OAuth

Environment variables

YANDEX_API_KEY required, secret
Yandex Metrika OAuth token

Limitations

Tools are fixed to specific reports, so arbitrary dimensions and metrics are not available. No Management API: you cannot create or edit a counter or goal. Requires a Yandex Metrika access token.

How to disable. Remove the yandex-metrika-mcp block from your MCP client config.

FAQ

Can I get an arbitrary report with any metrics?

No, the server offers 25 fixed tools for specific tasks, not a generic report builder.

Is there Russian documentation?

Yes, README_ru.md alongside the main README.md.

Discussion

No questions or reviews yet.

Yandex Metrika MCP

Yandex Metrika MCP Server

Russian stack

MCP server for Yandex Metrika reports: traffic, sources, search phrases, goals, geography, devices and content analytics

MCP serverExtended access24Repository stars

MCP Yandex Metrica with counter management

@theyahia/yandex-metrika-mcp

Russian stack

Yandex Metrica MCP server with 15 tools: reports and traffic plus creating, editing, and deleting counters and goals

MCP serverBroad access1Repository stars

Yandex Metrica MCP

yandex-metrica-mcp

Russian stack

Read-only MCP server for Yandex Metrica: reports, period comparison, goals and raw log export with browser login

MCP serverExtended access15Repository stars
Editors’ pick

A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata

MCP serverExtended access2Repository stars
Russian stack

A read-only Yandex Metrika MCP server with 31 tools for traffic, content, demographics, geography, conversions and e-commerce, metrika:read only

MCP serverExtended access2Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Yandex Metrika MCP: 25 analytics tools (this card)noOAuth0
Yandex Metrika MCP: a compact reporting servernoOAuth0compact reports server
Yandex Metrika MCP with device flow and Logs APInoOAuth0Logs API

README in short

The README lists 25 tools across seven topic blocks: account, traffic, content, behavior, geography, conversions, e-commerce and technical data, gives an MCP config example with a token, and explains getting an OAuth token with metrika:read, metrika:write, metrika:user_params, metrika:expenses and metrika:offline_data scopes.

README badge

Report a problem