1. Conduid
  2. Blockchain
  3. io.github.theYahia/yandex-metrika-mcp
MCP server · Blockchain

io.github.theYahia/yandex-metrika-mcp

by · github.com/theYahia/yandex-metrika-mcp

MCP server for Yandex.Metrika API — counters, reports, visitors, traffic sources. Bearer token auth

Unclaimed blockchain
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.theYahia/yandex-metrika-mcp

io.github.theYahia/yandex-metrika-mcp is an MCP server published by theYahia in the Blockchain category: mCP server for Yandex.Metrika API — counters, reports, visitors, traffic sources. Bearer token auth.

The repository has 1 stars and 1 forks, with the last commit a month ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add io-github-theyahia-yandex-metrika-mcp -- npx -y @theyahia/yandex-metrika-mcp
npx
npx -y @theyahia/yandex-metrika-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (5)

create_counterCreate a new counter for a website.

Parameters not published.

delete_counterPermanently delete a counter (irreversible).

Parameters not published.

get_counterGet full details of a single counter by ID.

Parameters not published.

list_countersList all counters. Filter by name/URL with `search_string`.

Parameters not published.

update_counterUpdate counter name or site URL.

Parameters not published.

Ask AI

✦

Ask AI about io.github.theYahia/yandex-metrika-mcp

Powered by Claude · Grounded in docs

I know everything about io.github.theYahia/yandex-metrika-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

@theyahia/yandex-metrika-mcp

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

npm

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: 
    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

Variable Required Description
YANDEX_METRIKA_TOKEN Yes OAuth 2.0 Bearer token from Yandex OAuth

Tools (15)

Management — Counters

Tool Description
list_counters List all counters. Filter by name/URL with search_string.
get_counter Get full details of a single counter by ID.
create_counter Create a new counter for a website.
update_counter Update counter name or site URL.
delete_counter Permanently delete a counter (irreversible).

Management — Goals

Tool Description
list_goals List all goals for a counter.
create_goal Create a goal (url, number, step, action types).
delete_goal Delete a goal from a counter.

Management — Logs

Tool Description
export_logs Export raw visit/hit logs via the Logs API.

Reporting API

Tool Description
get_report Flexible reporting — any metrics + dimensions + filters + sort.
get_report_comparison Compare two date periods (A vs B).
get_report_drilldown Hierarchical drill-down into report dimensions.

Convenience Wrappers

Tool Description
get_traffic_summary Quick overview: visits, pageviews, users, bounce rate, avg duration.
get_traffic_sources Traffic sources breakdown by channel.
get_top_pages Top pages by pageviews with performance metrics.

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

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.theYahia/yandex-metrika-mcp

How do I install io.github.theYahia/yandex-metrika-mcp?

Run claude mcp add io-github-theyahia-yandex-metrika-mcp -- npx -y @theyahia/yandex-metrika-mcp, then add the server to your MCP client's configuration.

Is io.github.theYahia/yandex-metrika-mcp safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.theYahia/yandex-metrika-mcp still maintained?

Yes — the last commit was a month ago. The repository has 1 stars and 1 forks.