MCP server for fetching games by category from the FreeToGame API
Single tool with minimal definition quality. Tool name 'get_games_by_category' follows verb_noun convention (+), but description is vague and lacks actionable context. Input schema present but parameter description is generic ('Category for the games that you want'). No output schema documented. No error handling guidance. No pagination despite likely returning lists. Tool does one thing but lacks production-grade polish.
Get Games by Category. Input is Category as Text and the Output is List of Games ex. shooter
No output schema documented. LLMs cannot plan downstream operations or extract structured data from results. Code shows results are mapped to TextContent(it), unclear what 'it' contains or how to parse it.
Parameter description is generic and lacks format/constraint guidance. 'Category for the games that you want' does not explain valid values, format, or examples. Should specify: 'Category name (e.g., shooter, rpg, strategy). See list_game_categories for valid options.'
No pagination support visible. Tool likely returns lists but no limit, offset, or cursor parameters. Large result sets will blow context windows. Should add limit (default 20, max 100) and offset/cursor parameters.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Tool description lacks WHEN/WHY context. Current: 'Get Games by Category. Input is Category as Text and the Output is List of Games ex. shooter'. Should explain: when to use this vs other discovery tools, what 'category' means in the domain, and what fields are returned.
Error handling returns bare error messages without recovery guidance. Code shows 'CallToolResult(error(result.message ?: ""))', if API fails, LLM gets no hint on what to do next (retry, try different category, check network, etc.).