29 tools with significant definition gaps. Most tools have descriptions (good), but parameter schemas are incomplete or missing type information. Many parameters lack descriptions entirely. No output schemas documented. Error handling is absent, tools do not guide recovery or categorize failures. Tool names follow verb_noun convention (positive), but composition issues exist: multiple tools operate on similar resources without clear distinction (e.g., get_moonpay_config, get_moonpay_status, get_moonpay_balance all query MoonPay state). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Security concerns: tools like evaluate_plan and respond_to_approval perform WRITE operations but lack confirmation/dry-run patterns. Baseline: 549 production tools average 194 chars for descriptions and 72 chars for params; this server's descriptions are adequate but params are under-documented.

• Document output schemas for all 29 tools. Specify field names, types, and whether results are paginated. Example: get_treasury_state should return {available_yield: number, principal: number, total_spent: number, per_tx_cap: number}.
• Add descriptions to all parameters. For tools with no input schema (get_staking_apy, get_active_governance_proposals, load_yield_strategy, get_moonpay_config, get_moonpay_status, get_moonpay_balance, get_moonpay_portfolio, list_agents), define input schemas with type and description for each parameter.
• Implement error handling with recovery guidance. For each WRITE tool, return structured errors: {error_code, message, recovery_action}. Example: 'Agent frozen. Call unfreeze_agent(agent_id) to restore.' Categorize as retryable|user_fixable|fatal.
• Add tool annotations to all WRITE tools. Mark evaluate_plan, respond_to_approval, stake_wsteth, unstake_wsteth, execute_swap, execute_moonpay_swap, execute_moonpay_dca, execute_moonpay_bridge, freeze_agent, unfreeze_agent with destructiveHint=true. Add idempotentHint=true to idempotent operations.
• Consolidate overlapping MoonPay query tools. Merge get_moonpay_config, get_moonpay_status, get_moonpay_balance, get_moonpay_portfolio into a single get_moonpay_account_info tool with optional filters (include_config, include_balance, include_portfolio). Reduces LLM decision overhead and improves clarity.