Yandex Metrica MCP Server

by askadsio.github.askads/mcp-yandex-metricav1.4.1

Read-only Yandex Metrica web analytics: list counters and goals, and pull traffic and conversion statistics.

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Yandex Metrica MCP server

claude mcp add yandex-metrica -e YANDEX_METRIKA_TOKEN='<yandex-metrika-token>' -- npx -y mcp-yandex-metrica

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-metrica"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<yandex-metrika-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-metrica"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<yandex-metrika-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-metrica"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<yandex-metrika-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-metrica"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<yandex-metrika-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
YANDEX_METRIKA_TOKEN	—	yes	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).

Freshness

Active — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-04 · 6d ago · GitHub
Latest release
2026-08-18 · 53d ago · GitHub · v1.4.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-18 · 53d ago · official registry · v1.4.1

FAQ

›How do I install the Yandex Metrica MCP server in Claude Code?

Run: claude mcp add yandex-metrica -e YANDEX_METRIKA_TOKEN='<yandex-metrika-token>' -- npx -y mcp-yandex-metrica. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Yandex Metrica require an API key?

Yes. It expects YANDEX_METRIKA_TOKEN, of which 1 is a secret.

›Can I use Yandex Metrica as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Yandex Metrica in the official MCP registry?

Yes, as io.github.askads/mcp-yandex-metrica.