claudeers.
// MCP Servers

yandex-metrika-mcp

Read-only MCP server for Yandex Metrika (Яндекс Метрика): verifiable reports, period comparisons, time series and exports for Claude, Cursor, VS Code and Codex.

// MCP Servers[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai-agents#analytics#claude-code#claude-desktop#codex#cursor#mcp#mcp-servers◷ MIT$open-sourceupdated 10 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up yandex-metrika-mcp (claude-plugin project) into my current project.
Found on https://claudeers.com/yandex-metrika-mcp
Repo: https://github.com/DevCrabs-Inc/yandex-metrika-mcp
Homepage/docs: —
Detected install method: claude-plugin → /plugin install yandex-metrika-mcp@DevCrabs-Inc/yandex-metrika-mcp
Category: mcp-servers. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add DevCrabs-Inc/yandex-metrika-mcp
/plugin install yandex-metrika-mcp@DevCrabs-Inc/yandex-metrika-mcp
// or clone
git clone https://github.com/DevCrabs-Inc/yandex-metrika-mcp

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Yandex Metrika MCP logo: a crab holding a chart

Yandex Metrika MCP

Read-only MCP server for Yandex Metrika (Yandex Metrica, Яндекс Метрика). Connect it to Claude, Cursor, VS Code, Codex or any MCP client and ask about traffic, sources, landing pages and goals. Every answer comes with exact dates, the counter time zone, sampling status, filters and provenance, so the numbers can be checked.

Документация на русском: README.ru.md и docs/ru.

Status: 1.0.0, the first stable release; tool names, arguments and outputs follow semantic versioning. Covered by tests against synthetic data and a simulated API, and checked with a live Yandex sign-in and reports on macOS. Other clients and platforms are tracked in docs/release-checklist.md.

Website and guides

Why this server

  • Sign in through the browser. No token pasting, no OAuth app of your own; the token never enters the chat.
  • Numbers you can verify. Calendar periods in the counter time zone, complete days by default, strict accuracy that refuses sampled data instead of calling it exact, API totals instead of sums of visible rows.
  • Several accounts and clients. Isolated connections with their own counters; nothing is shared between them.
  • Full exports. Background CSV/JSON export of every row with checksums, a manifest and resume after a restart.
  • Small, predictable surface. 13 tools, 3 prompts. Read-only: no write endpoints, no raw HTTP tool.

Install

Requires Node.js 22.13 or later. No API key and no OAuth app of your own: after installing, ask the assistant to connect Yandex Metrika and sign in through the browser.

One command (writes the client config and keeps a backup):

npx -y @dev-crabs/yandex-metrika-mcp setup --client claude-desktop   # or claude-code, cursor, vscode, windsurf, codex

One click:

Install in Cursor Install in VS Code

Claude Code:

claude mcp add --scope user yandex-metrika -- npx -y @dev-crabs/yandex-metrika-mcp

Any MCP client (mcpServers format; VS Code uses servers with "type": "stdio"):

{
  "mcpServers": {
    "yandex-metrika": { "command": "npx", "args": ["-y", "@dev-crabs/yandex-metrika-mcp"] }
  }
}

On Windows some clients cannot start npx directly; use "command": "cmd", "args": ["/c", "npx", "-y", "@dev-crabs/yandex-metrika-mcp"], which is what setup writes there. Claude Desktop users can also install the .mcpb bundle from the GitHub release. AI agents installing the server should follow llms-install.md.

Restart the client and ask: "Connect Yandex Metrika and compare the last two weeks by traffic source." The assistant calls metrika_connect and gives you a local sign-in link. Try it without an account: the synthetic conn_demo connection is always available.

Example questions

  • "Compare the last two complete weeks by visits and target visits of goal 3001."
  • "Which landing pages brought the most leads for goal X last month?"
  • "Show weekly visits since the start of the quarter."
  • "Export all traffic sources for October to CSV for Excel."

Tools

ToolPurpose
metrika_statusConnections, exports and the next step. Works before sign-in.
metrika_connect / metrika_disconnectBrowser sign-in; local removal of a connection and its token.
metrika_list_counters / metrika_describe_counterSites, time zones and goals with IDs.
metrika_catalogPresets, metrics (with aggregation rules), dimensions, period presets.
metrika_run_reportOne period: presets or explicit fields, filters, sorting, paging.
metrika_compare_periodsTwo periods under identical conditions: absolute, % and p.p. changes.
metrika_run_timeseriesDay, week or month buckets with exact calendar boundaries.
metrika_export_report / metrika_get_job / metrika_cancel_job / metrika_read_artifactFull CSV/JSON exports as resumable background jobs.

Prompts: weekly_review, traffic_drop, landing_conversion.

Data and privacy

Report data you request is sent to your AI client and its model provider; tokens never are. Tokens live in the OS credential store (macOS Keychain, Windows Credential Manager, Linux Secret Service). Without one, the server refuses to store tokens unless you explicitly choose an unencrypted user-only file. URL query strings are removed from labels by default. No telemetry. Details: docs/ru/privacy-security.md.

Development

pnpm install
pnpm check        # Biome, tsc, vitest
pnpm build        # dist/cli.js
pnpm mcpb         # build/yandex-metrika-mcp-<version>.mcpb

See CONTRIBUTING.md and AGENTS.md. Security reports: SECURITY.md.

License

MIT © DevCrabs

// faq

What is yandex-metrika-mcp?

Read-only MCP server for Yandex Metrika (Яндекс Метрика): verifiable reports, period comparisons, time series and exports for Claude, Cursor, VS Code and Codex.. It is open-source on GitHub.

Is yandex-metrika-mcp free to use?

yandex-metrika-mcp is open-source under the MIT license, so it is free to use.

What category does yandex-metrika-mcp belong to?

yandex-metrika-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

6 views
★ 127 stars
unclaimed
updated 10 days ago

// embed badge

yandex-metrika-mcp on Claudeers
[![Claudeers](https://claudeers.com/api/badge/yandex-metrika-mcp.svg)](https://claudeers.com/yandex-metrika-mcp)

// retro hit counter

yandex-metrika-mcp hit counter
[![Hits](https://claudeers.com/api/counter/yandex-metrika-mcp.svg)](https://claudeers.com/yandex-metrika-mcp)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how yandex-metrika-mcp connects across the ecosystem