Server data from the Official MCP Registry
MCP server for Yandex Metrika — web analytics, counters, goals, traffic (Russia)
About
MCP server for Yandex Metrika — web analytics, counters, goals, traffic (Russia)
Security Report
This is a well-structured MCP server for Yandex.Metrica analytics with proper OAuth Bearer token authentication. The code follows security best practices: tokens are sourced from environment variables only, all API requests include proper authorization headers, and input validation is performed via Zod schemas. No malicious patterns, hardcoded credentials, or dangerous operations were detected. Minor code quality observations (broad exception handling, error logging verbosity) do not materially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-theyahia-yandex-metrika-mcp": {
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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.
Part of the Russian API MCP series by @theYahia.
Getting a Token
- Go to oauth.yandex.ru
- Create an app (or use an existing one)
- Under Platforms, select "Web services"
- Under Access, add:
Yandex.Metrica->Read statistics and counter parameters - Get the OAuth token:
https://oauth.yandex.ru/authorize?response_type=token&client_id=YOUR_CLIENT_ID - 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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.