Yandex Metrika MCP: a compact reporting server
yandex-metrika-mcp-server
A small MCP server for the Yandex Metrika Reports API on the official SDK, with no extra tools or settings
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- A Node.js server calls the Metrica Reports API with an OAuth token
- The code uses only reporting methods, no write calls
clientssukach-lang/yandex-metrika-mcp-server
A similar tool with a larger community: Yandex Metrika MCP, 24 ★ on the repository
Install
- Works in
- Services
Manual install
git clone https://github.com/clientssukach-lang/yandex-metrika-mcp-server.git
cd yandex-metrika-mcp-server
npm installInstalls dependencies; the repository has no README.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- A Node.js server calls the Metrica Reports API with an OAuth token
- The code uses only reporting methods, no write calls
This is third-party code. Review the repository files before installing.
What it does
The server is built on the official MCP SDK, Express and Zod, and calls the Yandex Metrika Reports API with an OAuth token. All the code fits into one server.js file, compiled from TypeScript sources, and it supports both stdio and Streamable HTTP transport. Clear error hints are built into the code: on a 400 it suggests checking metric and dimension names and the date format, and on a 401 it suggests reissuing the token, which noticeably simplifies debugging compared to raw API errors.
Who it is for. For developers who want a minimal Metrika reporting server without extensive docs or extra configuration.
Good fit when
- You want a small, easy-to-read Metrika reporting server in a single file
- Working only with the Reports API, without managing counters and goals, is enough
- You want clear hints about auth and request format errors right in the response
Not a fit when
- You need to manage counters, goals or segments: the server only offers reports
- You need thorough documentation: there is no README, so you need to read the code
Example request
Show visits and pageviews for counter 44147844 over the last 30 daysMCP
- Transport
- stdio, http
- Authentication
- OAuth
Environment variables
METRIKA_OAUTH_TOKENrequired, secret- Yandex Metrika OAuth token
METRIKA_API_BASE_URL- API base URL, defaults to api-metrika.yandex.net
Limitations
The repository has no README: variable purposes and call formats are visible only from server.js and package.json. Works only with the Reports API; the Management API is not available. Requires a Metrika OAuth token.
How to disable. Remove the yandex-metrika-mcp-server block from your MCP client config.
FAQ
Why is there no README?
The repository has no README; the server's purpose and variables are clear from package.json and the server.js code.
Can counters be managed through this server?
No, based on the code it only calls the Metrika Reports API; the Management API is not implemented.
Discussion
No questions or reviews yet.
Related
All Yandex Metrica toolsMCP 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
Yandex Metrika MCP
Yandex Metrika MCP Server
MCP server for Yandex Metrika reports: traffic, sources, search phrases, goals, geography, devices and content analytics
Yandex Metrica MCP
yandex-metrica-mcp
Read-only MCP server for Yandex Metrica: reports, period comparison, goals and raw log export with browser login
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
Yandex Metrica MCP: reports and goals in Claude, Cursor and Codex
mcp-yandex-metrica
A Metrica MCP server run with npx and Yandex OAuth sign-in inside the chat: counters, goals, visit and conversion reports, read-only by default
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Yandex Metrika MCP: a compact reporting server (this card) | no | OAuth | 0 | |
| Yandex Metrika MCP: 25 analytics tools | no | OAuth | 0 | 25 ready reports |
| Yandex Metrika MCP with device flow and Logs API | no | OAuth | 0 | Logs API |
README in short
There is no README. package.json shows the name yandex-metrika-mcp-server, the modelcontextprotocol/sdk, express and zod dependencies, and the node server.js run command. The server.js code shows calls to api-metrika.yandex.net using the METRIKA_OAUTH_TOKEN token, with 400, 401 and 403 errors handled with clear hints.