Server has 11 well-named tools with consistent verb_noun patterns (chart_*, pine_*, quote_*, screenshot_*). All tools have descriptions (avg ~80 chars, within baseline 34-392). Input schemas are present and use Zod with type constraints (enums for timeframe, min/max for count). However, output schemas are NOT documented in the tool definitions, LLMs cannot see what fields to expect from responses. Error handling is minimal: no recovery guidance, no categorization of retryable vs fatal errors. No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels. Parameter descriptions are adequate but lack dependency hints (e.g., 'Pine Editor must be open' is mentioned in pine_get_source but not in pine_set_source or pine_compile). Missing pagination for chart_get_ohlcv despite accepting a 'count' parameter up to 5000.

• Document output schemas for all tools. Add a 'returns' field to each ToolDef showing the Zod output schema, then expose it in ListToolsResponse. Example: chart_get_state returns {symbol: string, timeframe: string, studies: string[], lastPrice: number}.
• Add tool annotations to server.setRequestHandler(ListToolsRequestSchema). Map Risk levels to MCP annotations: Risk.WRITE → destructiveHint=true, Risk.READ_ONLY → readOnlyHint=true. Idempotent tools (chart_set_symbol, chart_set_timeframe) should have idempotentHint=true.
• Enhance error messages in CallToolRequestSchema handler. Return structured errors with 'code', 'message', and 'suggestion' fields. Example: {code: 'INVALID_INPUT', message: 'Invalid timeframe: got "2h", must be one of: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M', suggestion: 'Check the timeframe enum in the tool schema.'}
• Add prerequisite hints to pine_* tool descriptions. Update pine_set_source and pine_compile to state: 'Requires Pine Editor to be open in TradingView. Call pine_get_source first to verify the editor is accessible.'
• Document chart_get_ohlcv pagination and limits. Update description to: 'Fetch recent OHLCV bars from the active chart. Returns up to 5000 bars; for larger datasets, call multiple times with different timeframes or use chart_set_timeframe to adjust resolution.'