Serve the dashboard's numbers to an AI assistant over MCP. Speaks the Model Context Protocol on stdin/stdout.
Five tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. All tools are READ_ONLY analytics queries with minimal input validation. Descriptions are present but generic (avg ~60 chars, below 194-char baseline). Parameters lack detailed constraints, ranges, and format guidance. No error handling guidance, no output schema documentation, and no composition hints for chaining. Tool names lack action verbs (overview, pages, portals, realms, live are nouns/adjectives, not verb_noun pattern). This is a typical community-grade analytics dashboard with functional but under-specified tool definitions.
Who is on the site right now.
Headline metrics for the period, with deltas and achievements.
Most-visited pages.
Where traffic arrives from.
Traffic by country.
Tool names lack action verbs. 'overview', 'pages', 'portals', 'realms', 'live' are nouns/adjectives, not verb_noun pattern (e.g., 'get_overview', 'list_pages'). LLMs infer intent from names, these names are ambiguous about what action occurs.
No output schema documentation. Tools return data but no schema is visible in source code. LLMs cannot plan downstream calls or extract fields without knowing response structure.
Parameter descriptions lack constraints. 'days' and 'limit' have no min/max bounds, format guidance, or rationale. 'days' defaults to 7 but no explanation why or what range is valid.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
No error handling guidance. Tools are read-only but no documentation of failure modes (e.g., invalid date range, API quota exceeded, no data for period). LLMs have no recovery path.
No tool composition hints. Five separate analytics queries with no guidance on which to call first, how results chain, or what IDs/references are returned for downstream use.