A single MCP server that fronts many Grafana instances by adding an `instance` argument to every upstream mcp-grafana tool.
Single tool with adequate naming and schema, but critical gaps in parameter descriptions and output documentation. The tool 'list_grafana_instances' follows verb_noun convention and has a clear purpose. Input schema is present with proper types. However, parameter descriptions are minimal (check_health has 113 chars, acceptable but sparse), and critically, there is NO documented output schema visible in the source. The tool description (127 chars) is adequate but lacks guidance on when to call it or what structure it returns. No error handling guidance. The server exposes only one tool, limiting composition patterns. Tool annotations (readOnlyHint) are present, which is positive for protocol readiness but does not compensate for missing output documentation.
List the Grafana instances this server can route to, with each one's URL, description, and whether a connection to it is currently live. Use the returned names as the `instance` argument of any other tool.
Output schema not documented. Tool returns instance list but no schema visible for response structure (fields, types, pagination). LLMs cannot plan downstream calls without knowing what fields to extract.
Parameter 'check_health' description lacks guidance on performance trade-off. States it is 'slower' but does not quantify impact or recommend when to use. LLMs cannot reason about cost/benefit.
Tool description does not explain what 'instance' argument means or how to use returned names. States 'Use the returned names as the instance argument of any other tool' but does not clarify if names are opaque IDs or human-readable labels.
No error handling guidance. Tool description does not explain what happens if Grafana instances are unreachable, misconfigured, or return errors. LLM has no recovery path.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | <=2025-11-25 | v2 |
Single tool limits composition. Server only exposes list_grafana_instances; actual Grafana operations (list_datasources, etc.) are delegated to child mcp-grafana processes. This architecture is sound but means the unified server itself offers minimal tool surface for evaluation.