scroll-world
A skill that turn any brand into a scrollable 3D world landing page
Query Yandex Metrica analytics — reports, trends, metadata and raw log exports — via an AI agent.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
A skill that turn any brand into a scrollable 3D world landing page
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 23/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 35/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 31 (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Yandex Metrica MCP. Sigue https://mcp.popnx.com/i/boxlab-ltd-yandex-metrica-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Metrica MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "yandex-metrica": { "command": "npx", "args": [ "-y", "yandex-metrica-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Yandex Metrica MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"yandex-metrica": {
"command": "npx",
"args": [
"-y",
"yandex-metrica-mcp"
]
}
}
}Usa Yandex Metrica MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Yandex Metrica MCP o muestra una herramienta de Yandex Metrica MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
YANDEX_METRIKA_TOKEN Token OAuth de Yandex Metrica (metrika:read). Es opcional si ejecutas el inicio de sesión auth. YANDEX_METRIKA_COUNTER_ID ID de contador predeterminado, para que las herramientas puedan omitir counterId. YANDEX_METRIKA_ENABLE_WRITE Establezca en 1 para añadir las herramientas de escritura (anotaciones de gráficos, carga de gastos). El inicio de sesión también solicitará metrika:write; cada cambio requiere confirmación. YANDEX_METRIKA_LOGS_DIR Directorio para las exportaciones de archivos de Logs API (logs_download en modo archivo). Por defecto, una carpeta dentro del directorio temporal del sistema operativo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Yandex Metrica MCP
Yandex Metrica MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Yandex Metrica MCP
B · Otros en Marketing y redes sociales que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Metrica MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user yandex-metrica -- npx -y yandex-metrica-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Yandex Metrica MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user yandex-metrica -- npx -y yandex-metrica-mcpDeberías ver Yandex Metrica MCP en la lista como conectado
Usa Yandex Metrica MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Yandex Metrica MCP o muestra una herramienta de Yandex Metrica MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
YANDEX_METRIKA_TOKEN Token OAuth de Yandex Metrica (metrika:read). Es opcional si ejecutas el inicio de sesión auth. YANDEX_METRIKA_COUNTER_ID ID de contador predeterminado, para que las herramientas puedan omitir counterId. YANDEX_METRIKA_ENABLE_WRITE Establezca en 1 para añadir las herramientas de escritura (anotaciones de gráficos, carga de gastos). El inicio de sesión también solicitará metrika:write; cada cambio requiere confirmación. YANDEX_METRIKA_LOGS_DIR Directorio para las exportaciones de archivos de Logs API (logs_download en modo archivo). Por defecto, una carpeta dentro del directorio temporal del sistema operativo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Metrica MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "yandex-metrica": { "command": "npx", "args": [ "-y", "yandex-metrica-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Yandex Metrica MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa Yandex Metrica MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Yandex Metrica MCP o muestra una herramienta de Yandex Metrica MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
YANDEX_METRIKA_TOKEN Token OAuth de Yandex Metrica (metrika:read). Es opcional si ejecutas el inicio de sesión auth. YANDEX_METRIKA_COUNTER_ID ID de contador predeterminado, para que las herramientas puedan omitir counterId. YANDEX_METRIKA_ENABLE_WRITE Establezca en 1 para añadir las herramientas de escritura (anotaciones de gráficos, carga de gastos). El inicio de sesión también solicitará metrika:write; cada cambio requiere confirmación. YANDEX_METRIKA_LOGS_DIR Directorio para las exportaciones de archivos de Logs API (logs_download en modo archivo). Por defecto, una carpeta dentro del directorio temporal del sistema operativo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Yandex Metrica MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "yandex-metrica": { "type": "stdio", "command": "npx", "args": [ "-y", "yandex-metrica-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Yandex Metrica MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa Yandex Metrica MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Yandex Metrica MCP o muestra una herramienta de Yandex Metrica MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
YANDEX_METRIKA_TOKEN Token OAuth de Yandex Metrica (metrika:read). Es opcional si ejecutas el inicio de sesión auth. YANDEX_METRIKA_COUNTER_ID ID de contador predeterminado, para que las herramientas puedan omitir counterId. YANDEX_METRIKA_ENABLE_WRITE Establezca en 1 para añadir las herramientas de escritura (anotaciones de gráficos, carga de gastos). El inicio de sesión también solicitará metrika:write; cada cambio requiere confirmación. YANDEX_METRIKA_LOGS_DIR Directorio para las exportaciones de archivos de Logs API (logs_download en modo archivo). Por defecto, una carpeta dentro del directorio temporal del sistema operativo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user yandex-metrica -- npx -y yandex-metrica-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"yandex-metrica": {
"command": "npx",
"args": [
"-y",
"yandex-metrica-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"yandex-metrica": {
"command": "npx",
"args": [
"-y",
"yandex-metrica-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"yandex-metrica": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"yandex-metrica-mcp"
]
}
}
}YANDEX_METRIKA_TOKEN secreto envYANDEX_METRIKA_COUNTER_ID envYANDEX_METRIKA_ENABLE_WRITE envYANDEX_METRIKA_LOGS_DIR envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub BoxLab-Ltd, dueña del repo
Último cambio de código: hace 3 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para yandex-metrica-mcp@1.0.1
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/boxlab-ltd-yandex-metrica-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 3 días, y la última versión (1.0.1) llegó al registro hace 13 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| Este Yandex Metrica MCP | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | No | No | No | No | Sí | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Ask your Yandex Metrica analytics in plain language — from Claude, Cursor, or any MCP client.
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 — plus opt-in write tools that you confirm one change at a time.
Read-only by default, no secrets stored in the package: interactive login uses
a built-in public OAuth client with PKCE, and the server talks only to Yandex.
General-purpose: marketing, product analytics, e-commerce and SEO are all fair game — the server is not tied to any one use case.
Point an AI agent at your counter and ask about your traffic — the server queries Yandex Metrica and hands back real, read-only data, no dashboards. Here the run_report tool answers a “traffic sources, last 7 days” question against a live counter:
1. Add the server to your MCP client (e.g. Claude Desktop) — no token required up front; you log in interactively in step 2:
{
"mcpServers": { "yandex-metrica": { "command": "npx", "args": ["-y", "yandex-metrica-mcp"], "env": { "YANDEX_METRIKA_COUNTER_ID": "12345678" } } } }
2. Log in once — one command, no app registration, no secret stored:
npx yandex-metrica-mcp auth
Approve access in the browser and you're done — the code is handed back automatically over a local redirect, no copy-paste. The login uses authorization-code + PKCE, so no client secret ever touches your machine; the token is cached (mode 0600) and valid for ~1 year.
3. Ask your agent about traffic, sources, conversions, geography, devices, or trends — see Examples for prompts.
Prefer a static token (CI / non-interactive) or your own OAuth app? See Authentication.
The repo doubles as the plugin marketplace for BoxLab's Yandex MCP family, so you can install the server through Claude Code's plugin system instead of the config above:
/plugin marketplace add BoxLab-Ltd/yandex-metrica-mcp
/plugin install yandex-metrica-mcp@boxlab
Then sign in from the chat with the login tool (or run npx yandex-metrica-mcp auth). The same marketplace also carries yandex-webmaster-mcp. To turn on the write tools in the plugin, start Claude Code with YANDEX_METRIKA_ENABLE_WRITE=1 in the environment.
For a one-click install with no JSON, download the .mcpb from the latest release and open it with Claude Desktop (or drag it into Settings → Extensions). It asks for an optional default counter id; then sign in from the chat with the login tool (or run npx yandex-metrica-mcp auth).
There is no official Yandex Metrica MCP server, and existing community ones are mostly thin, unmaintained, or dump raw data straight into the model's context. This server aims to be the well-engineered, well-maintained, open option: flexible report tools, strict token/context discipline, read-only by default.
run_report — flexible wrapper over the Reporting API (/stat/v1/data).run_comparison — compare two periods with absolute and percentage deltas.run_drilldown — drill down through a dimension tree.run_timeseries — metrics split into a time series (/bytime) for trends.get_metadata — discover the counters on your account and a catalog of common dimensions/metrics (and Logs API fields) so the model queries with real names.describe_counter — read one counter's configuration (goals, segments, filters, operations, access grants, chart annotations) via an include selector. The goals section gives the goal ids needed for conversion metrics in run_report.logs_request / logs_status / logs_download / logs_clean — Logs API: export raw, un-sampled session (visits) or hit (hits) rows. Async lifecycle (request → poll → download → clean); logs_download returns a bounded sample inline by default, or streams the full export to a file — never dumping raw rows into the model's context.login / submit_code — sign in to Yandex Metrica from your MCP client, no terminal needed: login opens the browser and captures the code over a local redirect, or hands back a URL and takes the pasted code via submit_code.metrica-hygiene skill.Off unless you set YANDEX_METRIKA_ENABLE_WRITE=1. Then the server adds:
manage_annotation — create, update or delete a note pinned to a chart date (a release, a campaign start, an outage).upload_expenses — import ad costs from a non-Yandex source as CSV, so Metrica reports cost and ROI. dryRun: true validates the file and shows the rows, dates and totals without sending anything.With the flag on, sign-in also asks for the metrika:write scope — run auth (or the login tool) once more after turning it on. Without the flag the sign-in asks for read access only, and tokens issued earlier keep working. Every change is confirmed by you before it is sent: your client shows a confirmation prompt if it supports MCP elicitation, otherwise the tool returns a summary and a one-time token that the agent can use only after you agree. The server also checks that your account has edit access to the counter.
By default the server talks stdio, started by your MCP client. For clients that connect by URL, or to share one running server between several clients, start it over Streamable HTTP:
npx yandex-metrica-mcp --http # http://127.0.0.1:7801/mcp
npx yandex-metrica-mcp --http --port 9000
Or set MCP_TRANSPORT=http (and MCP_HTTP_PORT). Every client gets its own session; they share one sign-in and one request budget. The server listens on 127.0.0.1 only and rejects requests whose Host or Origin is not local, so a web page cannot reach it. To listen on another interface (--host 0.0.0.0, e.g. in Docker) you must set MCP_HTTP_TOKEN; clients then send Authorization: Bearer . This is a local mode, not hosting: one user, one Yandex account.
metrika:read scope (see Authentication), plus metrika:write for the opt-in write tools. Whoever the credentials belong to must have access to the counters you query.Recommended: interactive login. No app registration needed — the server ships a built-in public OAuth client. Run once:
yandex-metrica-mcp auth # or, in dev: bun run auth
It opens the Yandex consent page in your browser; after you approve, the code is returned automatically over a loopback redirect (http://127.0.0.1:53682) — no copy-paste. If that port is taken, it falls back to showing a code you paste in (force that flow with auth --oob, or change the port with YANDEX_OAUTH_LOOPBACK_PORT). The token is cached at ~/.config/yandex-metrica-mcp/token.json (mode 0600) and is valid for ~1 year; re-run auth when it expires. The login uses authorization-code + PKCE, so no client secret is stored anywhere. A cached login takes precedence over YANDEX_METRIKA_TOKEN.
From your MCP client (no terminal). Not signed in yet? The server still starts — ask your agent to run the login tool and it does the same browser flow in-process (or returns a URL and takes the code via submit_code). Handy for GUI clients like Claude Desktop, where there is no terminal to run auth.
Static token. Get a token for an app with the metrika:read scope at https://oauth.yandex.ru and pass it as YANDEX_METRIKA_TOKEN — handy for CI or non-interactive use.
Own OAuth app (optional). To use your own app instead of the built-in one, set YANDEX_OAUTH_CLIENT_ID; add YANDEX_OAUTH_CLIENT_SECRET to also enable automatic token refresh.
The Quickstart covers the happy path. For all options — static token, your own OAuth app, default counter, request tuning, language — see .env.example. The published package runs on Node (so npx/MCP clients work out of the box); local development uses Bun.
Once connected, an agent can answer questions like:
run_report with metrics: ["ym:s:visits","ym:s:users"], dimensions: ["ym:s:lastsignTrafficSource"].run_comparison (server returns A, B, and the deltas).run_drilldown, then again with parentId.get_metadata.describe_counter (include: ["goals"]) for the goal id, then run_report with ym:s:goal conversionRate.logs_request (source: "visits"), poll logs_status, then logs_download (mode: "file"), then logs_clean to free the quota.This project is Bun-first:
bun install
bun run dev # run from source with hot reload bun run typecheck # tsc --noEmit bun run lint # eslint bun test # bun's test runner bun run build # emit dist/ with tsc (Node-compatible)
The skill has an eval suite in evals/ that runs against mocked Metrica tools, so it never touches the real API:
claude plugin eval . --ablation none
MIT © boxlab