AptosOracle provides 6 read-only tools with reasonable descriptions (avg 150 chars) and basic input schemas. All tools have descriptions and most parameters are typed. However, schemas lack formal JSON Schema structure (no explicit 'type', 'required', 'properties' blocks visible in registration), parameter descriptions are minimal or absent, and output schemas are not documented. Error handling is present but generic. No tool annotations (readOnlyHint, etc.). Naming is clear and verb-based (overview, account_info, module_check, protocol_tvl, stablecoin_check, defi_yields), following verb_noun convention. Composition is sound, each tool has one responsibility. Missing: structured output documentation, comprehensive parameter validation guidance, and recovery hints in error messages.

• Formalize input schemas with explicit JSON Schema: add 'type', 'required' arrays, 'minLength'/'maxLength' for strings, 'minimum'/'maximum' for integers. Example: account_info.address should be {type: 'string', minLength: 1, pattern: '^0x[a-fA-F0-9]+$', description: 'Aptos account address (0x...). Must be a valid hex address.'}
• Document output schemas for each tool. Add a 'returns' section to tool descriptions or a separate schema block listing field names, types, and meanings. Example: overview returns {chain: string, network: string, price: {usd: number, eur: number, change_24h: number}, network_stats: {chain_id: number, ledger_version: number, ...}}
• Enhance error messages with recovery guidance. Replace 'Account not found: {address}' with 'Account not found: {address}. Verify the address is valid (0x...). If you have a username, call search_accounts() first.'
• Add tool annotations to the tool registration. Mark all 6 tools with readOnlyHint: true to formally declare they do not modify state. This enables agents to reason about safety without parsing descriptions.
• Expand parameter descriptions with validation rules and examples. For protocol_tvl.protocol, add: 'Optional protocol slug (e.g., liquidswap, pancakeswap, thala). If omitted, returns top 20 Aptos protocols by TVL. Must match a known protocol slug or an error is returned.'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry