Artemis has 16 tools with basic schemas and descriptions, but significant gaps prevent higher scores. All tools have descriptions (10-50 chars, mostly short), and input schemas are present with type definitions. However, descriptions are often too brief to guide LLM selection (e.g., 'Return the authenticated user's profile' lacks context on when to call it vs. update_me). Parameter descriptions are minimal or missing context. Output schemas are not documented. Error handling is absent, no guidance on retryability, user-fixable errors, or recovery paths. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Composition is reasonable (single responsibility per tool), but chaining support is weak, responses likely omit IDs needed for downstream calls. Security concerns: no visible secret injection pattern, no audit logging in tool definitions, no permission gates documented.

• Expand all tool descriptions to 100-200 chars. Include WHAT it does, WHEN to use it, and any prerequisites. E.g., 'Get the authenticated user's profile (name, email, avatar). Call this after login to display user info in the UI. Returns user_id needed for update_me.'
• Document output schemas for all tools. Specify returned fields, types, and which IDs are needed for chaining. E.g., register should return {jwt_token, user_id, email} so the agent can immediately call get_me or update_me.
• Add tool annotations: mark delete_automation with destructiveHint=true, mark get_me/list_automations with readOnlyHint=true, mark register/create_automation with idempotentHint=false (or true if idempotent).
• Add enum constraints to parameters. E.g., automation_type: enum=['aal', 'python']; status: enum=['success', 'failed']; role: enum=['user', 'assistant', 'system']. Replace free-form strings with formal constraints.
• Add error handling guidance to tool descriptions. E.g., 'If automation_id not found, returns 404 with available automation IDs. If user lacks permission, returns 403, check user role.' This guides agent recovery.