@codingmantra/mcp-server 0.1.4 → 0.2.2

package/build/index.js

@@ -3,35 +3,74 @@ 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.2",
 }, {
     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", minLength: 10, maxLength: 5000, description: "Required video description or creative prompt (10-5000 characters)." },
+    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",
+        maxItems: 4,
+        items: { type: "object", properties: { image: { type: "string", description: "Public image URL, data URI, or local file path." }, label: { type: "string", description: "Optional reference label." } }, required: ["image"] },
+        description: "Reference images for style matching. Choose only one image mode: main image, frames, or references. Veo supports up to 3 references and requires 8 seconds for references or an end frame."
+    },
+    negativePrompt: { type: "string", description: "Elements to exclude from the video." },
+    dialogue: { type: "string", maxLength: 200, description: "Optional voiceover or dialogue script (up to 200 characters)." },
+    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: "Required duration in seconds supported by the selected model. Veo supports 4, 6, or 8; use 8 for 1080p, references, or an end frame." },
+    resolution: { type: "string", description: "Required resolution supported by the selected model (480p, 720p, 768p, or 1080p)." },
+    model: { type: "string", description: "Model slug (e.g., 'google/veo-3.1-fast', 'alibaba/wan-3.0')." },
+    aspectRatio: { type: "string", description: "Required aspect ratio supported by the selected model (e.g., 9:16 or 16:9)." },
+    generateAudio: { type: "boolean", description: "Whether to generate synchronized audio. Default is false." },
+    seed: { type: "integer", minimum: 0, maximum: Number.MAX_SAFE_INTEGER, description: "Optional nonnegative random seed for models that support it." },
+    guidanceScale: { type: "number", description: "Optional guidance strength for models that support it." },
+    soundEffects: { type: "string", description: "Sound effects direction for Story Teller." },
+    styleAmbiance: { type: "string", description: "Visual style and atmosphere for Story Teller." },
+    characters: { type: "array", description: "Optional named characters for consistent storytelling.", items: {
+            type: "object", properties: {
+                id: { type: "string", description: "Unique character ID." },
+                name: { type: "string", description: "Character name." },
+                description: { type: "string", description: "Character appearance and role." }
+            }, required: ["id", "name", "description"]
+        } }
+};
 // ─── 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 +78,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 +102,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 +110,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 brand logos, monograms, emblems, and modern wordmarks with character-perfect typography, color palettes, and reference image guidance. Default model is Flash. Returns the generated logo directly for inline display (synchronous).",
     inputSchema: {
         type: "object",
         properties: {
@@ -89,7 +129,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,43 +137,646 @@ 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",
+                description: "Output aspect ratio ('1:1', '16:9', '4:3'). Default is '1:1'.",
+            },
+            model: {
+                type: "string",
+                description: "Model tier to use ('flash' or 'pro'). Default is 'flash' (google/gemini-3.1-flash-image)."
+            },
+            modelId: {
+                type: "string",
+                description: "Full image model ID if specific model desired (e.g. google/gemini-3.1-flash-image).",
+            },
+            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 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: "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 'flash'."
+            },
+            referenceImage: {
+                type: "string",
+                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: ["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, ambient occlusion contact shadows, and editorial lighting. Default model tier is Flash. 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 ('9:16', '1:1', '16:9', '4:5'). Default is '9:16'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            model: {
+                type: "string",
+                description: "The model tier ('flash', 'pro', 'standard'). Default is 'flash'."
+            },
+            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. Default model tier is Flash. 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'."
+            },
+            model: {
+                type: "string",
+                description: "The model tier ('flash', 'pro', 'standard'). Default is 'flash'."
+            },
+            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. Default model is Flash. 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."
+            },
+            model: {
+                type: "string",
+                description: "The model tier ('flash', 'pro', 'standard'). Default is 'flash' (Gemini 3.1 Flash)."
             },
             aspectRatio: {
                 type: "string",
-                description: "Output aspect ratio. Default is '1:1'.",
+                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. Human Builder / Virtual Model Generator
+const BUILD_HUMAN_TOOL = {
+    name: "build_human",
+    description: "Creates photorealistic AI human models tailored for brand photography, fashion, ecommerce, and marketing campaigns with complete demographic, facial, hair, and body customization, plus multi-view character sheets (2x2 grid). Default model tier is Flash. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "Optional name or character identifier for the model." },
+            age: { type: "string", description: "Age category or specific age (e.g., 'Young Adult', '25 years old', 'Middle-aged')." },
+            gender: { type: "string", description: "Gender identity (e.g., 'Female', 'Male', 'Non-binary')." },
+            culturalTraits: { type: "string", description: "Ethnicity or cultural heritage (e.g., 'South Asian', 'East Asian', 'Caucasian', 'African')." },
+            country: { type: "string", description: "Country of origin (e.g., 'India', 'Japan', 'France', 'Brazil')." },
+            skinTone: { type: "string", description: "Complexion and skin tone (e.g., 'Medium Warm', 'Fair Porcelain', 'Rich Deep Bronze')." },
+            eyeColor: { type: "string", description: "Eye color (e.g., 'Dark Brown', 'Hazel Green', 'Deep Blue')." },
+            eyeShape: { type: "string", description: "Eye shape (e.g., 'Almond', 'Round', 'Monolid', 'Hooded')." },
+            noseShape: { type: "string", description: "Nose shape (e.g., 'Natural Straight', 'Aquiline', 'Button', 'Broad')." },
+            faceShape: { type: "string", description: "Face shape (e.g., 'Oval', 'Square', 'Heart', 'Round')." },
+            hairStyle: { type: "string", description: "Hairstyle (e.g., 'Long Waves', 'Buzz Cut', 'Sleek Bob', 'Afro', 'Layered Cut')." },
+            hairColor: { type: "string", description: "Hair color (e.g., 'Natural Black', 'Chestnut Brown', 'Honey Blonde')." },
+            hairThickness: { type: "string", description: "Hair density (e.g., 'Thick', 'Medium', 'Fine')." },
+            hairType: { type: "string", description: "Hair texture (e.g., 'Straight', 'Wavy', 'Curly', 'Coily')." },
+            bodySize: { type: "string", description: "Body build (e.g., 'Petite', 'Slim Athletic', 'Medium', 'Curvy', 'Plus Size')." },
+            bodyHeight: { type: "string", description: "Height description (e.g., 'Petite', 'Average', 'Tall Fashion Model')." },
+            bodyShape: { type: "string", description: "Body shape (e.g., 'Hourglass', 'Athletic Rectangular', 'Pear', 'Inverted Triangle')." },
+            muscleDefinition: { type: "string", description: "Muscle definition (e.g., 'Soft Natural', 'Toned Athletic', 'Defined Muscular')." },
+            cupSize: { type: "string", description: "Bust proportion if female (e.g., 'Small', 'Medium', 'Full')." },
+            extraDescription: { type: "string", description: "Extra unique physical traits (e.g., 'light freckles across nose bridge, subtle smile')." },
+            customTweakPrompt: { type: "string", description: "Custom refinement or scene styling prompt (e.g., 'wearing an ivory cashmere turtleneck against a warm minimalist studio backdrop')." },
+            generateMultiView: { type: "boolean", description: "Generate a 4-panel consistent character sheet in a 2x2 grid (Front, Side, 3/4, Close-up detail). Default is false." },
+            referenceImages: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional array of reference face or body images (URLs, data URIs, or local file paths) to guide identity."
+            },
+            aspectRatio: { type: "string", description: "Output aspect ratio ('1:1', '9:16', '4:5', '16:9'). Default is '1:1'." },
+            resolution: { type: "string", description: "Output resolution ('1K', '2K', '4K'). Default is '1K'." },
+            model: { type: "string", description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash'." }
+        }
+    }
+};
+// 8. 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."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional style or concept reference image (URL, data URI, or local file path)."
+            },
+            promptId: {
+                type: "string",
+                description: "Optional ID or title of a pre-defined layout style template from youtubeThumbnailPrompts."
+            },
+            model: {
+                type: "string",
+                description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash' (google/gemini-3.1-flash-image)."
             },
             modelId: {
                 type: "string",
-                description: "The image model ID. Default uses the platform default.",
+                description: "The image model ID."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Thumbnail aspect ratio. Default is '16:9'."
             },
             resolution: {
                 type: "string",
-                description: "Output resolution (e.g., '1K', '2K'). Default is '1K'.",
+                description: "Output resolution ('1K', '2K', '4K'). 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. Default model tier is Flash. Default aspect ratio is '1:1'. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            photoDataUri: {
+                type: "string",
+                description: "Source portrait photo (URL, data URI, or local file path) to convert."
+            },
+            prompt: {
+                type: "string",
+                description: "Adjustments (e.g., 'white background, formal dark navy business suit, centered frontal view')."
             },
             promptId: {
                 type: "string",
-                description: "Optional ID or value of a pre-defined style template."
+                description: "Optional ID or title of a pre-defined style template from passportPhotoPrompts."
             },
             referenceImage: {
                 type: "string",
-                description: "An optional general style reference image URL or data URI."
+                description: "Optional style reference image (URL, data URI, or local file path) to guide attire or lighting."
+            },
+            model: {
+                type: "string",
+                description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash' (google/gemini-3.1-flash-image)."
+            },
+            modelId: {
+                type: "string",
+                description: "The image model ID."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Passport aspect ratio ('1:1', '4:5', '3:4'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
             }
         },
-        required: ["companyName", "stylePrompt"]
+        required: ["photoDataUri"]
+    }
+};
+// 10. 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. Default model tier is Flash. 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'."
+            },
+            model: {
+                type: "string",
+                description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash'."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional style/concept reference image (URL, data URI, or local file path)."
+            },
+            logoImage: {
+                type: "string",
+                description: "Optional brand logo overlay (URL, data URI, or local file path)."
+            },
+            overlayText: {
+                type: "string",
+                description: "Optional headline text overlay."
+            },
+            marketingText: {
+                type: "string",
+                description: "Optional marketing copy overlay."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '16:9', '9:16', '4:5'). Default is '1:1'."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            }
+        },
+        required: ["sketchImage"]
+    }
+};
+// 11. Professional Photography Editor
+const EDIT_PROFESSIONAL_PHOTO_TOOL = {
+    name: "edit_professional_photo",
+    description: "Transforms, grades, and enhances portraits and lifestyle photos into magazine-grade studio or commercial editorial photography. Enforces natural dermal micro-pores, authentic iris catchlights, directional studio lighting, and realistic depth of field. Default model tier is Flash. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            images: {
+                type: "array",
+                items: IMAGE_SOURCE_SCHEMA,
+                description: "Array of subject reference photos (URL, data URI, or local file path). Each item can have 'url', 'dataUrl', or local 'path'. At least one required."
+            },
+            prompt: {
+                type: "string",
+                description: "Enhancement instruction or desired photo transformation (e.g., 'warm dusk cinematic lighting, shallow depth of field, natural skin texture, magazine editorial portrait')."
+            },
+            image: {
+                type: "string",
+                description: "Convenience single subject photo (URL, data URI, or local file path) if only providing one image."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional style or concept reference image (URL, data URI, or local file path)."
+            },
+            promptId: {
+                type: "string",
+                description: "Optional ID or title of a pre-defined photography scene template."
+            },
+            model: {
+                type: "string",
+                description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash' (google/gemini-3.1-flash-image)."
+            },
+            modelId: {
+                type: "string",
+                description: "The image model ID."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '4:5', '9:16', '16:9'). Default is '1:1'."
+            }
+        },
+        required: ["prompt"]
+    }
+};
+// 12. Nano Banana Image Editor (AI)
+const EDIT_NANO_BANANA_TOOL = {
+    name: "edit_nano_banana",
+    description: "Creative multi-reference AI image editor and compositor. Generates, modifies, or restyles images from multiple reference photos and text instructions with multi-subject composition, perspective alignment, ground contact shadows, and versatile artistic styles (photorealistic, action figurine, chibi/Funko Pop, anime/Ghibli, 3D render). Default model tier is Flash. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            images: {
+                type: "array",
+                items: IMAGE_SOURCE_SCHEMA,
+                description: "Array of reference images (URL, data URI, or local file path). Each item can have 'url', 'dataUrl', or local 'path'. At least one required."
+            },
+            prompt: {
+                type: "string",
+                description: "The creative editing or generation prompt describing desired composition, style, or changes."
+            },
+            image: {
+                type: "string",
+                description: "Convenience single reference photo (URL, data URI, or local file path) if only providing one image."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional style or concept reference image (URL, data URI, or local file path)."
+            },
+            promptId: {
+                type: "string",
+                description: "Optional ID or title of a pre-defined style template (e.g., 'action-figure', 'funko-pop', 'studio-ghibli', '16bit-game-character')."
+            },
+            model: {
+                type: "string",
+                description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash' (google/gemini-3.1-flash-image)."
+            },
+            modelId: {
+                type: "string",
+                description: "The image model ID."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '4:5', '9:16', '16:9'). Default is '1:1'."
+            }
+        },
+        required: ["prompt"]
+    }
+};
+// 13. Blog Image Generator (AI)
+const GENERATE_BLOG_IMAGE_TOOL = {
+    name: "generate_blog_image",
+    description: "Generates high-impact, editorial blog hero images, article thumbnails, and banners with clean composition, visual hierarchy, intentional negative space, and exact text overlays. Default aspect ratio is 16:9. Default model tier is Flash. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            prompt: {
+                type: "string",
+                description: "Description of the desired blog hero image, article concept, or editorial illustration."
+            },
+            overlayText: {
+                type: "string",
+                description: "Optional short text, title, or headline to overlay legibly on the image."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional style or aesthetic reference image (URL, data URI, or local file path)."
+            },
+            promptId: {
+                type: "string",
+                description: "Optional ID or title of a pre-defined style template from blogImagePrompts (e.g., 'neon-cyber-circuit', 'balancing-stones')."
+            },
+            model: {
+                type: "string",
+                description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash' (google/gemini-3.1-flash-image)."
+            },
+            modelId: {
+                type: "string",
+                description: "The image model ID."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('16:9', '1:1', '4:3', '3:4', '9:16', '4:5'). Default is '16:9'."
+            }
+        },
+        required: ["prompt"]
+    }
+};
+// 14. Baby Milestone Generator
+const GENERATE_BABY_MILESTONE_TOOL = {
+    name: "generate_baby_milestone",
+    description: "Creates magical baby milestone keepsake portraits by isolating the baby and generating enchanting themed backgrounds with organic milestone text integration, while preserving the baby's exact face, expression, skin tone, clothing, and posture. Default model tier is Flash. Default aspect ratio is '1:1'. Returns generated image directly (synchronous).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            photoDataUri: {
+                type: "string",
+                description: "The baby photo (URL, data URI, or local file path) to isolate and preserve as the main subject."
+            },
+            milestoneValue: {
+                type: "number",
+                description: "Milestone number (e.g., 1, 3, 6, 12)."
+            },
+            milestoneUnit: {
+                type: "string",
+                enum: ["month", "year"],
+                description: "Unit for milestone ('month' or 'year')."
+            },
+            customPrompt: {
+                type: "string",
+                description: "Creative theme or environment instructions (e.g., 'Enchanted woodland forest with soft morning sunbeams and wildflowers')."
+            },
+            promptId: {
+                type: "string",
+                description: "Optional ID or title of a pre-defined style preset from babyMilestonePrompts."
+            },
+            referenceImage: {
+                type: "string",
+                description: "Optional environmental style reference image (URL, data URI, or local file path)."
+            },
+            model: {
+                type: "string",
+                description: "Model tier ('flash', 'pro', 'standard'). Default is 'flash' (google/gemini-3.1-flash-image)."
+            },
+            modelId: {
+                type: "string",
+                description: "The image model ID."
+            },
+            resolution: {
+                type: "string",
+                description: "Output resolution ('1K', '2K', '4K'). Default is '1K'."
+            },
+            aspectRatio: {
+                type: "string",
+                description: "Output aspect ratio ('1:1', '4:5', '3:4', '16:9', '9:16'). Default is '1:1'."
+            }
+        },
+        required: ["photoDataUri"]
+    }
+};
+// 13. Upscale Image
+const UPSCALE_IMAGE_TOOL = {
+    name: "upscale_image",
+    description: "Enhances a reference image with the Pro AI model at 4K. Preserves composition through instructions and validates larger dimensions and matching proportions. AI may alter fine details. Uses 60 credits; returns the upscaled image synchronously.",
+    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 +787,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 +810,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 +825,119 @@ 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, Grok Imagine 2.0, GPT Image 2.5 Flare), 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.",
-    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+    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, required: ["prompt", "model", "resolution", "aspectRatio", "timeDuration"] }
 };
+// 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.",
-    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+    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, required: ["prompt", "model", "resolution", "aspectRatio", "timeDuration"] }
 };
+// 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.",
-    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+    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, required: ["prompt", "model", "resolution", "aspectRatio", "timeDuration"] }
 };
+// 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.",
-    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+    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, required: ["prompt", "model", "resolution", "aspectRatio", "timeDuration"] }
 };
+// 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.",
-    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES }
+    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, required: ["prompt", "model", "resolution", "aspectRatio", "timeDuration"] }
+};
+const GENERATE_STORY_VIDEO_TOOL = {
+    name: "generate_story_video",
+    description: "Generates cinematic story videos with character descriptions, reference images, sound effects, and atmosphere. Asynchronous: returns a jobId; poll check_video_job_status until completed, failed, or cancelled.",
+    inputSchema: { type: "object", properties: COMMON_VIDEO_PROPERTIES, required: ["prompt", "model", "resolution", "aspectRatio", "timeDuration"] }
+};
+const GENERATE_TALKING_AVATAR_TOOL = {
+    name: "generate_talking_avatar",
+    description: "Animates a portrait with HeyGen Avatar IV lip sync from a script and HeyGen voice ID. Asynchronous: returns a jobId; poll check_video_job_status until completed, failed, or cancelled. Credits are calculated by the server from the script budget and resolution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            image: { type: "string", description: "PNG, JPEG, or WebP portrait as a base64 data URI or local file path. Public URLs are not accepted." },
+            speechMode: { type: "string", enum: ["text"], default: "text", description: "Speech source; currently only text is supported." },
+            script: { type: "string", minLength: 3, maxLength: 2000, description: "Spoken script. Must fit the selected duration budget and speech speed." },
+            voiceId: { type: "string", minLength: 1, maxLength: 150, pattern: "^[A-Za-z0-9_-]+$", description: "HeyGen voice ID for the narration." },
+            speed: { type: "number", minimum: 0.5, maximum: 1.5, default: 1, description: "Speech speed multiplier." },
+            targetDuration: { type: "integer", minimum: 5, maximum: 120, default: 15, description: "Maximum script duration budget in seconds." },
+            performancePreset: { type: "string", enum: ["natural", "professional", "energetic", "friendly", "presenter", "storyteller"], default: "professional", description: "Avatar performance style." },
+            expressiveness: { type: "string", enum: ["low", "medium", "high"], description: "Optional expression intensity override." },
+            motionPrompt: { type: "string", maxLength: 500, description: "Optional motion instructions overriding the preset." },
+            backgroundMode: { type: "string", enum: ["original", "color"], default: "original", description: "Preserve the portrait background or use a solid color." },
+            backgroundColor: { type: "string", pattern: "^#[0-9a-fA-F]{6}$", default: "#111827", description: "Solid background color when backgroundMode is color." },
+            captions: { type: "boolean", default: false, description: "Whether to add captions." },
+            title: { type: "string", maxLength: 100, description: "Optional video title." },
+            resolution: { type: "string", enum: ["720p", "1080p"], default: "1080p", description: "Output resolution." },
+            aspectRatio: { type: "string", enum: ["9:16", "1:1", "16:9"], default: "9:16", description: "Output aspect ratio." }
+        },
+        required: ["image", "script", "voiceId"]
+    }
 };
+const GENERATE_JEWELLERY_RATE_POSTER_TOOL = {
+    name: "generate_jewellery_rate_poster",
+    description: "Generates a branded gold and silver rate poster. Synchronous: returns the generated image for inline display. Rates are supplied by the caller, not fetched from a market feed.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            scenePrompt: { type: "string", description: "Poster scene, background, and visual style." },
+            productImage: { type: "string", description: "Optional jewelry image URL, data URI, or local file path." },
+            logoImage: { type: "string", description: "Optional brand logo URL, data URI, or local file path." },
+            goldRate24k: { type: "string", description: "24K gold rate text, including currency and units." },
+            goldRate22k: { type: "string", description: "22K gold rate text, including currency and units." },
+            goldRate18k: { type: "string", description: "18K gold rate text, including currency and units." },
+            goldRate14k: { type: "string", description: "14K gold rate text, including currency and units." },
+            silverRate: { type: "string", description: "Silver rate text, including currency and units." },
+            date: { type: "string", description: "Date to display on the poster." },
+            brandName: { type: "string", description: "Jewelry business name." },
+            tagLine: { type: "string", description: "Optional brand tagline." },
+            footerText: { type: "string", description: "Optional footer or disclaimer." },
+            address: { type: "string", description: "Business address." },
+            phoneNumber: { type: "string", description: "Business contact number." },
+            model: { type: "string", description: "Image model slug; use list_image_models to discover models." },
+            resolution: { type: "string", description: "Resolution supported by the selected model (1K, 2K, or 4K)." },
+            aspectRatio: { type: "string", default: "1:1", description: "Aspect ratio supported by the selected model." }
+        },
+        required: ["scenePrompt"]
+    }
+};
+// 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', 'failed', or 'cancelled'.",
     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"]
     }
@@ -243,15 +946,33 @@ const CHECK_JOB_STATUS_TOOL = {
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
         tools: [
+            GENERATE_JEWELLERY_RATE_POSTER_TOOL,
             GENERATE_PRODUCT_PHOTO_TOOL,
             GENERATE_LOGO_TOOL,
+            TRY_ON_JEWELRY_TOOL,
+            TRY_ON_APPAREL_TOOL,
+            TRY_ON_PRODUCT_TOOL,
+            GENERATE_FESTIVAL_POST_TOOL,
+            BUILD_HUMAN_TOOL,
+            GENERATE_YOUTUBE_THUMBNAIL_TOOL,
+            GENERATE_PASSPORT_PHOTO_TOOL,
+            SKETCH_TO_REAL_TOOL,
+            EDIT_PROFESSIONAL_PHOTO_TOOL,
+            EDIT_NANO_BANANA_TOOL,
+            GENERATE_BLOG_IMAGE_TOOL,
+            GENERATE_BABY_MILESTONE_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,
             GENERATE_JEWELRY_VIDEO_TOOL,
             GENERATE_LOGO_VIDEO_TOOL,
+            GENERATE_STORY_VIDEO_TOOL,
+            GENERATE_TALKING_AVATAR_TOOL,
             CHECK_JOB_STATUS_TOOL,
         ],
     };
@@ -259,110 +980,330 @@ 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 || {};
+        if (name === 'generate_jewellery_rate_poster') {
+            const response = await apiClient('/image/jewellery-rate-poster', {
+                method: 'POST',
+                body: JSON.stringify({ ...args, productImage: resolveImageInput(args.productImage),
+                    logoImage: resolveImageInput(args.logoImage), outputResult: 'base64' }),
+            });
+            return formatImageToolResult(response, 'Jewellery Rate Poster Generated');
+        }
+        // ── 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.`;
+            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. Human Builder (synchronous) ────────────────────────────────────────
+        if (name === 'build_human') {
+            const payload = {
+                ...args,
+                referenceImages: Array.isArray(args.referenceImages)
+                    ? args.referenceImages.map((img) => typeof img === 'string'
+                        ? resolveImageInput(img)
+                        : resolveImageInput(img?.dataUrl || img?.path || img?.url))
+                    : undefined,
+            };
+            const response = await apiClient('/image/human-builder', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'AI Human Model Generated');
+        }
+        // ── 8. YouTube Thumbnail (synchronous) ────────────────────────────────────
+        if (name === 'generate_youtube_thumbnail') {
+            const payload = {
+                ...args,
+                personImage: resolveImageInput(args.personImage),
+                backgroundImage: resolveImageInput(args.backgroundImage),
+                logoImage: resolveImageInput(args.logoImage),
+                referenceImage: resolveImageInput(args.referenceImage),
+            };
+            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),
+                referenceImage: resolveImageInput(args.referenceImage),
+            };
+            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. Professional Photography Editor (synchronous) ─────────────────────
+        if (name === 'edit_professional_photo') {
+            let resolvedImages = args.images ? resolveImagesArray(args.images) : [];
+            if (resolvedImages.length === 0 && args.image) {
+                const single = resolveImageInput(args.image);
+                if (single) {
+                    resolvedImages = [{ dataUrl: single }];
+                }
             }
-            else {
-                text += `Result: ${JSON.stringify(result).substring(0, 500)}`;
+            const payload = {
+                ...args,
+                images: resolvedImages,
+                referenceImage: resolveImageInput(args.referenceImage),
+            };
+            const response = await apiClient('/image/professional-photography-editor', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Professional Photo Generated');
+        }
+        // ── 11. Nano Banana Image Editor (synchronous) ────────────────────────────
+        if (name === 'edit_nano_banana') {
+            let resolvedImages = args.images ? resolveImagesArray(args.images) : [];
+            if (resolvedImages.length === 0 && args.image) {
+                const single = resolveImageInput(args.image);
+                if (single) {
+                    resolvedImages = [{ dataUrl: single }];
+                }
             }
-            return { content: [{ type: "text", text }] };
+            const payload = {
+                ...args,
+                images: resolvedImages,
+                referenceImage: resolveImageInput(args.referenceImage),
+            };
+            const response = await apiClient('/image/nano-banana-editor', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Nano Banana Image Generated');
         }
-        // ── QR Code (POST, full-featured) ────────────────────────────────────────
+        // ── 12. Blog Image Generator (synchronous) ────────────────────────────────
+        if (name === 'generate_blog_image') {
+            const payload = {
+                ...args,
+                referenceImage: resolveImageInput(args.referenceImage),
+            };
+            const response = await apiClient('/image/blog-image-generator', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Blog Image Generated');
+        }
+        // ── 13. Baby Milestone Generator (synchronous) ───────────────────────────
+        if (name === 'generate_baby_milestone') {
+            const payload = {
+                ...args,
+                photoDataUri: resolveImageInput(args.photoDataUri),
+                referenceImage: resolveImageInput(args.referenceImage),
+            };
+            const response = await apiClient('/image/baby-milestone-generator', {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            return formatImageToolResult(response, 'Baby Milestone Photo Generated');
+        }
+        // ── 12. 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),
+                signal: AbortSignal.timeout(12 * 60 * 1000),
+            });
+            return formatImageToolResult(response, 'Image Upscaled Successfully');
+        }
+        // ── 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',
             generate_festival_video: '/festival-video-generation',
             generate_jewelry_video: '/jewelry-video-generation',
-            generate_logo_video: '/logo-video-generation'
+            generate_logo_video: '/logo-video-generation',
+            generate_story_video: '/story-teller-generation',
+            generate_talking_avatar: '/ai/talking-avatar/generate'
         };
         if (videoEndpoints[name]) {
+            const optionalImage = (input) => typeof input === 'string' && input.trim()
+                ? resolveImageInput(input) : undefined;
+            const references = Array.isArray(args.referenceImages)
+                ? args.referenceImages.map((reference) => ({
+                    ...reference, image: resolveImageInput(reference.image)
+                })) : undefined;
+            const avatarImage = name === 'generate_talking_avatar' ? optionalImage(args.image) : undefined;
+            if (name === 'generate_talking_avatar' && !/^data:image\/(png|jpeg|webp);base64,/.test(avatarImage || '')) {
+                throw new Error('Talking Avatar requires a PNG, JPEG, or WebP portrait as a local file path or base64 data URI.');
+            }
+            const payload = name === 'generate_talking_avatar' ? { ...args, image: avatarImage } : {
+                ...args,
+                mainImage: optionalImage(args.mainImage),
+                startImage: optionalImage(args.startImage),
+                endImage: optionalImage(args.endImage),
+                referenceImages: references,
+            };
             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 +1312,22 @@ 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 === 'cancelled') {
+                    text += `\nJob cancelled. No further polling is needed.`;
                 }
                 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 +1337,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 +1346,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.2 initialized and running on stdio (28 tools active)");
 }
 run().catch((error) => {
-    console.error("Fatal error running server:", error);
+    console.error("Fatal error running CodingMantra MCP server:", error);
     process.exit(1);
 });