Yandex Metrica MCP MCP Server

io.github.askads/mcp-yandex-metrica

Repository Registry

What is the Yandex Metrica MCP MCP server?

MCP server for Yandex Metrica API: list counters, goals and pull web-analytics statistics.

How to install Yandex Metrica MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

YANDEX_METRIKA_TOKEN
secret
Yandex Metrica OAuth token (scope metrika:read) — read access to analytics data. Treat it as a secret. Optional: without it the server starts anyway and connects through the in-chat login (start_login / finish_login).
YANDEX_METRIKA_OAUTH_CLIENT_ID
ClientID of your own Yandex OAuth app for the in-chat login. Defaults to the Ask Ads app scoped to metrika:read.
YANDEX_METRIKA_COUNTER_ID
Default Metrica counter id, used when a tool call omits counterId.
YANDEX_METRIKA_LANG
Language for API responses (ru, en, ...).
YANDEX_METRIKA_API_BASE
API root host. Override only for a proxy or a non-default endpoint.
YANDEX_METRIKA_TIMEOUT_MS
Per-request timeout in milliseconds.
YANDEX_METRIKA_MAX_RETRIES
Max retries for transient errors (429 rate limit, 5xx on reads).

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-yandex-metrica": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-metrica"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<YOUR_YANDEX_METRIKA_TOKEN>",
        "YANDEX_METRIKA_OAUTH_CLIENT_ID": "<YOUR_YANDEX_METRIKA_OAUTH_CLIENT_ID>",
        "YANDEX_METRIKA_COUNTER_ID": "<YOUR_YANDEX_METRIKA_COUNTER_ID>",
        "YANDEX_METRIKA_LANG": "<YOUR_YANDEX_METRIKA_LANG>",
        "YANDEX_METRIKA_API_BASE": "<YOUR_YANDEX_METRIKA_API_BASE>",
        "YANDEX_METRIKA_TIMEOUT_MS": "<YOUR_YANDEX_METRIKA_TIMEOUT_MS>",
        "YANDEX_METRIKA_MAX_RETRIES": "<YOUR_YANDEX_METRIKA_MAX_RETRIES>"
      }
    }
  }
}