xkcd-mcp has 6 tools with clear, action-oriented names (xkcd_latest, xkcd_get, xkcd_search, xkcd_random, show_comic_prefab_card, xkcd_help). All tools have descriptions (10 - 200 chars, within baseline 10 - 1024 range). Input schemas are present and typed for most tools. However, parameter descriptions are sparse or missing entirely. xkcd_latest and xkcd_random have empty input objects with no documentation. xkcd_get's 'comic_number' param lacks guidance on valid ranges or error cases. xkcd_search's 'query' param has minimal description. Output schemas are not documented, LLMs cannot predict the structure of returned comic objects. Error handling is basic (generic 'Unexpected error' messages). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all tools being read-only. Composition is sound: tools are single-purpose and chainable (e.g., xkcd_search returns comic numbers that xkcd_get can fetch). Naming follows verb_noun convention well.

• Document output schemas for all tools. Add a 'Returns' section to each tool docstring specifying the structure: {num: int, title: str, img: str, alt: str, xkcd_url: str, explainxkcd_url: str, published: str}.
• Add parameter descriptions to xkcd_latest and xkcd_random input schemas (currently empty objects). Even if no params are required, document this explicitly: 'No parameters required.'
• For xkcd_get, add range guidance: 'comic_number (integer, 1 - latest): The comic number to fetch. Use xkcd_latest to discover the current max number.'
• Add tool annotations via FastMCP. Mark all tools with readOnlyHint=true to signal they are safe for retry and have no side effects.
• Improve error messages with recovery hints. E.g., 'Comic #9999 not found. Try xkcd_latest to see the current max number, or xkcd_search to find comics by topic.'