Server has 5 tools with complete schemas and descriptions, but quality is uneven. Tool names follow verb_noun convention (velog_upload_image, velog_create_post, velog_list_posts, velog_get_post, velog_pull_post). Descriptions are present but vary in clarity, velog_create_post has detailed context (180+ chars) explaining the safety default (is_temp=True), while velog_upload_image is minimal (80 chars). Parameter descriptions exist for all tools but lack constraint details (e.g., no guidance on file path format, image size limits, or tag count). Output schemas are not explicitly documented, tools return strings rather than structured objects, forcing LLMs to parse unstructured text. Error handling is absent from visible code; no guidance on retryability or recovery paths. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (WRITE vs READ_ONLY).

• Convert all tool outputs from plain strings to structured JSON objects. E.g., velog_create_post should return {post_id, title, url, tags, is_temp} instead of formatted text. This enables downstream tool chaining and data extraction.
• Add parameter constraints to all tools: file_path/markdown_path (format: 'absolute or relative path to .md/.png/.jpg file'), tags (array of 1-5 strings, each 1-20 chars), limit (integer 1-100, default 10), output_dir (must be writable directory).
• Implement tool annotations via FastMCP: mark velog_create_post and velog_pull_post with destructiveHint=true; mark velog_list_posts and velog_get_post with readOnlyHint=true. Mark velog_create_post with idempotentHint=false (is_temp=False is irreversible).
• Add error handling with recovery guidance. Catch AuthError, FileNotFoundError, APIError and return structured errors: {error_type, message, recovery_action}. E.g., 'AuthError: Token expired. Call auth-check to refresh credentials.'
• Enhance descriptions with dependency hints. E.g., velog_create_post: 'If you only have a URL slug, call velog_get_post first to fetch the markdown.' velog_pull_post: 'Requires the url_slug of a published post (find via velog_list_posts).'