Yandex Metrika MCP
Yandex Metrika MCP Server
MCP server for Yandex Metrika reports: traffic, sources, search phrases, goals, geography, devices and content analytics
- 23 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Requires a Yandex account OAuth token
- Sends site statistics into the agent context
Install
- Works in
- Services
Manual install
{
"mcpServers": {
"yandex-metrika-mcp": {
"command": "node",
"args": [
"{path-to-repo}/build/index.js"
],
"env": {
"YANDEX_API_KEY": "your_yandex_api_token_here"
}
}
}
}Clone the repository and run npm install first. The compiled build folder is committed.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Requires a Yandex account OAuth token
- Sends site statistics into the agent context
This is third-party code. Review the repository files before installing.
What it does
The server hands the agent ready-made Metrika reports instead of hand-built API queries. It covers visits for a period, source and traffic type summaries, search phrases and search engines, and new users by source. Other tools return content analytics by article, author and topic, demographics, devices, regions, goal conversion and page performance. Data can be grouped by day, week or month, and bounce rate is available for Yandex Direct experiments.
Who it is for. For marketers and analysts who check Metrika reports regularly and want to ask about traffic in plain language.
Good fit when
- You want a quick view of where last week's traffic came from
- You need to compare mobile and desktop traffic or regions
- You want goal conversion without opening the Metrika interface
Not a fit when
- You need to create counters or upload offline conversions: there are no write tools
- You need arbitrary reports with unusual groupings
Example request
Show traffic sources for the last 7 days and which of them bring the most new usersMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YANDEX_API_KEYrequired, secret- OAuth token with Metrika access
Limitations
It needs a Metrika OAuth token issued through your own app at oauth.yandex.ru. The package is not on npm, so the server runs from a repository clone. The report set is fixed. The last commit is not recent, so check compatibility with the current API.
How to disable. Delete the yandex-metrika-mcp block from the MCP client config and revoke the token in Yandex ID settings if needed.
FAQ
Which scopes should the app get?
metrika:read is enough for reports. This server does not need write scopes.
Is there Russian documentation?
Yes, the repository includes README_ru.md.
How is Yandex Metrika MCP different from direct Metrika API requests?
The server gives the agent ready reports instead of hand-built requests: visits over a period, sources and traffic types, search phrases and search engines, new users, goals, geography, devices and content analytics.
How do I connect an MCP for Yandex Metrika?
Add the yandex-metrika-mcp server with the node command to the client config, as in the install block, and set a Metrika OAuth token with read access. It works in Claude Desktop and Claude Code.
Discussion
No questions or reviews yet.
Related
All Yandex Metrica toolsYandex Metrica MCP
yandex-metrica-mcp
Read-only MCP server for Yandex Metrica: reports, period comparison, goals and raw log export with browser login
MCP Yandex Metrica with counter management
@theyahia/yandex-metrika-mcp
Yandex Metrica MCP server with 15 tools: reports and traffic plus creating, editing, and deleting counters and goals
An MCP server, CLI and Pydantic models for the Yandex Metrika API: reports, counters, goals, filters, segments, logs and offline conversion uploads
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An MCP server for Yandex Direct, Metrika, Wordstat and Webmaster: campaigns, ads, bids, reports and keyword research from chat
A read-only Yandex Metrika MCP server with 31 tools for traffic, content, demographics, geography, conversions and e-commerce, metrika:read only
Alternatives
Tools by other authors for the same tasks.
- Yandex Metrika MCP Server (Node.js)1 Repository stars
- yandex-metrika-mcp1 Repository stars
- Yandex Metrika MCP Server (ymetrika-mcp)
- Yandex Metrika MCP server, hardened read-only fork
- Yandex Metrika MCP: 25 analytics tools
- Yandex Metrika MCP: 68 Reports and Management API tools
- Yandex Metrika MCP: a compact reporting server
README in short
The README lists server capabilities by report group and gives an MCP config snippet that runs build/index.js with node. It explains in detail how to create an app at oauth.yandex.ru, which scopes to pick and how to get a token. It then lists every tool with a short purpose and the requirements: Node.js 18 and a Metrika API token. MIT license.