Three tools with complete schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool names follow verb_noun convention (generate_image, get_user_info, generate_video). Descriptions are present (avg 150 chars) but lack actionable context for LLM selection. Most parameters have descriptions, but several lack type constraints or format guidance. No documented output schemas. Error handling returns isError flag but lacks recovery guidance or categorization.

• Document output schemas for all three tools. Example for generate_image: {type: 'object', properties: {urls: {type: 'array', items: {type: 'string', format: 'uri'}}, count: {type: 'number'}}}. This enables LLMs to extract and chain results.
• Add constraints to 'model' parameters. Replace 'ID du modèle litmedia (défaut 14)' with 'Numeric model ID (1-50, default 14). Call get_user_info to list allowed models for your account.' Provide enum or range bounds.
• Enhance error messages with recovery hints. Instead of returning raw error text, categorize: {isError: true, category: 'retryable'|'user_fixable'|'fatal', message: '...', suggestion: 'Try again in 30s' or 'Check your credits' or 'Contact support'}.
• Add per-tool permission declarations. Each tool should declare required scopes (e.g. generate_image requires 'write:image', get_user_info requires 'read:account'). Enables least-privilege agent config.
• Implement audit logging. Log each tool call with timestamp, tool name, parameters (excluding secrets), and result. Write to stderr or structured log file for compliance and debugging.