OKFy provides 4 read-only tools with consistent naming (verb_noun pattern: bundle_summary, search_concepts, read_concept, get_neighbors). All tools have descriptions (60-90 chars, within baseline 34-392 range) and input schemas with typed parameters. However, output schemas are not documented in the source code, and parameter descriptions lack detail on constraints, formats, and error recovery. No tool annotations (readOnlyHint, etc.) despite all being read-only. Error handling guidance is absent.

• Document output schemas for all tools. E.g., bundle_summary returns {title: string, readiness: string, sources: [{name: string, ...}]}. This enables LLM planning.
• Add min/max constraints to numeric parameters: limit (1-100), depth (1-5), max_chars (1-10000). Include in parameter descriptions.
• Add error recovery hints to read_concept and get_neighbors: 'If concept not found, call search_concepts() to verify the ID exists.'
• Annotate all tools with readOnlyHint: true in tool definitions to signal safety to agents.
• Clarify search_concepts pagination: does 'limit' cap results? Is there a cursor/offset for fetching more? Document in description.