theyahia avatar

yandex-metrika-mcp

theyahia/yandex-metrika-mcp

Hooks Claude into Yandex.Metrica's Management, Reporting, and Logs APIs with OAuth Bearer auth. You get 15 tools covering the full lifecycle: create and manage counters, set up goals, pull flexible reports with custom metrics and dimensions, compare date ranges, drill down hierarchically, and export raw visit logs. Includes convenience wrappers for common queries like traffic summaries, source breakdowns, and top pages. If you're analyzing Russian web traffic or need programmatic access to Metrica data without leaving your Claude workflow, this covers the essentials. Requires an OAuth token from Yandex's developer console with read permissions for statistics and counter parameters.

GitHub stars
1
tools
15
transport
STDIO
last updated
May 1, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

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

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

No parameter schema in public metadata yet.

get_counterGet full details of a single counter by ID.

Get full details of a single counter by ID.

No parameter schema in public metadata yet.

create_counterCreate a new counter for a website.

Create a new counter for a website.

No parameter schema in public metadata yet.

update_counterUpdate counter name or site URL.

Update counter name or site URL.

No parameter schema in public metadata yet.

delete_counterPermanently delete a counter (irreversible).

Permanently delete a counter (irreversible).

No parameter schema in public metadata yet.

list_goalsList all goals for a counter.

List all goals for a counter.

No parameter schema in public metadata yet.

create_goalCreate a goal (url, number, step, action types).

Create a goal (url, number, step, action types).

No parameter schema in public metadata yet.

delete_goalDelete a goal from a counter.

Delete a goal from a counter.

No parameter schema in public metadata yet.

export_logsExport raw visit/hit logs via the Logs API.

Export raw visit/hit logs via the Logs API.

No parameter schema in public metadata yet.

get_reportFlexible reporting — any metrics + dimensions + filters + sort.

Flexible reporting — any metrics + dimensions + filters + sort.

No parameter schema in public metadata yet.

get_report_comparisonCompare two date periods (A vs B).

Compare two date periods (A vs B).

No parameter schema in public metadata yet.

get_report_drilldownHierarchical drill-down into report dimensions.

Hierarchical drill-down into report dimensions.

No parameter schema in public metadata yet.

get_traffic_summaryQuick overview: visits, pageviews, users, bounce rate, avg duration.

Quick overview: visits, pageviews, users, bounce rate, avg duration.

No parameter schema in public metadata yet.

get_traffic_sourcesTraffic sources breakdown by channel.

Traffic sources breakdown by channel.

No parameter schema in public metadata yet.

get_top_pagesTop pages by pageviews with performance metrics.

Top pages by pageviews with performance metrics.

No parameter schema in public metadata yet.

Sponsors

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

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:


View the full README on GitHub

Details

Repository
github.com/theyahia/yandex-metrika-mcp
Website
github.com/theYahia/yandex-metrika-mcp
Category
Monitoring & Observability
Package
@theyahia/yandex-metrika-mcp
Transport
STDIO
Registry
MCP registry, active

More from theyahia

Related Monitoring & Observability MCP servers

View all
1verygoodplugins avatarMCP Pirschverygoodplugins/mcp-pirschPirsch Analytics with natural language queries and trend analysis1stars
21clickreport avatar1ClickReport1clickreport/mcp75 tools for marketing analytics, campaign management and AI monitoring across 7 platforms.0stars
3abhiyoheswaran1 avatarTokenTraceabhiyoheswaran1/tokentraceLocal-first AI CLI usage analytics for agents.0stars
4rootdata avatarRoot Data Public Directoryai.rootdata/public-directoryPublic Root Data dental analytics directory for DSOs, dental practices, blog, and FAQ tools.0stars
5apexflowlabsllc avatarApex Flow 3D Scraperapexflowlabsllc/apex-flow-web-scraperScrape, crawl and monitor public pages as Markdown with change tracking and source receipts.0stars
6bbb-build avatarMascope Mcpbbb-build/mascope-mcpWorld MiniApp reviews and analytics — verified human ratings via World ID0stars