MCP tool for querying Max streaming service prices by country
Single tool with basic schema and description. Tool name 'query_max_price' follows verb_noun convention but description is minimal (58 chars, below 100-char baseline for clarity). Input schema present with types and descriptions for both parameters, but lacks output schema documentation entirely. No error handling guidance, no pagination support, no idempotency markers. Parameter descriptions are adequate but generic. No tool annotations (readOnlyHint, etc.). Overall structure is functional but falls short of production-grade quality standards.
Query Max streaming service prices for a specific country
Missing output schema documentation. Tool returns unspecified data structure; LLM cannot plan downstream operations or extract pricing fields reliably.
Tool description too brief (58 chars). Does not explain WHEN to use this tool, what data is returned, or how to interpret results. LLMs need 100-200 char descriptions for reliable selection.
No error handling guidance. Tool calls external APIs (Max website, proxy service) with no documented failure modes, retry logic, or recovery instructions for LLM.
No tool annotations. Missing readOnlyHint (this is a read-only query), which prevents agents from reasoning about idempotency and retry safety.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 37 | <=2025-11-25 | v2 |
Proxy API credentials hardcoded in source (user=Domo_lee, pass=UNuYSniZ8D). Violates secret-injection pattern; credentials should be environment variables or vault.