Command-line interface for querying MostExpensiveWatches public data API. Provides access to watch statistics, brand information, listings, references, answers, reviews, alternatives, and auction data.
This server has 13 tools with basic schemas and descriptions, but significant quality gaps prevent production use. All tools lack verb prefixes (naming anti-pattern); descriptions are minimal (10-40 chars, well below the 50-200 char LLM-optimized baseline); parameters lack type constraints and detailed descriptions; output schemas are completely undocumented. No error handling guidance, no pagination support despite list-returning tools, no idempotency hints. The codebase shows raw API passthrough with no response shaping or field filtering. Tools like 'stats' and 'snapshot' have empty input schemas but no documentation of what they return.
Get a specific alternative by slug with optional language and limit parameters
Search watch alternatives with optional query, brand, language, and limit parameters
Get a specific answer by slug with optional language parameter
Search watch-related answers with optional query, brand, kind, language, limit, and summary parameters
Query watch auctions with optional brand filter and limit parameters
Query watches by brand slug with optional limit and language parameters
Get detailed information about a specific watch reference by slug
No verb prefixes in tool names. All 13 tools lack action verbs (get_, search_, list_). Names like 'stats', 'snapshot', 'brand', 'resolve' are ambiguous, LLMs cannot infer intent from the name alone. Pattern requires verb_noun naming.
Descriptions are too short (10-40 chars). Baseline for LLM-optimized descriptions is 50-200 chars. Current descriptions lack context on WHEN to use each tool, WHAT it returns, and HOW it differs from similar tools. E.g., 'Query MostExpensiveWatches statistics' tells the LLM nothing about the output structure or use case.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 42 | 2026-07-28+ | v2 |
Resolve watch references by query with optional brand filter and limit
Get a specific review by slug with optional language parameter
Search or list watch reviews with optional query, brand, language, and limit parameters
Search watch listings by query with optional limit
Query MostExpensiveWatches snapshot data
Query MostExpensiveWatches statistics
Output schemas completely undocumented. No tool declares what fields it returns, what types they are, or how to chain results to downstream tools. LLMs cannot plan multi-step workflows without knowing response structure. Pattern requires documented return types for 100% of tools.
No pagination support. Tools returning lists (search, answers, reviews, alternatives, auctions) accept 'limit' but lack offset/page/cursor parameters and do not document total count or next_cursor. Large result sets will blow context windows. Pattern requires paginated-result support.
No error handling guidance. Code calls urllib.request.urlopen() with no try/except, no timeout handling, no recovery hints. If an API call fails, the agent receives a raw exception with no actionable next step. Pattern requires recovery-guide and error-classification.