Meta-mcp provides 27 tools with consistent naming (verb_noun pattern) and reasonable descriptions across Instagram and Threads APIs. However, significant gaps exist: parameter descriptions are present but often minimal (10-30 chars), output schemas are not documented in the source, and error handling guidance is absent. Tool names are clear and action-focused (e.g., ig_post_comment, ig_delete_media), but descriptions lack guidance on WHEN to use each tool vs. similar ones, prerequisites, or recovery steps. Parameters have types but lack constraints (enums for pagination, format hints, range limits). No evidence of input validation, error categorization, or recovery guides in the provided source.

• Document output schemas for all tools. Specify the structure, field types, and which fields are always present vs. conditional. Use JSON Schema or prose (e.g., 'Returns {id: string, caption: string, media_type: enum, timestamp: ISO8601, like_count: number, comments_count: number}').
• Add range and format constraints to numeric and string parameters. E.g., 'limit (integer, 1-100, default 25)', 'after (opaque pagination cursor string from a previous response)'. Use enums for folder, action, period parameters.
• Write error recovery guidance into tool descriptions. E.g., 'If the call fails with 'insufficient_scope', verify the access token has instagram_manage_messages scope. Contact the account owner if needed.'
• Add 'WHEN to use' context to tool descriptions. Distinguish ig_get_media (fetch one post's details) from ig_get_media_list (fetch all posts). Explain prerequisites (e.g., 'Call ig_search_hashtag first to get hashtag_id before calling this tool').
• Implement a dry-run or confirmation workflow for destructive tools. Add an optional 'confirm' parameter (boolean) that when false returns 'Would delete X comment (ID: Y). Call again with confirm=true to proceed.' This prevents accidental LLM-induced deletions.
• Expand brief parameter descriptions. Replace 'Comment ID' with 'Comment ID (string, returned by ig_get_comments or ig_get_replies)'. Replace 'Message text' with 'Message text (string, 1-4096 characters, URLs will auto-preview)'.
• Add per-tool success/failure granularity to batch or bulk operations if added later. If a batch comment delete is added, return {deleted: [id], failed: [{id, reason}]} instead of all-or-nothing.