@codingmantra/mcp-server 0.1.3 → 0.2.0

package/build/index.js

@@ -3,35 +3,62 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 import { apiClient } from './api-client.js';
+import { formatImageToolResult, resolveImageInput, resolveImagesArray } from './image-utils.js';
 const server = new Server({
     name: "codingmantra-mcp",
-    version: "0.1.0",
+    version: "0.2.0",
 }, {
     capabilities: {
         tools: {},
     },
 });
+// ─── Reusable Parameter Definitions ──────────────────────────────────────────
+const IMAGE_SOURCE_SCHEMA = {
+    type: "object",
+    properties: {
+        url: { type: "string", description: "Public URL of the image." },
+        dataUrl: { type: "string", description: "Base64 data URI of the image." },
+        path: { type: "string", description: "Local file path on disk (will be automatically resolved to base64)." }
+    }
+};
+const COMMON_VIDEO_PROPERTIES = {
+    prompt: { type: "string", description: "Detailed video description or creative prompt." },
+    mainImage: { type: "string", description: "Base64 data URI, local file path, or public URL for the main subject image (Image-to-Video mode)." },
+    startImage: { type: "string", description: "Base64 data URI, local file path, or public URL for the first frame." },
+    endImage: { type: "string", description: "Base64 data URI, local file path, or public URL for the last frame." },
+    referenceImages: {
+        type: "array",
+        items: { type: "object", properties: { image: { type: "string" }, label: { type: "string" } } },
+        description: "Array of reference images for style matching."
+    },
+    negativePrompt: { type: "string", description: "Elements to exclude from the video." },
+    dialogue: { type: "string", description: "Optional voiceover or dialogue script." },
+    soundSuggestion: { type: "string", description: "Background music or sound effects direction." },
+    cameraMotion: { type: "string", description: "Camera motion instructions (e.g., 'orbit right', 'slow push-in')." },
+    ambientNoise: { type: "string", description: "Ambient sound description." },
+    language: { type: "string", description: "Voiceover language." },
+    timeDuration: { type: "string", description: "Video duration in seconds. Default is '4'." },
+    resolution: { type: "string", description: "Resolution (e.g., '720p', '1080p'). Default is '720p'." },
+    model: { type: "string", description: "Model slug (e.g., 'google/veo-3.1-fast', 'openrouter/wan-2.7')." },
+    aspectRatio: { type: "string", description: "Aspect ratio (e.g., '9:16', '16:9'). Default is '9:16'." },
+    generateAudio: { type: "boolean", description: "Whether to generate synchronized audio. Default is false." }
+};
 // ─── Tool Definitions ──────────────────────────────────────────────────────────
+// 1. Product Photography
 const GENERATE_PRODUCT_PHOTO_TOOL = {
     name: "generate_product_photo",
-    description: "Generates an AI product photography image with a specific scene prompt. Automatically deducts credits from your CodingMantra account. Returns the generated image directly (synchronous).",
+    description: "Generates studio-grade commercial product photography with customizable background scenes, ambient occlusion contact shadows, camera optics, resolutions (1K, 2K, 4K), aspect ratios, and dynamic logo/text overlays. Returns the image directly for inline display (synchronous).",
     inputSchema: {
         type: "object",
         properties: {
             productImages: {
                 type: "array",
-                items: {
-                    type: "object",
-                    properties: {
-                        url: { type: "string", description: "Public URL of the product image." },
-                        dataUrl: { type: "string", description: "Base64 data URI of the product image." }
-                    }
-                },
-                description: "Array of product images. Each must have either a 'url' or 'dataUrl'. At least one required."
+                items: IMAGE_SOURCE_SCHEMA,
+                description: "Array of product images. Each item can have 'url', 'dataUrl', or local 'path'. At least one required."
             },
             scenePrompt: {
                 type: "string",
-                description: "A detailed description of the background scene and setting for the product photo."
+                description: "A detailed description of the background scene, surface, and environment for the product photo."
             },
             model: {
                 type: "string",
@@ -39,23 +66,23 @@ const GENERATE_PRODUCT_PHOTO_TOOL = {
             },
             resolution: {
                 type: "string",
-                description: "Output resolution (e.g., '1K', '2K', '4K'). Default is '1K'.",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'.",
             },
             aspectRatio: {
                 type: "string",
-                description: "Output aspect ratio (e.g., '1:1', '16:9', '9:16'). Default is '1:1'.",
+                description: "Output aspect ratio ('1:1', '16:9', '9:16', '4:5'). Default is '1:1'.",
             },
             referenceImage: {
                 type: "string",
-                description: "An optional URL or data URI of a reference image to guide style."
+                description: "Optional URL, data URI, or local file path of a style reference image."
             },
             promptId: {
                 type: "string",
-                description: "Optional ID of a pre-defined prompt template."
+                description: "Optional ID of a pre-defined background template."
             },
             logoImage: {
                 type: "string",
-                description: "Optional URL or Base64 data URI of a logo to place on the image."
+                description: "Optional URL, data URI, or local file path of a brand logo to place on the image."
             },
             logoPlacement: {
                 type: "string",
@@ -63,7 +90,7 @@ const GENERATE_PRODUCT_PHOTO_TOOL = {
             },
             logoSize: {
                 type: "number",
-                description: "Scale of the logo overlay (0.1 to 1.0)."
+                description: "Scale of the logo overlay (0.05 to 0.5). Default is 0.15."
             },
             overlayText: {
                 type: "string",
@@ -71,15 +98,16 @@ const GENERATE_PRODUCT_PHOTO_TOOL = {
             },
             marketingText: {
                 type: "string",
-                description: "Optional marketing text to overlay."
+                description: "Optional marketing text or slogan to overlay."
             }
         },
         required: ["productImages", "scenePrompt"]
     }
 };
+// 2. Logo Creator
 const GENERATE_LOGO_TOOL = {
     name: "generate_logo",
-    description: "Generates an AI brand logo. Requires a company name and style description. Automatically deducts credits from your CodingMantra account. Returns the generated logo directly (synchronous).",
+    description: "Generates bespoke vector-style or 3D brand logos with customizable typography, colors, industries, and reference images. Returns the generated logo directly for inline display (synchronous).",
     inputSchema: {
         type: "object",
         properties: {
@@ -89,7 +117,7 @@ const GENERATE_LOGO_TOOL = {
             },
             stylePrompt: {
                 type: "string",
-                description: "A detailed style description for the logo (e.g., 'minimalist flat vector logo, dark blue and gold color scheme, modern tech feel')."
+                description: "A detailed style description for the logo (e.g., 'minimalist flat vector logo, navy blue and gold, clean tech aesthetic')."
             },
             subtitle: {
                 type: "string",
@@ -97,15 +125,15 @@ const GENERATE_LOGO_TOOL = {
             },
             industry: {
                 type: "string",
-                description: "The industry the company operates in (e.g., 'Technology', 'Food & Beverage')."
+                description: "The industry the company operates in (e.g., 'Technology', 'Luxury Jewelry', 'Fashion')."
             },
             ideas: {
                 type: "string",
-                description: "User-provided ideas, keywords, or concepts for the logo."
+                description: "Core keywords, symbols, or concepts for the logo."
             },
             colors: {
                 type: "string",
-                description: "Preferred color palette description (e.g., 'blue and silver', '#FF5733 and white')."
+                description: "Preferred color palette description (e.g., 'emerald green and brushed gold')."
             },
             aspectRatio: {
                 type: "string",
@@ -113,27 +141,331 @@ const GENERATE_LOGO_TOOL = {
             },
             modelId: {
                 type: "string",
-                description: "The image model ID. Default uses the platform default.",
+                description: "The image model ID. Default uses platform default.",
             },
             resolution: {
                 type: "string",
-                description: "Output resolution (e.g., '1K', '2K'). Default is '1K'.",
+                description: "Output resolution ('1K', '2K'). Default is '1K'.",
             },
-            promptId: {
+            referenceImage: {
+                type: "string",
+                description: "Optional style reference image URL, data URI, or local file path."
+            }
+        },
+        required: ["companyName", "stylePrompt"]
+    }
+};
+// 3. Jewelry Try-On
+const TRY_ON_JEWELRY_TOOL = {
+    name: "try_on_jewelry",
+    description: "Luxury jewelry virtual try-on. Places necklaces, rings, earrings, and bracelets naturally on human models with prongs/gemstone preservation, authentic optical dispersion, and anatomical contact shadows. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            jewelryImages: {
+                type: "array",
+                items: IMAGE_SOURCE_SCHEMA,
+                description: "Array of jewelry product images. Each can have 'url', 'dataUrl', or local 'path'. At least one required."
+            },
+            personImage: {
+                type: "string",
+                description: "Optional photo of a person to model the jewelry (URL, data URI, or local file path). If omitted, an elegant editorial model is generated."
+            },
+            prompt: {
+                type: "string",
+                description: "Creative styling directions (e.g., 'wearing black velvet evening gown, soft studio rim lighting, Parisian luxury ambiance')."
+            },
+            sizeMeasurement: {
+                type: "string",
+                description: "Physical dimensions (e.g., '2 cm pendant', 'ring size 7') to maintain accurate scale."
+            },
+            aspectRatio: {
                 type: "string",
-                description: "Optional ID or value of a pre-defined style template."
+                description: "Output aspect ratio ('1:1', '9:16', '16:9'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            model: {
+                type: "string",
+                description: "Model tier slug ('standard', 'pro', 'flash'). Default is 'pro'."
             },
             referenceImage: {
                 type: "string",
-                description: "An optional general style reference image URL or data URI."
+                description: "Optional campaign reference image (URL, data URI, or local path) to copy lighting and mood from."
+            },
+            logoImage: {
+                type: "string",
+                description: "Optional brand logo overlay."
+            },
+            logoPlacement: {
+                type: "string",
+                description: "Logo placement ('top-left', 'bottom-right', etc.)."
+            },
+            overlayText: {
+                type: "string",
+                description: "Optional text to overlay on the image."
+            },
+            marketingText: {
+                type: "string",
+                description: "Optional marketing text or slogan."
             }
         },
-        required: ["companyName", "stylePrompt"]
+        required: ["jewelryImages"]
+    }
+};
+// 4. Apparel Try-On
+const TRY_ON_APPAREL_TOOL = {
+    name: "try_on_apparel",
+    description: "Virtual fashion apparel try-on. Drapes garments realistically along model anatomy with natural gravitational folds, realistic tension, Hasselblad medium-format camera optics, and ground contact shadows. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            apparelImages: {
+                type: "array",
+                items: IMAGE_SOURCE_SCHEMA,
+                description: "Array of clothing/apparel images. Each can have 'url', 'dataUrl', or local 'path'. At least one required."
+            },
+            modelImage: {
+                type: "string",
+                description: "Optional photo of a person/model (URL, data URI, or local path). If omitted, a professional fashion model is generated."
+            },
+            prompt: {
+                type: "string",
+                description: "Styling and scene creative direction (e.g., 'standing on Milan street, golden hour sunlight, editorial fashion magazine style')."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '9:16', '16:9', '4:5'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional style reference image URL, data URI, or local path."
+            },
+            logoImage: {
+                type: "string",
+                description: "Optional brand logo overlay."
+            },
+            overlayText: {
+                type: "string",
+                description: "Optional text overlay."
+            },
+            marketingText: {
+                type: "string",
+                description: "Optional marketing copy."
+            }
+        },
+        required: ["apparelImages"]
+    }
+};
+// 5. Product Try-On
+const TRY_ON_PRODUCT_TOOL = {
+    name: "try_on_product",
+    description: "Universal commercial product staging and try-on across footwear, accessories, watches, eyewear, cosmetics, and furniture with 3-point studio lighting and ambient occlusion contact shadows. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            productImages: {
+                type: "array",
+                items: IMAGE_SOURCE_SCHEMA,
+                description: "Array of product images. At least one required."
+            },
+            mainImage: {
+                type: "string",
+                description: "Optional base image (model portrait, empty room, or tabletop) to place the product into."
+            },
+            prompt: {
+                type: "string",
+                description: "Creative styling and environment directions."
+            },
+            sizeMeasurement: {
+                type: "string",
+                description: "Physical dimensions (e.g., '10 inches', '30 cm') to maintain exact scale."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '16:9', '9:16'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional style reference image."
+            },
+            logoImage: {
+                type: "string",
+                description: "Optional brand logo overlay."
+            },
+            overlayText: {
+                type: "string",
+                description: "Optional text overlay."
+            }
+        },
+        required: ["productImages"]
+    }
+};
+// 6. Festival Post Generator
+const GENERATE_FESTIVAL_POST_TOOL = {
+    name: "generate_festival_post",
+    description: "Generates high-conversion festival marketing graphics, holiday greetings (Diwali, Eid, Christmas, New Year, Valentine's), and promotional event banners with product and brand logo integration. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            festivalPrompt: {
+                type: "string",
+                description: "Festival theme or campaign message (e.g., 'Diwali luxury jewelry promotion with warm golden diyas and floral rangoli')."
+            },
+            productImage: {
+                type: "string",
+                description: "Optional hero product image (URL, data URI, or local file path) to place centrally in the festive composition."
+            },
+            logoImage: {
+                type: "string",
+                description: "Optional brand logo image."
+            },
+            overlayText: {
+                type: "string",
+                description: "Main headline or festive greeting text (e.g., 'Happy Diwali - 20% Off')."
+            },
+            marketingText: {
+                type: "string",
+                description: "Supporting promotional message or contact details."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '9:16', '16:9'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K'). Default is '1K'."
+            }
+        },
+        required: ["festivalPrompt"]
+    }
+};
+// 7. YouTube Thumbnail Generator
+const GENERATE_YOUTUBE_THUMBNAIL_TOOL = {
+    name: "generate_youtube_thumbnail",
+    description: "Generates high-CTR YouTube thumbnails with rule-of-thirds composition, emotional human expressions, vibrant contrast separation, and legible bold text overlays. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            prompt: {
+                type: "string",
+                description: "Core video concept or thumbnail description (e.g., 'Shocked tech reviewer holding futuristic glowing AI smartphone, neon studio background')."
+            },
+            overlayText: {
+                type: "string",
+                description: "Short, punchy thumbnail headline text (e.g., 'DON\\'T BUY THIS!')."
+            },
+            personImage: {
+                type: "string",
+                description: "Optional photo of the YouTube creator/subject (URL, data URI, or local path) to feature prominently."
+            },
+            backgroundImage: {
+                type: "string",
+                description: "Optional custom background image."
+            },
+            logoImage: {
+                type: "string",
+                description: "Optional channel/brand logo to place in corner."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Thumbnail aspect ratio. Default is '16:9'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K'). Default is '1K'."
+            }
+        },
+        required: ["prompt"]
+    }
+};
+// 8. Passport Photo Creator
+const GENERATE_PASSPORT_PHOTO_TOOL = {
+    name: "generate_passport_photo",
+    description: "Converts any portrait into an official, compliant passport or visa identity photo with pixel-level facial identity preservation, neutral lighting, and plain white/off-white background. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            photoDataUri: {
+                type: "string",
+                description: "Source portrait photo (URL, data URI, or local file path)."
+            },
+            prompt: {
+                type: "string",
+                description: "Adjustments (e.g., 'white background, formal dark navy business suit, centered frontal view')."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Passport aspect ratio ('1:1', '4:5'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K'). Default is '1K'."
+            }
+        },
+        required: ["photoDataUri"]
+    }
+};
+// 9. Sketch to Real
+const SKETCH_TO_REAL_TOOL = {
+    name: "sketch_to_real",
+    description: "Transforms hand-drawn sketches, line drawings, or product drafts into photorealistic commercial images while strictly preserving the sketched silhouette, proportions, and outlines. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sketchImage: {
+                type: "string",
+                description: "The source sketch/drawing image (URL, data URI, or local file path)."
+            },
+            prompt: {
+                type: "string",
+                description: "Description of materials, textures, colors, and lighting (e.g., 'matte black carbon fiber body, polished titanium accents, studio lighting')."
+            },
+            style: {
+                type: "string",
+                description: "Target render style ('Photorealistic', 'Cinematic', '3D Render'). Default is 'Photorealistic'."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '16:9', '9:16'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            }
+        },
+        required: ["sketchImage"]
+    }
+};
+// 10. Upscale Image
+const UPSCALE_IMAGE_TOOL = {
+    name: "upscale_image",
+    description: "Upscales and enhances any image with AI detail recovery, removing compression artifacts and increasing resolution. Returns upscaled image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            imageDataUri: {
+                type: "string",
+                description: "The image to upscale (URL, data URI, or local file path)."
+            }
+        },
+        required: ["imageDataUri"]
     }
 };
+// 11. QR Code Generator (Full-featured)
 const GENERATE_QR_CODE_TOOL = {
     name: "generate_qr_code",
-    description: "Generates a QR code for a given text, URL, WiFi, email, vCard, or UPI payment. Returns a base64 encoded image data URI. Supports customization of colors, size, error correction level, and optional logo overlay.",
+    description: "Generates custom QR codes for URLs, plain text, Wi-Fi credentials, vCards, emails, and UPI payment strings with customizable colors, sizing, and error correction. Returns QR image directly (synchronous).",
     inputSchema: {
         type: "object",
         properties: {
@@ -144,7 +476,7 @@ const GENERATE_QR_CODE_TOOL = {
             },
             value: {
                 type: "string",
-                description: "The text or URL to encode (required for 'url' and 'text' types)."
+                description: "The text, URL, or data payload to encode."
             },
             size: {
                 type: "number",
@@ -167,9 +499,10 @@ const GENERATE_QR_CODE_TOOL = {
         required: ["type", "value"]
     }
 };
+// 12. QR Code Simple
 const GENERATE_QR_CODE_SIMPLE_TOOL = {
     name: "generate_qr_code_simple",
-    description: "Quick QR code generation from plain text or URL. Uses a simple GET-based endpoint. Returns a base64 encoded QR code image.",
+    description: "Quick single-parameter QR code generation from plain text or URL. Returns QR image directly (synchronous).",
     inputSchema: {
         type: "object",
         properties: {
@@ -181,60 +514,62 @@ const GENERATE_QR_CODE_SIMPLE_TOOL = {
         required: ["text"]
     }
 };
-const COMMON_VIDEO_PROPERTIES = {
-    prompt: { type: "string", description: "Detailed video description or prompt." },
-    mainImage: { type: "string", description: "Base64 data URI or URL for the main image (Image-to-Video mode)." },
-    startImage: { type: "string", description: "Base64 data URI or URL for the first frame." },
-    endImage: { type: "string", description: "Base64 data URI or URL for the last frame." },
-    referenceImages: {
-        type: "array",
-        items: { type: "object", properties: { image: { type: "string" }, label: { type: "string" } } },
-        description: "Array of reference images for style matching."
-    },
-    negativePrompt: { type: "string", description: "Elements to exclude from the video." },
-    dialogue: { type: "string", description: "Optional voiceover or dialogue." },
-    soundSuggestion: { type: "string", description: "Background music or sound effects." },
-    cameraMotion: { type: "string", description: "Camera motion instructions." },
-    ambientNoise: { type: "string", description: "Ambient sound description." },
-    language: { type: "string", description: "Voiceover language." },
-    timeDuration: { type: "string", description: "Video duration in seconds. Default is '4'." },
-    resolution: { type: "string", description: "Resolution (e.g., '720p', '1080p'). Default is '720p'." },
-    model: { type: "string", description: "Model slug (e.g., 'google/veo-3.1-fast', 'openrouter/wan-2.7')." },
-    aspectRatio: { type: "string", description: "Aspect ratio (e.g., '9:16', '16:9'). Default is '9:16'." },
-    generateAudio: { type: "boolean", description: "Whether to generate audio. Default is false." }
+// 13. Get User Credits
+const GET_USER_CREDITS_TOOL = {
+    name: "get_user_credits",
+    description: "Checks your current CodingMantra AI wallet credit balance. Useful before launching batches or large video/image tasks.",
+    inputSchema: {
+        type: "object",
+        properties: {}
+    }
+};
+// 14. List Image Models
+const LIST_IMAGE_MODELS_TOOL = {
+    name: "list_image_models",
+    description: "Lists all available CodingMantra AI image generation models (e.g., Gemini Flash, Gemini Pro, Flux Pro), including supported resolutions, aspect ratios, and credit costs.",
+    inputSchema: {
+        type: "object",
+        properties: {}
+    }
 };
+// 15. Product Video Generation (Async)
 const GENERATE_PRODUCT_VIDEO_TOOL = {
     name: "generate_product_video",
-    description: "Generates a product video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    description: "Generates commercial product videography. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion.",
     inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
 };
+// 16. Apparel Video Generation (Async)
 const GENERATE_APPAREL_VIDEO_TOOL = {
     name: "generate_apparel_video",
-    description: "Generates an apparel try-on video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    description: "Generates runway fashion and apparel motion showcase videos. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion.",
     inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
 };
+// 17. Festival Video Generation (Async)
 const GENERATE_FESTIVAL_VIDEO_TOOL = {
     name: "generate_festival_video",
-    description: "Generates a festival or event video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    description: "Generates celebratory festival greetings and motion graphics. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion.",
     inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
 };
+// 18. Jewelry Video Generation (Async)
 const GENERATE_JEWELRY_VIDEO_TOOL = {
     name: "generate_jewelry_video",
-    description: "Generates a jewelry showcase video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    description: "Generates luxury jewelry videography with optical brilliance and rotating display. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion.",
     inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
 };
+// 19. Logo Video Generation (Async)
 const GENERATE_LOGO_VIDEO_TOOL = {
     name: "generate_logo_video",
-    description: "Generates a logo animation video. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion. Automatically deducts credits.",
+    description: "Generates 3D logo reveal and motion graphic video intros. Asynchronous: returns a jobId. You MUST use check_video_job_status with the jobId to poll for completion.",
     inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
 };
+// 20. Check Video Job Status (Polling)
 const CHECK_JOB_STATUS_TOOL = {
     name: "check_video_job_status",
-    description: "Checks the status of an asynchronous video generation job. Call this repeatedly (e.g. every 10-30 seconds) until the job status is 'completed' or 'failed'.",
+    description: "Checks the real-time status of an asynchronous video generation job. Call this repeatedly (every 10-30 seconds) until the job status is 'completed' or 'failed'.",
     inputSchema: {
         type: "object",
         properties: {
-            jobId: { type: "string", description: "The ID of the job to check." }
+            jobId: { type: "string", description: "The ID of the video job to track." }
         },
         required: ["jobId"]
     }
@@ -245,8 +580,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         tools: [
             GENERATE_PRODUCT_PHOTO_TOOL,
             GENERATE_LOGO_TOOL,
+            TRY_ON_JEWELRY_TOOL,
+            TRY_ON_APPAREL_TOOL,
+            TRY_ON_PRODUCT_TOOL,
+            GENERATE_FESTIVAL_POST_TOOL,
+            GENERATE_YOUTUBE_THUMBNAIL_TOOL,
+            GENERATE_PASSPORT_PHOTO_TOOL,
+            SKETCH_TO_REAL_TOOL,
+            UPSCALE_IMAGE_TOOL,
             GENERATE_QR_CODE_TOOL,
             GENERATE_QR_CODE_SIMPLE_TOOL,
+            GET_USER_CREDITS_TOOL,
+            LIST_IMAGE_MODELS_TOOL,
             GENERATE_PRODUCT_VIDEO_TOOL,
             GENERATE_APPAREL_VIDEO_TOOL,
             GENERATE_FESTIVAL_VIDEO_TOOL,
@@ -259,86 +604,195 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 // ─── Tool Execution ─────────────────────────────────────────────────────────────
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
-        const { name, arguments: args } = request.params;
-        // ── Product Photography (synchronous) ────────────────────────────────────
+        const { name, arguments: rawArgs } = request.params;
+        const args = rawArgs || {};
+        // ── 1. Product Photography (synchronous) ──────────────────────────────────
         if (name === 'generate_product_photo') {
+            const payload = {
+                ...args,
+                productImages: resolveImagesArray(args.productImages),
+                referenceImage: resolveImageInput(args.referenceImage),
+                logoImage: resolveImageInput(args.logoImage),
+            };
             const response = await apiClient('/image/product-photography', {
                 method: 'POST',
-                body: JSON.stringify(args),
+                body: JSON.stringify(payload),
             });
-            const result = response.data;
-            let text = '✅ Product photo generated successfully!\n\n';
-            if (result?.imageUrl) {
-                text += `Image URL: ${result.imageUrl}`;
-            }
-            else if (result?.photoDataUri) {
-                text += `Image data returned (base64). Length: ${String(result.photoDataUri).length} characters.\nData URI: ${String(result.photoDataUri).substring(0, 100)}...`;
-            }
-            else if (result?.output) {
-                text += `Image data returned (base64). Length: ${String(result.output).length} characters.`;
-            }
-            else {
-                text += `Result: ${JSON.stringify(result).substring(0, 500)}`;
-            }
-            return { content: [{ type: "text", text }] };
+            return formatImageToolResult(response, 'Product Photo Generated');
         }
-        // ── Logo Creator (synchronous) ───────────────────────────────────────────
+        // ── 2. Logo Creator (synchronous) ─────────────────────────────────────────
         if (name === 'generate_logo') {
+            const payload = {
+                ...args,
+                referenceImage: resolveImageInput(args.referenceImage),
+            };
             const response = await apiClient('/image/logo-creator', {
                 method: 'POST',
-                body: JSON.stringify(args),
+                body: JSON.stringify(payload),
             });
-            const result = response.data;
-            let text = '✅ Logo generated successfully!\n\n';
-            if (result?.imageUrl) {
-                text += `Image URL: ${result.imageUrl}`;
-            }
-            else if (result?.photoDataUri) {
-                text += `Image data returned (base64). Length: ${String(result.photoDataUri).length} characters.\nData URI: ${String(result.photoDataUri).substring(0, 100)}...`;
-            }
-            else if (result?.output) {
-                text += `Image data returned (base64). Length: ${String(result.output).length} characters.`;
-            }
-            else {
-                text += `Result: ${JSON.stringify(result).substring(0, 500)}`;
-            }
-            return { content: [{ type: "text", text }] };
+            return formatImageToolResult(response, 'Brand Logo Generated');
+        }
+        // ── 3. Jewelry Try-On (synchronous) ───────────────────────────────────────
+        if (name === 'try_on_jewelry') {
+            const payload = {
+                ...args,
+                jewelryImages: resolveImagesArray(args.jewelryImages),
+                personImage: resolveImageInput(args.personImage),
+                referenceImage: resolveImageInput(args.referenceImage),
+                logoImage: resolveImageInput(args.logoImage),
+            };
+            const response = await apiClient('/image/jewelry-try-on', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Jewelry Try-On Image Generated');
+        }
+        // ── 4. Apparel Try-On (synchronous) ───────────────────────────────────────
+        if (name === 'try_on_apparel') {
+            const payload = {
+                ...args,
+                apparelImages: resolveImagesArray(args.apparelImages),
+                modelImage: resolveImageInput(args.modelImage),
+                referenceImage: resolveImageInput(args.referenceImage),
+                logoImage: resolveImageInput(args.logoImage),
+            };
+            const response = await apiClient('/image/apparel-try-on', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Apparel Try-On Image Generated');
+        }
+        // ── 5. Product Try-On (synchronous) ───────────────────────────────────────
+        if (name === 'try_on_product') {
+            const payload = {
+                ...args,
+                productImages: resolveImagesArray(args.productImages),
+                mainImage: resolveImageInput(args.mainImage),
+                referenceImage: resolveImageInput(args.referenceImage),
+                logoImage: resolveImageInput(args.logoImage),
+            };
+            const response = await apiClient('/image/product-try-on', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Product Try-On Image Generated');
+        }
+        // ── 6. Festival Post (synchronous) ────────────────────────────────────────
+        if (name === 'generate_festival_post') {
+            const payload = {
+                ...args,
+                productImage: resolveImageInput(args.productImage),
+                logoImage: resolveImageInput(args.logoImage),
+            };
+            const response = await apiClient('/image/festival-post-generator', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Festival Post Generated');
+        }
+        // ── 7. YouTube Thumbnail (synchronous) ────────────────────────────────────
+        if (name === 'generate_youtube_thumbnail') {
+            const payload = {
+                ...args,
+                personImage: resolveImageInput(args.personImage),
+                backgroundImage: resolveImageInput(args.backgroundImage),
+                logoImage: resolveImageInput(args.logoImage),
+            };
+            const response = await apiClient('/image/youtube-thumbnail-generator', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'YouTube Thumbnail Generated');
+        }
+        // ── 8. Passport Photo (synchronous) ───────────────────────────────────────
+        if (name === 'generate_passport_photo') {
+            const payload = {
+                ...args,
+                photoDataUri: resolveImageInput(args.photoDataUri),
+            };
+            const response = await apiClient('/image/passport-photo', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Passport Photo Generated');
+        }
+        // ── 9. Sketch to Real (synchronous) ───────────────────────────────────────
+        if (name === 'sketch_to_real') {
+            const payload = {
+                ...args,
+                sketchImage: resolveImageInput(args.sketchImage),
+                referenceImage: resolveImageInput(args.referenceImage),
+                logoImage: resolveImageInput(args.logoImage),
+            };
+            const response = await apiClient('/image/sketch-to-real', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Sketch-to-Real Image Generated');
+        }
+        // ── 10. Upscale Image (synchronous) ───────────────────────────────────────
+        if (name === 'upscale_image') {
+            const payload = {
+                ...args,
+                imageDataUri: resolveImageInput(args.imageDataUri),
+            };
+            const response = await apiClient('/image/upscale-image', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Image Upscaled Successfully');
         }
-        // ── QR Code (POST, full-featured) ────────────────────────────────────────
+        // ── 11. QR Code (POST, full-featured) ─────────────────────────────────────
         if (name === 'generate_qr_code') {
             const response = await apiClient('/qr-code/generate', {
                 method: 'POST',
                 body: JSON.stringify(args),
             });
-            const qrDataUrl = response.data?.qrCodeDataUrl;
-            if (qrDataUrl) {
-                return {
-                    content: [{ type: "text", text: `✅ QR Code generated successfully!\n\nData URI: ${qrDataUrl}` }],
-                };
-            }
-            return {
-                content: [{ type: "text", text: `✅ QR Code generated. Result: ${JSON.stringify(response.data).substring(0, 500)}` }],
-            };
+            return formatImageToolResult(response, 'QR Code Generated');
         }
-        // ── QR Code Simple (GET, path-based — legacy/backward compatible) ────────
+        // ── 12. QR Code Simple (GET, legacy) ──────────────────────────────────────
         if (name === 'generate_qr_code_simple') {
             const { text } = args;
             const encodedText = encodeURIComponent(text);
-            const apiKey = process.env.CODINGMANTRA_API_KEY;
+            const apiKey = process.env.CODINGMANTRA_API_KEY || '';
             const response = await apiClient(`/qr-code/generate-base64/${apiKey}/${encodedText}`, {
                 method: 'GET',
             });
-            const qrDataUrl = response.data?.qrCodeDataUrl;
-            if (qrDataUrl) {
-                return {
-                    content: [{ type: "text", text: `✅ QR Code generated successfully!\n\nData URI: ${qrDataUrl}` }],
-                };
+            return formatImageToolResult(response, 'QR Code Generated');
+        }
+        // ── 13. Get User Credits ──────────────────────────────────────────────────
+        if (name === 'get_user_credits') {
+            const response = await apiClient('/user/credits', {
+                method: 'GET',
+            });
+            const credits = response.data?.credits ?? 0;
+            return {
+                content: [{
+                        type: "text",
+                        text: `💳 **CodingMantra Wallet Balance**\n\n- Available Credits: **${credits}**\n- Need more credits? Top up at [CodingMantra Pricing](https://codingmantra.com/pricing)\n- View full usage history in your [Account Dashboard](https://codingmantra.com/dashboard)`
+                    }]
+            };
+        }
+        // ── 14. List Image Models ─────────────────────────────────────────────────
+        if (name === 'list_image_models') {
+            const response = await apiClient('/image/image-model-options', {
+                method: 'GET',
+            });
+            const models = response.data || [];
+            let text = `🤖 **Available CodingMantra Image Models**\n\n`;
+            for (const m of models) {
+                text += `#### ${m.name} (\`${m.model}\`)\n`;
+                text += `- **Provider:** ${m.provider}\n`;
+                text += `- **Description:** ${m.description || 'High-performance generative model'}\n`;
+                text += `- **Supported Resolutions:** ${m.supportedResolutions?.join(', ') || '1K'}\n`;
+                text += `- **Supported Aspect Ratios:** ${m.supportedAspectRatios?.join(', ') || '1:1'}\n`;
+                text += `- **Credit Cost:** ${m.estimatedCost?.credits ?? 10} credits\n\n`;
             }
             return {
-                content: [{ type: "text", text: `✅ QR Code generated. Result: ${JSON.stringify(response.data).substring(0, 500)}` }],
+                content: [{ type: "text", text: text.trim() }]
             };
         }
-        // ── Video Generation (Asynchronous) ──────────────────────────────────────
+        // ── 15-19. Video Generation (Asynchronous) ────────────────────────────────
         const videoEndpoints = {
             generate_product_video: '/product-video-generation',
             generate_apparel_video: '/apparel-video-generation',
@@ -347,22 +801,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             generate_logo_video: '/logo-video-generation'
         };
         if (videoEndpoints[name]) {
+            const payload = {
+                ...args,
+                mainImage: resolveImageInput(args.mainImage),
+                startImage: resolveImageInput(args.startImage),
+                endImage: resolveImageInput(args.endImage),
+            };
             const response = await apiClient(videoEndpoints[name], {
                 method: 'POST',
-                body: JSON.stringify(args),
+                body: JSON.stringify(payload),
             });
             const result = response.data || response;
             if (result?.jobId) {
                 return {
                     content: [{
                             type: "text",
-                            text: `✅ Job created successfully!\nJob ID: ${result.jobId}\nMessage: ${result.message}\n\nPlease use the check_video_job_status tool with this Job ID to poll for the result. Wait about 10-30 seconds between polls. Video generation can take several minutes.`
+                            text: `🎬 **Video Generation Job Queued Successfully!**\n\n- **Job ID:** \`${result.jobId}\`\n- **Status:** Queued\n- **Message:** ${result.message || 'Video job dispatched to rendering pipeline.'}\n\n👉 **Next Step:** Call the \`check_video_job_status\` tool with \`jobId: "${result.jobId}"\` every 15-30 seconds until completed. Rendering typically takes 1-3 minutes.`
                         }]
                 };
             }
             return { content: [{ type: "text", text: `Job started. Result: ${JSON.stringify(result).substring(0, 500)}` }] };
         }
-        // ── Check Job Status ─────────────────────────────────────────────────────
+        // ── 20. Check Video Job Status ────────────────────────────────────────────
         if (name === 'check_video_job_status') {
             const { jobId } = args;
             const response = await apiClient(`/jobs/status?jobId=${encodeURIComponent(jobId)}`, {
@@ -371,15 +831,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const result = response.data || response;
             if (result?.job) {
                 const job = result.job;
-                let text = `Job Status: ${job.status}\nProgress: ${job.progress}%\nStage: ${job.stage || 'N/A'}`;
+                let text = `### 🎬 Video Job Status: **${job.status.toUpperCase()}**\n\n`;
+                text += `- **Progress:** ${job.progress}%\n`;
+                text += `- **Stage:** ${job.stage || 'Processing'}\n`;
                 if (job.status === 'completed' && job.result?.videoUrl) {
-                    text += `\n\n✅ Video generated successfully!\nVideo URL: ${job.result.videoUrl}`;
+                    text += `\n✅ **Video Ready:** [Watch / Download Video](${job.result.videoUrl})\n`;
+                    text += `\n📁 **Gallery:** View in your [CodingMantra Gallery](https://codingmantra.com/my-gallery)`;
                 }
                 else if (job.status === 'failed') {
-                    text += `\n\n❌ Job failed: ${job.error || 'Unknown error'}`;
+                    text += `\n❌ **Job Failed:** ${job.error || 'Unknown error occurred during generation.'}\n`;
+                    text += `Your credits have been refunded automatically.`;
                 }
                 else {
-                    text += `\n\nJob is still running. Please check back again shortly.`;
+                    text += `\n⏳ **Job is actively rendering.** Please poll again in 15-20 seconds.`;
                 }
                 return { content: [{ type: "text", text }] };
             }
@@ -389,7 +853,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
     catch (error) {
         return {
-            content: [{ type: "text", text: `❌ Error: ${error.message}` }],
+            content: [{ type: "text", text: `❌ **Error:** ${error.message || error}` }],
             isError: true,
         };
     }
@@ -398,9 +862,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function run() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("CodingMantra MCP Server running on stdio");
+    console.error("[CodingMantra MCP] Server v0.2.0 initialized and running on stdio (20 tools active)");
 }
 run().catch((error) => {
-    console.error("Fatal error running server:", error);
+    console.error("Fatal error running CodingMantra MCP server:", error);
     process.exit(1);
 });