Tools have basic descriptions and input schemas, but quality is inconsistent. Descriptions are generic and lack actionable context (e.g., 'Get all DAOs' vs 'Retrieve all DAOs in the Futarchy system with their current voting parameters and treasury balances'). Parameter descriptions are minimal, most are single-phrase identifiers without format guidance, constraints, or dependency hints. No output schemas documented. Error handling is absent from tool definitions. Tool names follow verb_noun convention but lack specificity for market operations (buyInPassMarket vs buyPassMarketTokens). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Composition is reasonable, tools are single-purpose, but chaining is not optimized (e.g., createProposal requires daoId but getDao returns a DAO object; unclear if the returned ID matches the parameter type).

• Expand all tool descriptions to 50 - 200 characters. Include WHAT the tool does, WHEN to use it (vs similar tools), and WHAT it returns. Example: 'Retrieve all DAOs in the Futarchy system. Returns DAO metadata including treasury balance, voting parameters, and token mints. Call this first to discover available DAOs before querying proposals.'
• Add format and constraint guidance to all parameters. Example: 'daoId: Solana PublicKey as base58 string (44 chars, e.g., 9B5X...). Required.' For numeric params: 'amount: Token count as integer, minimum 1, maximum 1000000.'
• Document output schemas for all tools. Specify field names, types, and whether results are paginated. Example: 'Returns {daos: [{id: string, name: string, treasury: number, votingThreshold: number}], total: number}'.
• Add tool annotations (readOnlyHint, destructiveHint, idempotentHint) to all tools. Market trading tools should be marked destructiveHint=true. Getter tools should be marked readOnlyHint=true.
• Implement confirmation pattern for market trading tools. Add a dry_run parameter or a separate preview_trade tool that returns estimated outcome without executing. Document that trades are irreversible and require explicit user confirmation.