MCP server providing cryptocurrency market data tools via Binance API
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation, output schema clarity, and error handling. Tool names lack clear action verbs (hello_world, spot_ticker_price, spot_kline are vague about intent). Descriptions are present but minimal (10-30 chars), below the 50-200 char LLM-optimized baseline. Parameters have type and description, but no enums for constrained inputs (e.g., 'interval' should enumerate valid kline intervals). No documented output schemas, callers cannot predict response structure. No error handling guidance. spot_kline has optional parameters but no documentation of dependencies or defaults.
Hello World Tool
Get the current kline of a coin
Get the current price of a coin
Tool names lack action verbs. 'hello_world' does not convey intent; 'spot_ticker_price' and 'spot_kline' are noun-heavy and ambiguous about whether they fetch, update, or compute. LLMs struggle to infer when to call these tools.
Descriptions are too short (10-30 chars). 'Hello World Tool', 'Get the current price of a coin', 'Get the current kline of a coin' lack context for LLM selection. Should explain WHAT, WHEN to use, and WHAT is returned (50-200 char baseline).
No output schemas documented. Callers cannot predict response structure. spot_ticker_price returns raw JSON string; spot_kline returns JSON array of Kline objects. LLMs must guess field names and types, risking parsing errors.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 35 | <=2025-11-25 | v2 |
No enums for constrained inputs. 'interval' parameter in spot_kline accepts free-form strings; should enumerate valid intervals (1m, 5m, 15m, 1h, 4h, 1d, etc.). LLMs will hallucinate invalid values.
No error handling guidance. HTTP errors from Binance API (invalid symbol, rate limit, network timeout) are returned as raw errors. LLMs cannot determine if retry is safe or what to do next.