The server has 31 well-named, verb-prefixed tools covering a comprehensive analytics domain. All tools have descriptions and properly typed input schemas with field-level annotations. However, output schemas are completely undocumented, the tools return raw `str` with no guidance on response structure. Parameters are well-described for the most part, but several generic analytics tools lack nuance on when/why to use them, and there is no documented error recovery guidance. The tool set exhibits good composition (minimal overlap, clear naming), but lacks the structured output and error handling patterns expected of production-grade servers.
Compare metrics between two filtered segments.
Compare metrics between two segments with hierarchical drilldown.
Get basic account and counter information from Yandex Metrika.
Get browser usage statistics.
Get detailed report on article views grouped by article.
Get statistics on article authors performance.
Output schemas completely undocumented. All 31 tools return raw `str` with no schema, field types, or example response structure. LLMs cannot parse responses or plan downstream tool chains without knowing what fields to expect.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 59 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 0 | - | v1 |
Retrieve overall statistics by content category.
Get sources that drive users to website articles.
Analyze performance by article topics.
Analyze conversion rates by traffic source and landing page.
Get analytics data grouped by time period with optional dimensions and filtering.
Analyze user behavior by browser and operating system.
Get hierarchical drilldown data for specified dimensions and metrics.
Get e-commerce performance data including purchases and revenue by product category and region.
Get organic traffic data by geographic regions.
Get conversion rates for specified goals.
Compare traffic and engagement metrics between mobile and desktop users.
Identify which traffic sources are most effective in acquiring new users.
Analyze search engine and search phrase performance for organic traffic.
Get sessions where users viewed more than the specified number of pages.
Analyze individual page performance metrics including bounce rate and visit duration.
Get sessions and users data for specific regions/cities.
Get sessions and users data from search engines with optional filters.
Analyze different types of traffic sources (organic, direct, referral).
Access user demographics and engagement by device category.
Retrieve visit statistics with optional date range (defaults to last 7 days).
Get performance metrics for a Yandex Direct A/B experiment.
List all Yandex Metrika counters available to this account. Use this to find counter IDs.
List all conversion goals configured for a counter. Use goal IDs with get_goals_conversion.
Retrieve search phrases and browser information from traffic sources.
Get comprehensive traffic sources overview and summary report.
No error handling documentation. Tools provide no guidance on retryable vs fatal errors, invalid parameter values, or recovery steps. LLMs will not know how to react to API failures.
Many tool descriptions are generic and could apply to multiple tools (e.g., 'Get overall statistics by content category' for get_content_analytics_categories; 'Get detailed report...' for get_content_analytics_articles). Lack of differentiation cues may cause LLM to select wrong tool when multiple analytics views available.
Many optional date range parameters (date_from, date_to) lack documented defaults. Description states 'defaults to last 7 days' for get_visits but this is not stated for most other tools. LLMs need explicit default behavior documentation.
Tool composition issue: get_conversion_rate_by_source_and_landing contains 'and' in name, indicating two concerns (conversion rates by source AND by landing page). Should be split into separate tools for clarity and single-responsibility principle.
No pagination guidance for list_counters. Accepts per_page param but no documentation on how to fetch subsequent pages (cursor/offset mechanism). Tools returning lists should clearly document pagination patterns.