About yandex-metrika-mcp
yandex-metrika-mcp provides Yandex.Metrica API tools for users managing website analytics. It covers counters, goals, reports, logs, and traffic, with OAuth Bearer token authentication and stdio or HTTP access.
Key features
- 01Manage counters and goals
- 02Generate and compare reports
- 03Drill down through report dimensions
- 04Export raw visit and hit logs
- 05Review traffic sources and top pages
Use cases
- 01List a site's Yandex.Metrica counters
- 02Compare traffic across two date periods
- 03Find top pages and their pageviews
- 04Export visit or hit logs
MCP support
The MCP server exposes 15 Yandex.Metrica API tools for counter and goal management, reporting, and log export. It supports stdio and Streamable HTTP.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
15Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| field | string | No | Fields to return, comma-separated (e.g. 'name,site,status') |
| per_page | number | No | Results per page (default 100, max 10000) |
| search_string | string | No | Filter counters by name or site URL substring |
Details
From the project README@theyahia/yandex-metrika-mcp
MCP server for Yandex.Metrica API — counters, goals, reports, logs, traffic sources, top pages. 15 tools, OAuth Bearer token auth.
Part of the Russian API MCP series by @theYahia.
Getting a Token
- Go to oauth.yandex.ru
- Create an app (or use an existing one)
- Under Platforms, select "Web services"
- Under Access, add:
Yandex.Metrica->Read statistics and counter parameters - Get the OAuth token:
https://oauth.yandex.ru/authorize?response_type=token&client_id=YOUR_CLIENT_ID - Copy the token from the redirect URL (
access_token=...)
Installation
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": ["-y", "@theyahia/yandex-metrika-mcp"],
"env": {
"YANDEX_METRIKA_TOKEN": "your_token"
}
}
}
}
Claude Code
claude mcp add yandex-metrika -e YANDEX_METRIKA_TOKEN=your_token -- npx -y @theyahia/yandex-metrika-mcp
Streamable HTTP (remote / multi-client)
YANDEX_METRIKA_TOKEN=your_token npx @theyahia/yandex-metrika-mcp --http --port=3000
Endpoint: POST http://localhost:3000/mcp
Health check: GET http://localhost:3000/health
Smithery
Use smithery.yaml from the repository. Requires YANDEX_METRIKA_TOKEN.
Environment Variables
| Variable | Required | Description |
|---|---|---|
YANDEX_METRIKA_TOKEN | Yes | OAuth 2.0 Bearer token from Yandex OAuth |
Tools (15)
Management — Counters
| Tool | Description |
|---|---|
list_counters | List all counters. Filter by name/URL with search_string. |
get_counter | Get full details of a single counter by ID. |
create_counter | Create a new counter for a website. |
update_counter | Update counter name or site URL. |
delete_counter | Permanently delete a counter (irreversible). |
Management — Goals
| Tool | Description |
|---|---|
list_goals | List all goals for a counter. |
create_goal | Create a goal (url, number, step, action types). |
delete_goal | Delete a goal from a counter. |
Management — Logs
| Tool | Description |
|---|---|
export_logs | Export raw visit/hit logs via the Logs API. |
Reporting API
| Tool | Description |
|---|---|
get_report | Flexible reporting — any metrics + dimensions + filters + sort. |
get_report_comparison | Compare two date periods (A vs B). |
get_report_drilldown | Hierarchical drill-down into report dimensions. |
Convenience Wrappers
| Tool | Description |
|---|---|
get_traffic_summary | Quick overview: visits, pageviews, users, bounce rate, avg duration. |
get_traffic_sources | Traffic sources breakdown by channel. |
get_top_pages | Top pages by pageviews with performance metrics. |
Demo Prompts
Show me all my Yandex.Metrica counters
Compare last week's traffic to the previous week for counter 12345678
What are the top 10 pages on my site this month, sorted by pageviews?
Development
npm install
npm run build
npm test
npm run dev # stdio mode
npm run start:http # HTTP mode on port 3000
API Reference
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.