This server has 16 tools with uneven definition quality. Most tools have clear French descriptions (averaging ~60 chars, below the ideal 194 baseline) and reasonable naming. However, critical gaps exist: (1) No parameter descriptions for most tool inputs, only type/enum constraints are visible, no explanations of what each parameter controls. (2) No visible output schemas documented anywhere, LLMs cannot infer what these tools return. (3) Parameter descriptions that do exist are minimal ('Niveau de volume', 'Direction de navigation') and lack context about when to use the tool. (4) Error handling is completely absent from definitions. The schema quality is inconsistent: some tools like set_volume have min/max constraints, but many lack any validation hints. Tool composition is reasonable, most tools are single-purpose (play_movie, stop_player, search_movies). However, tools like find_and_play combine search+playback, which is acceptable for convenience but slightly violates single-responsibility. The naming convention is generally good (verb_noun style: get_*, list_*, play_*, search_*), but descriptions are too terse and generic to reliably guide LLM selection.

• Document output schema for every tool. Example for get_now_playing: 'Returns {title: string, duration_ms: integer, elapsed_ms: integer, player_state: enum(playing|paused|stopped)}'.
• Expand tool descriptions to 50-200 characters. Example: 'Toggle play/pause on the active Kodi media player. If media is playing, pauses it; if paused, resumes. Has no effect if no media is loaded.'
• Add descriptions to all zero-parameter tools. Example for player_stop: 'Immediately halts playback on Kodi. Returns {success: boolean, stopped_at_ms: integer}. Use after play_* to cancel unwanted playback.'
• Document pagination behavior in list_* tools. Add clarification: 'Returns up to `limit` items. If more items exist, include next_cursor in response for fetching additional pages.' Ensure responses include total_count.
• Add error recovery hints. Example for play_movie: 'If movie_id is not found, call search_movies first with the movie title to get the correct ID.'
• Include per-field descriptions in all parameter definitions. Example for set_volume: 'level (integer, 0-100): the volume level. 0 is mute, 100 is maximum.'
• For stateful operations (scan_library, play_*), document whether they are idempotent. Example: 'Idempotent: calling play_movie twice with the same movie_id plays from the beginning both times, without duplicate queue entries.'
• Add required/optional clarity. Example: 'limit (optional, default 20): number of results. If omitted, returns 20 items.'
• Document Kodi prerequisites in tool descriptions. Example for play_episode: 'Requires tvshow_id from list_tv_shows. Season and episode numbers are 1-indexed (season 1 = first season).'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry