AIMP server has 19 tools with basic naming and descriptions, but significant gaps in schema completeness and parameter documentation. All tools have descriptions (good), but most lack detailed parameter constraints, enums, and output schema documentation. No error handling guidance, no tool annotations (readOnlyHint/destructiveHint), and no pagination support for search results. Naming is mostly verb-noun (get_, set_, play_, etc.) but some tools like 'search_music' lack parameter type constraints and validation rules. Output schemas are not documented, LLMs cannot predict response structure. This is typical community-server quality: functional but not production-ready.

• Document output schemas for all tools. For get_current_track, specify: {title: string, artist: string, album: string, genre: string, year: string, filename: string, duration: string, position: string, duration_ms: int, position_ms: int}. For search_music, specify: {results: [{path: string, title: string, artist: string, album: string, year: string, genre: string}], total: int, limit: int, offset: int}.
• Add pagination to search_music: accept limit (1-50, default 20) and offset (default 0) parameters. Return total count and next_offset in response so LLMs can iterate through large result sets without context explosion.
• Add error recovery guidance to descriptions. E.g. play_file: 'Plays an audio file. Returns error if path does not exist or file is not a valid audio format. If file not found, try search_music() to locate the file first.'
• Add tool annotations in FastMCP registration: @mcp.tool(name='clear_playlist', description='...', annotations={'destructiveHint': True}) and @mcp.tool(name='get_current_track', annotations={'readOnlyHint': True}). This signals to LLMs which tools are safe to retry.
• Add min/max constraints to numeric parameters. set_volume: volume parameter should have minimum: 0, maximum: 100. seek: position_ms should have minimum: 0. Add format and length constraints to string parameters (e.g. filename max 255 chars, no path separators).