Yandex MCP Server

MCP server for Yandex Metrika API — counters, goals, reports, segments, logs

Local serverstdioPython

What is the Yandex MCP server?

MCP server for Yandex Metrika API — counters, goals, reports, segments, logs. Exposed over MCP by the yandex mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

claude mcp add yandex-metrika \ -e YANDEX_METRIKA_TOKEN=ваш_токен \ -- mcp-server-yandex-metrika ```

Adding it to your client

mcp-server-yandex-metrika on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Its toolset

Everything the assistant can do here goes through one of these:

  • ym_stat_data — stat-data
  • ym_stat_data_bytime — stat-bytime
  • ym_stat_data_drilldown — stat-drilldown
  • ym_stat_data_comparison — stat-comparison
  • ym_stat_data_comparison_drilldown — —
  • ym_log_requests — log-requests
  • ym_log_request — —
  • ym_log_request_create — log-request-create
  • ym_log_request_evaluate — log-request-evaluate
  • ym_log_request_clean — —
  • ym_log_request_cancel — —
  • ym_log_request_download — log-download

Configuration

You will need one environment variable: YANDEX_METRIKA_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 12 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Yandex.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the yandex mcp server does with a few real requests.

When to reach for it

Plenty of monitoring and observability servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Yandex's toolset — ym_stat_data, ym_stat_data_bytime, ym_stat_data_drilldown and 9 more — is a fair guide to whether it matches your workflow. It is maintained by dontsovcmc; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
ym_stat_datastat-data
ym_stat_data_bytimestat-bytime
ym_stat_data_drilldownstat-drilldown
ym_stat_data_comparisonstat-comparison
ym_stat_data_comparison_drilldown
ym_log_requestslog-requests
ym_log_request
ym_log_request_createlog-request-create
ym_log_request_evaluatelog-request-evaluate
ym_log_request_clean
ym_log_request_cancel
ym_log_request_downloadlog-download

How to install the Yandex MCP server

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "uvx",
      "args": ["mcp-server-yandex-metrika"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "ваш_токен"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
YANDEX_METRIKA_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Yandex to ym stat data.
  • Use Yandex to ym stat data bytime.
  • Use Yandex to ym stat data drilldown.

Frequently asked questions

It connects Yandex to MCP-compatible AI assistants such as Claude and Cursor, exposing 12 tools (ym_stat_data, ym_stat_data_bytime, ym_stat_data_drilldown, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Yandex directly.