MCP server for interacting with CVEX Trading API
Server has 5 tools with basic schemas and descriptions, but significant gaps prevent production use. All tools have descriptions (10-50 chars, below the 50-200 char baseline for LLM optimization) and input schemas are present but minimal. Parameter descriptions are entirely absent, LLMs cannot infer what 'contractId', 'side', 'type', 'amount', or 'limitPrice' mean without explicit guidance. The placeOrder tool (IRREVERSIBLE risk) lacks confirmation/dry-run support and has no error recovery guidance. Output schemas are undocumented. No tool annotations (readOnlyHint/destructiveHint) despite clear risk differentiation. Naming is verb-forward (getMarketData, placeOrder) but descriptions are too terse to guide LLM selection.
Estimate an order without executing it
Get detailed account information including balances
Get detailed information about a specific contract
Get market data for a specific contract
Place a new order on the exchange
All parameter descriptions missing. LLMs cannot infer meaning of 'contractId', 'side', 'type', 'amount', 'limitPrice' without explicit guidance. Violates pattern:tool-description requirement that every parameter have a non-empty description.
Tool descriptions are 20-50 characters (baseline: 50-200 chars for LLM optimization). Descriptions like 'Get market data for a specific contract' lack context on WHEN to use this tool vs getContractDetails, and do not explain what data is returned.
placeOrder (IRREVERSIBLE risk) lacks confirmation/dry-run support and no error recovery guidance. Agents can execute trades without safeguards. Violates pattern:confirmation-request and pattern:recovery-guide.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint/destructiveHint/idempotentHint) despite clear risk differentiation (READ_ONLY vs IRREVERSIBLE). LLMs cannot infer safety properties from tool names alone.
Output schemas undocumented. LLMs do not know what fields to expect from market data, contract details, or account info responses. Cannot plan downstream tool calls or extract required data.