SkillFoxx

yandex-metrika-mcp

A hosted read-only Yandex Metrika MCP: sign in with Yandex, no app registration or tokens, just two tools instead of dozens

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Reads site analytics data, including visitor sources and geography
  • The hosted option routes login through the third-party aiaiai platform on top of the Yandex account
All reasons and checks
Russian stack

expremiental/yandex-metrika-mcpAuthor:aiaiai

A similar tool with a larger community: Yandex Metrika MCP, 24 ★ on the repository

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/expremiental-yandex-metrika-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Reads site analytics data, including visitor sources and geography
  • The hosted option routes login through the third-party aiaiai platform on top of the Yandex account

This is third-party code. Review the repository files before installing.

What it does

The server answers questions about Yandex Metrika analytics in plain language: how many visits this week, top sources for the month, today's mobile share. Instead of dozens of narrow tools, it gives just two: list_counters returns the counters available to the token, and query runs an arbitrary Reporting API call with parameters for metrics, dimensions, date range, filters, sort and row limit, covering visits, users, pageviews, bounce rate, sources, devices, geography and UTM tags. The main way to use it is a ready hosted HTTP service at mcp.getaiaiai.ru: no app registration or token retrieval needed, sign-in happens through Yandex OAuth right when the connector is added, and the service is explicitly stated as read-only, writing nothing to the Metrika account. For those who want to keep data under their own control, a Python self-host option with your own OAuth token is available.

Who it is for. For people who want to ask Yandex Metrika analytics questions in plain language without setting up an app or storing tokens.

Good fit when

  • You want a quick answer to a traffic question with no OAuth app registration or token setup
  • A ready hosted service works fine for you instead of self-hosting
  • You want an arbitrary Reporting API query without memorizing dozens of tool names

Not a fit when

  • You do not want to sign in through the third-party aiaiai hosted service with your Yandex account: the self-host option with your own token fits better
  • You want ready topic-specific tools instead of one universal query with manually specified metric parameters

Example request

How many visits were there this week, and where did most of the traffic come from?

MCP

Transport
http, stdio
Authentication
OAuth

Environment variables

YANDEX_METRIKA_TOKEN secret
OAuth token with the metrika:read scope, needed only for the self-host option

Limitations

The hosted option depends on the third-party aiaiai service and its infrastructure, not just the Yandex API. The query tool requires knowing the exact Reporting API metric and dimension names; there are no ready report presets. The self-host option requires Python 3.10 and uv.

How to disable. Remove the connector from your client's settings (Claude.ai: Settings, Connectors), or remove the server from your MCP client config if self-hosted, and revoke access in your Yandex account settings.

FAQ

Does the hosted option need a token?

No, sign-in happens through Yandex OAuth right when the connector is added; there is no need to register an app or store a token.

Can the service change data in Metrika?

No, the README explicitly states the service is read-only and never writes to the Metrika account.

Discussion

No questions or reviews yet.

All Yandex Metrica tools

Yandex Metrica MCP

yandex-metrica-mcp

Russian stack

Read-only MCP server for Yandex Metrica: reports, period comparison, goals and raw log export with browser login

MCP serverExtended access15
Russian stack

A minimalist Python MCP with 12 read-only tools using the correct OAuth header, paired with a skill that carries the period-comparison methodology

MCP serverExtended access4
Russian stack

A read-only Yandex Metrika MCP server with 31 tools for traffic, content, demographics, geography, conversions and e-commerce, metrika:read only

MCP serverExtended access2

MCP Yandex Metrica with counter management

@theyahia/yandex-metrika-mcp

Russian stack

Yandex Metrica MCP server with 15 tools: reports and traffic plus creating, editing, and deleting counters and goals

MCP serverBroad access1
Russian stack

A read-only Yandex Webmaster MCP with PKCE sign-in and no app registration needed: indexing, queries, diagnostics, backlinks

PluginBroad access4

README in short

The bilingual README presents the server as a way to ask Metrika analytics questions in plain language, with no dashboards, SQL or key management. The main path is the aiaiai hosted service with a one-minute connection for Claude.ai, Claude Code, Claude Desktop and Cursor via Yandex OAuth, with the service explicitly noted as read-only. A table of two tools, list_counters and query, details the latter's parameters: metrics, dimensions, date range, filters, sort, limit, with examples of common metrics and dimensions. A collapsible developer section covers a Python self-host option with uv, your own OAuth token, an HTTP run mode, and embedding into your own backend via an injectable token resolver. MIT license.

README badge

Report a problem