A pay-per-call MCP server giving AI agents live crypto market data (price, 24h stats, trending). x402-ready.
Three tools with clear verb-noun naming (get_token_price, get_market_snapshot, get_trending) and concise descriptions (34-72 chars). All tools have input schemas with type declarations. However, parameter descriptions are missing entirely, the 'id' parameter in two tools lacks any explanation of format, valid values, or fallback behavior. Output schemas are undocumented; LLMs cannot predict response structure. Error handling is minimal (no recovery guidance). No tool annotations (readOnlyHint, idempotentHint). Composition is sound (each tool does one thing), but parameter documentation falls short of production baseline (100% of A+ tools have param descriptions).
24h price snapshot for a token: price, volume, high, low, open (by id or symbol).
Current USD price + 24h change for a crypto token (by id like 'bitcoin'/'ethereum' or symbol like 'BTC').
Top movers among major tokens right now, ranked by 24h % change.
Parameter 'id' lacks description in get_token_price and get_market_snapshot. LLMs cannot infer that it accepts both CoinGecko-style IDs ('bitcoin') and Coinbase symbols ('BTC'), or how resolution works on invalid input.
Output schemas are not documented. LLMs cannot predict response fields (e.g., does get_token_price return 'change_24h_pct' or 'change_pct'?). This forces trial-and-error parsing and wastes tokens.
No error recovery guidance. If Coinbase API returns 404 for an invalid token, the tool throws 'coinbase 404 for BTC-USD' with no hint to the LLM (e.g., 'try get_trending to see available tokens').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
No tool annotations. Tools are read-only and idempotent but lack readOnlyHint/idempotentHint in schema. Agents cannot infer safety properties without explicit hints.
get_trending returns a hardcoded list of 8 major tokens. No pagination or limit parameter. If the agent needs trending data for 50 tokens, this tool cannot scale.