@theyahia/yandex-metrika-mcp

MCP server for Yandex.Metrica API — counters, goals, reports, logs, traffic sources, top pages. 15 tools, OAuth Bearer token auth.

Part of the Russian API MCP series by @theYahia.

Getting a Token

1. Go to oauth.yandex.ru
2. Create an app (or use an existing one)
3. Under Platforms, select "Web services"
4. Under Access, add: Yandex.Metrica -> Read statistics and counter parameters
5. Get the OAuth token:
   Code

   Copy

   https://oauth.yandex.ru/authorize?response_type=token&client_id=YOUR_CLIENT_ID
   

6. Copy the token from the redirect URL (access_token=...)

Installation

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "your_token"
      }
    }
  }
}

Claude Code

claude mcp add yandex-metrika -e YANDEX_METRIKA_TOKEN=your_token -- npx -y @theyahia/yandex-metrika-mcp

Streamable HTTP (remote / multi-client)

YANDEX_METRIKA_TOKEN=your_token npx @theyahia/yandex-metrika-mcp --http --port=3000

Endpoint: POST http://localhost:3000/mcp Health check: GET http://localhost:3000/health

Smithery

Use smithery.yaml from the repository. Requires YANDEX_METRIKA_TOKEN.

Environment Variables

Tools (15)

Management — Counters

Management — Goals

Management — Logs

Reporting API

Convenience Wrappers

Demo Prompts

Show me all my Yandex.Metrica counters

Compare last week's traffic to the previous week for counter 12345678

What are the top 10 pages on my site this month, sorted by pageviews?

Development

npm install
npm run build
npm test
npm run dev           # stdio mode
npm run start:http    # HTTP mode on port 3000

API Reference

• Yandex.Metrica Management API
• Yandex.Metrica Reporting API
• Yandex.Metrica Logs API

License

MIT