Yandex Metrika MCP Server

by artgas1io.github.artgas1/yandex-metrika-mcp-serverv3.3.1

Yandex Metrika Stat, Management and Logs APIs, one tool per method, generated from Yandex's documentation. Writes are disabled by default.

2Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install Yandex Metrika MCP server

claude mcp add yandex-metrika -e YANDEX_API_KEY='<yandex-api-key>' -- npx -y yandex-metrika-mcp-server

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server"
      ],
      "env": {
        "YANDEX_API_KEY": "<yandex-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server"
      ],
      "env": {
        "YANDEX_API_KEY": "<yandex-api-key>"
      }
    }
  }
}

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

{
  "servers": {
    "yandex-metrika": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server"
      ],
      "env": {
        "YANDEX_API_KEY": "<yandex-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server"
      ],
      "env": {
        "YANDEX_API_KEY": "<yandex-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
YANDEX_API_KEY	yes	yes	OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILE	—	—	Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITES	—	—	1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLS	—	—	Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTER	—	—	Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARS	—	—	Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Freshness

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

Last commit (default branch)
2026-09-28 · 12d ago · GitHub
Latest release
2026-09-09 · 31d ago · GitHub · v3.3.1
Package published
no data · npm/PyPI
Registry entry updated
2026-09-09 · 31d ago · official registry · v3.3.1

FAQ

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

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

›Does Yandex Metrika require an API key?

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

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

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

›Is Yandex Metrika in the official MCP registry?

Yes, as io.github.artgas1/yandex-metrika-mcp-server.