Litopys demonstrates solid tool design with well-structured schemas and clear descriptions. All 5 tools have explicit input schemas with typed parameters and enums where appropriate. Descriptions are substantive (100-250 chars), explaining both purpose and use cases. The knowledge graph domain is well-represented through litopys_search, litopys_get, litopys_related, and mutation tools (litopys_create, litopys_link). However, output schemas are not documented in the source code provided, and error handling guidance is minimal. Tool naming follows verb_noun convention (search, get, create, link, related) appropriately. Parameter descriptions are generally good but lack some actionable constraints (e.g., what happens if a node already exists in litopys_create, or retry guidance on failures).

• Document output schemas for all 5 tools. For litopys_search, specify: returns array of {id, type, summary, neighbours: [{id, type, summary, relation_type}], tags}. For litopys_create, specify: returns {id, type, name, created_at}. This enables LLMs to chain calls and extract IDs for downstream operations.
• Add error recovery guidance to litopys_create: 'If you get a conflict error (node already exists), call litopys_get(id) to inspect the existing node, then decide whether to update it via litopys_link or choose a different id.'
• Enhance litopys_create and litopys_link descriptions to state idempotency and side effects explicitly: 'This operation is idempotent, calling it twice with the same parameters produces the same result and does not create duplicates.' This guides agent retry logic.
• Add constraint validation guidance to 'as_of' parameter: 'ISO date in YYYY-MM-DD format. Must be >= graph's earliest event and <= today. If invalid or future-dated, returns an error with the valid range.'
• For litopys_search, clarify the 'neighbours' field behavior: 'When neighbours=true (default), each result includes depth-1 relations. Set neighbours=false for a bare keyword list to reduce token usage.' This helps agents optimize context.