SSyncDev

Yandex MCP Server

Query Yandex Metrica web analytics — reports, trends and metadata — via an AI agent.

Local serverstdio

What is the Yandex MCP Server?

Query Yandex Metrica web analytics — reports, trends and metadata — via an AI agent.

What it actually does

A Model Context Protocol (MCP) server for Yandex Metrica. It lets an AI agent query your web-analytics data — traffic, sources, landing pages, conversions, geography, devices and trends — through a small set of flexible, read-only tools.

Configuration

  • Node.js >= 18 - Yandex Metrica credentials with the metrika:read scope (see Authentication). Whoever the credentials belong to must have access to the counters you query.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
run_reportflexible wrapper over the Reporting API (/stat/v1/data).
run_comparisoncompare two periods with absolute and percentage deltas.
run_drilldowndrill down through a dimension tree.
run_timeseriesmetrics split into a time series (/bytime) for trends.
get_metadatadiscover the counters on your account and a catalog of common
describe_counterread one counter's configuration (goals, segments,

How to install the Yandex MCP Server

{
    "mcpServers": {
        "yandex-metrica": {
            "command": "npx",
            "args": ["-y", "yandex-metrica-mcp"],
            "env": { "YANDEX_METRIKA_COUNTER_ID": "12345678" }
        }
    }
}

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

Configuration

  • Node.js >= 18 - Yandex Metrica credentials with the metrika:read scope (see Authentication). Whoever the credentials belong to must have access to the counters you query.
VariableDescriptionRequired
YANDEX_METRIKA_COUNTER_IDConfiguration value read at startup.Optional
YANDEX_METRIKA_TOKENCredential the server authenticates with.Yes
YANDEX_OAUTH_CLIENT_IDConfiguration value read at startup.Optional
YANDEX_OAUTH_CLIENT_SECRETCredential the server authenticates with.Yes

Example prompts to try

  • “Use Yandex to run report.”
  • “Use Yandex to run comparison.”
  • “Use Yandex to run drilldown.”

Frequently asked questions

Query Yandex Metrica web analytics — reports, trends and metadata — via an AI agent. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.