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
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
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
Install
Manual install
git clone https://github.com/dsh-ai/yandex-metrika-mcp.git
cd yandex-metrika-mcp
npm install
npm run buildBuild the server before connecting it.
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 monthLimitations
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.
MCP
- Transport
- stdio
- Authentication
- OAuth
| Environment variables | |
|---|---|
| YANDEX_API_KEY required, secret | Yandex Metrika OAuth token |
Security check
- Reads site visitor stats and demographics
- The access token can be issued with write scope even though all server tools only read data
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.
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.
Related
Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents