MCP server for Convex Finance - Boosted Staking for Curve, Frax, f(x)
Four tools with clear verb-noun naming (convex_get_*, convex_calculate_*) and solid descriptions (avg 120 chars). All tools have input schemas with Zod validation and type constraints. However, output schemas are undocumented, responses are JSON-stringified text without declared field structure. Parameter descriptions are present but minimal (avg 45 chars); some lack actionable format guidance. Error handling returns generic messages without recovery hints. No tool annotations (readOnlyHint, idempotentHint) despite all being read-only operations.
Calculate projected APY for a Convex pool (base trading fees + CRV rewards + CVX rewards)
List all Convex pools (Curve LP tokens with boosted rewards). Returns pool IDs, LP tokens, gauges, and APRs.
Get user position on Convex for a specific pool (staked LP tokens + claimable rewards)
Get global Convex Finance stats (TVL, emissions controlled, platform revenue, treasury)
Output schemas undocumented. All tools return JSON-stringified text without declared field structure. LLMs cannot plan downstream operations or extract typed data reliably.
Error messages lack recovery guidance. 'Error fetching pools: <message>' tells LLM nothing about retry eligibility or next steps. Should include 'This is a transient API error; retry in 30s' or 'Invalid pool ID; call convex_get_pools to list valid IDs.'
No tool annotations. All four tools are read-only and idempotent but lack readOnlyHint/idempotentHint annotations. Agents cannot distinguish safe tools from destructive ones without reading descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Parameter descriptions lack format guidance. 'Ethereum address (0x + 40 hex chars)' is present but 'Amount of LP tokens staked (in USD value)' does not clarify precision (decimals?), range, or units. Should state 'USD value as decimal number, e.g. 1000.50, min 0.01'.
convex_get_stats has empty input schema but description does not state 'No parameters required.' LLMs may attempt to pass parameters, causing confusion.