civitai-mcp has severe definition quality issues. The primary tool, civitai_models_tool, is a problematic 'portmanteau' combining 8+ distinct operations (search, get, download, pin_comfyops, outbox_enqueue, outbox_approve, outbox_publish, list_local) into a single tool with an overloaded 'operation' string parameter. This violates the single-responsibility principle and forces LLMs to guess which operation to invoke. Parameter descriptions are present but generic. The three helper tools (civitai_help, civitai_shutdown, show_depot_card) are minimal stubs. No output schemas are documented. Error handling is absent from visible code.

• Split civitai_models_tool into separate tools: search_civitai_models, get_civitai_model, download_civitai_model, enqueue_outbox, approve_outbox, publish_outbox, list_local_models. Each tool should have one clear verb and responsibility.
• Add enum constraint to 'operation' parameter (if portmanteau pattern is retained): operation: {type: 'string', enum: ['search', 'get', 'download', 'pin_comfyops', 'outbox_enqueue', 'outbox_approve', 'outbox_publish', 'list_local']}.
• Document output schema for civitai_models_tool. Specify returned fields: model_id, version_id, name, description, download_url, file_size, base_model, creator, tags. Include pagination fields (cursor, total_count) if applicable.
• Add error handling guidance: 'If model not found, try search_civitai_models() with partial name. If download fails, check CIVITAI_DEPOT_DIR permissions and disk space.'
• Implement confirmation step for civitai_shutdown: add a 'confirm' boolean parameter (default false) or require explicit confirmation message. Prevent accidental invocation.