@meshy-ai/meshy-mcp-server 0.2.0

package/dist/schemas/balance.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Zod schema for balance tool
+ */
+import { z } from "zod";
+export declare const CheckBalanceInputSchema: z.ZodObject<{
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../constants.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: import("../constants.js").ResponseFormat;
+}, {
+    response_format?: import("../constants.js").ResponseFormat | undefined;
+}>;

package/dist/schemas/balance.js

@@ -0,0 +1,8 @@
+/**
+ * Zod schema for balance tool
+ */
+import { z } from "zod";
+import { ResponseFormatSchema } from "./common.js";
+export const CheckBalanceInputSchema = z.object({
+    response_format: ResponseFormatSchema
+}).strict();

package/dist/schemas/common.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Common Zod schemas shared across tools
+ */
+import { z } from "zod";
+import { ResponseFormat, TaskType } from "../constants.js";
+/**
+ * Response format schema
+ */
+export declare const ResponseFormatSchema: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+/**
+ * Pagination schema
+ */
+export declare const PaginationSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+/**
+ * Task ID schema
+ */
+export declare const TaskIdSchema: z.ZodString;
+/**
+ * URL schema
+ */
+export declare const UrlSchema: z.ZodString;
+/**
+ * Prompt schema
+ */
+export declare const PromptSchema: z.ZodString;
+/**
+ * Task type schema
+ */
+export declare const TaskTypeSchema: z.ZodDefault<z.ZodNativeEnum<typeof TaskType>>;

package/dist/schemas/common.js

@@ -0,0 +1,52 @@
+/**
+ * Common Zod schemas shared across tools
+ */
+import { z } from "zod";
+import { ResponseFormat, TaskType } from "../constants.js";
+/**
+ * Response format schema
+ */
+export const ResponseFormatSchema = z.nativeEnum(ResponseFormat)
+    .default(ResponseFormat.MARKDOWN)
+    .describe("Output format: 'markdown' for human-readable or 'json' for machine-readable");
+/**
+ * Pagination schema
+ */
+export const PaginationSchema = z.object({
+    limit: z.number()
+        .int()
+        .min(1, "Limit must be at least 1")
+        .max(100, "Limit cannot exceed 100")
+        .default(20)
+        .describe("Maximum number of results to return"),
+    offset: z.number()
+        .int()
+        .min(0, "Offset cannot be negative")
+        .default(0)
+        .describe("Number of results to skip for pagination")
+});
+/**
+ * Task ID schema
+ */
+export const TaskIdSchema = z.string()
+    .min(1, "Task ID is required")
+    .describe("Unique task identifier (UUID)");
+/**
+ * URL schema
+ */
+export const UrlSchema = z.string()
+    .url("Must be a valid URL")
+    .describe("Publicly accessible URL");
+/**
+ * Prompt schema
+ */
+export const PromptSchema = z.string()
+    .min(2, "Prompt must be at least 2 characters")
+    .max(600, "Prompt must not exceed 600 characters")
+    .describe("Text description");
+/**
+ * Task type schema
+ */
+export const TaskTypeSchema = z.nativeEnum(TaskType)
+    .default(TaskType.TEXT_TO_3D)
+    .describe("Task type to determine correct API endpoint. Defaults to 'text-to-3d'");

package/dist/schemas/generation.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Zod schemas for generation tools
+ */
+import { z } from "zod";
+import { AIModel, ModelType, SymmetryMode, Topology, PoseMode } from "../constants.js";
+/**
+ * Text-to-3D input schema
+ */
+export declare const TextTo3DInputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    ai_model: z.ZodDefault<z.ZodNativeEnum<typeof AIModel>>;
+    model_type: z.ZodOptional<z.ZodNativeEnum<typeof ModelType>>;
+    topology: z.ZodOptional<z.ZodNativeEnum<typeof Topology>>;
+    target_polycount: z.ZodOptional<z.ZodNumber>;
+    symmetry_mode: z.ZodOptional<z.ZodNativeEnum<typeof SymmetryMode>>;
+    should_remesh: z.ZodOptional<z.ZodBoolean>;
+    pose_mode: z.ZodOptional<z.ZodNativeEnum<typeof PoseMode>>;
+    target_formats: z.ZodOptional<z.ZodArray<z.ZodEnum<["glb", "obj", "fbx", "stl", "usdz", "3mf"]>, "many">>;
+    auto_size: z.ZodOptional<z.ZodBoolean>;
+    origin_at: z.ZodOptional<z.ZodEnum<["bottom", "center"]>>;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../constants.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    ai_model: AIModel;
+    response_format: import("../constants.js").ResponseFormat;
+    model_type?: ModelType | undefined;
+    topology?: Topology | undefined;
+    target_polycount?: number | undefined;
+    symmetry_mode?: SymmetryMode | undefined;
+    should_remesh?: boolean | undefined;
+    pose_mode?: PoseMode | undefined;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+}, {
+    prompt: string;
+    ai_model?: AIModel | undefined;
+    model_type?: ModelType | undefined;
+    topology?: Topology | undefined;
+    target_polycount?: number | undefined;
+    symmetry_mode?: SymmetryMode | undefined;
+    should_remesh?: boolean | undefined;
+    pose_mode?: PoseMode | undefined;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+    response_format?: import("../constants.js").ResponseFormat | undefined;
+}>;
+/**
+ * Image-to-3D input schema
+ */
+export declare const ImageTo3DInputSchema: z.ZodObject<{
+    image_url: z.ZodOptional<z.ZodString>;
+    file_path: z.ZodOptional<z.ZodString>;
+    ai_model: z.ZodDefault<z.ZodNativeEnum<typeof AIModel>>;
+    model_type: z.ZodOptional<z.ZodNativeEnum<typeof ModelType>>;
+    pose_mode: z.ZodOptional<z.ZodNativeEnum<typeof PoseMode>>;
+    enable_pbr: z.ZodDefault<z.ZodBoolean>;
+    topology: z.ZodOptional<z.ZodNativeEnum<typeof Topology>>;
+    target_polycount: z.ZodOptional<z.ZodNumber>;
+    should_remesh: z.ZodOptional<z.ZodBoolean>;
+    symmetry_mode: z.ZodOptional<z.ZodNativeEnum<typeof SymmetryMode>>;
+    should_texture: z.ZodOptional<z.ZodBoolean>;
+    texture_prompt: z.ZodOptional<z.ZodString>;
+    texture_image_url: z.ZodOptional<z.ZodString>;
+    image_enhancement: z.ZodOptional<z.ZodBoolean>;
+    remove_lighting: z.ZodDefault<z.ZodBoolean>;
+    save_pre_remeshed_model: z.ZodOptional<z.ZodBoolean>;
+    target_formats: z.ZodOptional<z.ZodArray<z.ZodEnum<["glb", "obj", "fbx", "stl", "usdz", "3mf"]>, "many">>;
+    auto_size: z.ZodOptional<z.ZodBoolean>;
+    origin_at: z.ZodOptional<z.ZodEnum<["bottom", "center"]>>;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../constants.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    ai_model: AIModel;
+    response_format: import("../constants.js").ResponseFormat;
+    enable_pbr: boolean;
+    remove_lighting: boolean;
+    model_type?: ModelType | undefined;
+    topology?: Topology | undefined;
+    target_polycount?: number | undefined;
+    symmetry_mode?: SymmetryMode | undefined;
+    should_remesh?: boolean | undefined;
+    pose_mode?: PoseMode | undefined;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+    image_url?: string | undefined;
+    file_path?: string | undefined;
+    should_texture?: boolean | undefined;
+    texture_prompt?: string | undefined;
+    texture_image_url?: string | undefined;
+    image_enhancement?: boolean | undefined;
+    save_pre_remeshed_model?: boolean | undefined;
+}, {
+    ai_model?: AIModel | undefined;
+    model_type?: ModelType | undefined;
+    topology?: Topology | undefined;
+    target_polycount?: number | undefined;
+    symmetry_mode?: SymmetryMode | undefined;
+    should_remesh?: boolean | undefined;
+    pose_mode?: PoseMode | undefined;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+    response_format?: import("../constants.js").ResponseFormat | undefined;
+    image_url?: string | undefined;
+    file_path?: string | undefined;
+    enable_pbr?: boolean | undefined;
+    should_texture?: boolean | undefined;
+    texture_prompt?: string | undefined;
+    texture_image_url?: string | undefined;
+    image_enhancement?: boolean | undefined;
+    remove_lighting?: boolean | undefined;
+    save_pre_remeshed_model?: boolean | undefined;
+}>;
+/**
+ * Text-to-3D Refine input schema
+ */
+export declare const TextTo3DRefineInputSchema: z.ZodObject<{
+    preview_task_id: z.ZodString;
+    enable_pbr: z.ZodDefault<z.ZodBoolean>;
+    texture_prompt: z.ZodOptional<z.ZodString>;
+    texture_image_url: z.ZodOptional<z.ZodString>;
+    ai_model: z.ZodDefault<z.ZodNativeEnum<typeof AIModel>>;
+    remove_lighting: z.ZodDefault<z.ZodBoolean>;
+    target_formats: z.ZodOptional<z.ZodArray<z.ZodEnum<["glb", "obj", "fbx", "stl", "usdz", "3mf"]>, "many">>;
+    auto_size: z.ZodOptional<z.ZodBoolean>;
+    origin_at: z.ZodOptional<z.ZodEnum<["bottom", "center"]>>;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../constants.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    ai_model: AIModel;
+    response_format: import("../constants.js").ResponseFormat;
+    enable_pbr: boolean;
+    remove_lighting: boolean;
+    preview_task_id: string;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+    texture_prompt?: string | undefined;
+    texture_image_url?: string | undefined;
+}, {
+    preview_task_id: string;
+    ai_model?: AIModel | undefined;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+    response_format?: import("../constants.js").ResponseFormat | undefined;
+    enable_pbr?: boolean | undefined;
+    texture_prompt?: string | undefined;
+    texture_image_url?: string | undefined;
+    remove_lighting?: boolean | undefined;
+}>;
+/**
+ * Multi-image-to-3D input schema
+ */
+export declare const MultiImageTo3DInputSchema: z.ZodObject<{
+    image_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    file_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ai_model: z.ZodDefault<z.ZodNativeEnum<typeof AIModel>>;
+    model_type: z.ZodOptional<z.ZodNativeEnum<typeof ModelType>>;
+    pose_mode: z.ZodOptional<z.ZodNativeEnum<typeof PoseMode>>;
+    enable_pbr: z.ZodDefault<z.ZodBoolean>;
+    topology: z.ZodOptional<z.ZodNativeEnum<typeof Topology>>;
+    target_polycount: z.ZodOptional<z.ZodNumber>;
+    should_remesh: z.ZodOptional<z.ZodBoolean>;
+    symmetry_mode: z.ZodOptional<z.ZodNativeEnum<typeof SymmetryMode>>;
+    should_texture: z.ZodOptional<z.ZodBoolean>;
+    texture_prompt: z.ZodOptional<z.ZodString>;
+    texture_image_url: z.ZodOptional<z.ZodString>;
+    image_enhancement: z.ZodOptional<z.ZodBoolean>;
+    remove_lighting: z.ZodDefault<z.ZodBoolean>;
+    save_pre_remeshed_model: z.ZodOptional<z.ZodBoolean>;
+    target_formats: z.ZodOptional<z.ZodArray<z.ZodEnum<["glb", "obj", "fbx", "stl", "usdz", "3mf"]>, "many">>;
+    auto_size: z.ZodOptional<z.ZodBoolean>;
+    origin_at: z.ZodOptional<z.ZodEnum<["bottom", "center"]>>;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../constants.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    ai_model: AIModel;
+    response_format: import("../constants.js").ResponseFormat;
+    enable_pbr: boolean;
+    remove_lighting: boolean;
+    model_type?: ModelType | undefined;
+    topology?: Topology | undefined;
+    target_polycount?: number | undefined;
+    symmetry_mode?: SymmetryMode | undefined;
+    should_remesh?: boolean | undefined;
+    pose_mode?: PoseMode | undefined;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+    should_texture?: boolean | undefined;
+    texture_prompt?: string | undefined;
+    texture_image_url?: string | undefined;
+    image_enhancement?: boolean | undefined;
+    save_pre_remeshed_model?: boolean | undefined;
+    image_urls?: string[] | undefined;
+    file_paths?: string[] | undefined;
+}, {
+    ai_model?: AIModel | undefined;
+    model_type?: ModelType | undefined;
+    topology?: Topology | undefined;
+    target_polycount?: number | undefined;
+    symmetry_mode?: SymmetryMode | undefined;
+    should_remesh?: boolean | undefined;
+    pose_mode?: PoseMode | undefined;
+    target_formats?: ("glb" | "fbx" | "usdz" | "3mf" | "obj" | "stl")[] | undefined;
+    auto_size?: boolean | undefined;
+    origin_at?: "bottom" | "center" | undefined;
+    response_format?: import("../constants.js").ResponseFormat | undefined;
+    enable_pbr?: boolean | undefined;
+    should_texture?: boolean | undefined;
+    texture_prompt?: string | undefined;
+    texture_image_url?: string | undefined;
+    image_enhancement?: boolean | undefined;
+    remove_lighting?: boolean | undefined;
+    save_pre_remeshed_model?: boolean | undefined;
+    image_urls?: string[] | undefined;
+    file_paths?: string[] | undefined;
+}>;

package/dist/schemas/generation.js

@@ -0,0 +1,217 @@
+/**
+ * Zod schemas for generation tools
+ */
+import { z } from "zod";
+import { AIModel, ModelType, SymmetryMode, Topology, PoseMode } from "../constants.js";
+/**
+ * Shared target_formats schema.
+ * 3MF is NOT included in default output — must be explicitly requested.
+ */
+const TargetFormatsSchema = z.array(z.enum(["glb", "obj", "fbx", "stl", "usdz", "3mf"]))
+    .optional()
+    .describe("Output formats to generate. When omitted, produces glb/obj/fbx/stl/usdz but NOT 3mf. To get 3MF, you MUST include '3mf' explicitly (e.g. [\"glb\", \"3mf\"]). Specifying formats can reduce task completion time.");
+import { ResponseFormatSchema, PromptSchema, UrlSchema } from "./common.js";
+/**
+ * Text-to-3D input schema
+ */
+export const TextTo3DInputSchema = z.object({
+    prompt: PromptSchema,
+    ai_model: z.nativeEnum(AIModel)
+        .default(AIModel.LATEST)
+        .describe("AI model: 'meshy-5', 'meshy-6', or 'latest' (default, currently resolves to Meshy 6). IMPORTANT: Before calling this tool, ask the user which model to use and explain the differences: meshy-6/latest = best quality (20 credits), meshy-5 = previous gen (5 credits)"),
+    model_type: z.nativeEnum(ModelType)
+        .optional()
+        .describe("Model type: 'standard' or 'lowpoly'. When 'lowpoly', ai_model/topology/target_polycount/should_remesh are ignored"),
+    topology: z.nativeEnum(Topology)
+        .optional()
+        .describe("Mesh topology type (quad or triangle)"),
+    target_polycount: z.number()
+        .int()
+        .min(100, "Polycount must be at least 100")
+        .max(300000, "Polycount cannot exceed 300,000")
+        .optional()
+        .describe("Target polygon count for the model (100–300,000)"),
+    symmetry_mode: z.nativeEnum(SymmetryMode)
+        .optional()
+        .describe("Symmetry mode: 'off', 'auto' (default), or 'on'"),
+    should_remesh: z.boolean()
+        .optional()
+        .describe("Whether to remesh. Default false for meshy-6, true for others"),
+    pose_mode: z.nativeEnum(PoseMode)
+        .optional()
+        .describe("Pose mode for character models: 'a-pose' or 't-pose'. IMPORTANT: When the user intends to rig or animate the model, default to 't-pose' for best rigging results"),
+    target_formats: TargetFormatsSchema,
+    auto_size: z.boolean()
+        .optional()
+        .describe("Use AI to auto-estimate real-world height and resize the model. Default false."),
+    origin_at: z.enum(["bottom", "center"])
+        .optional()
+        .describe("Origin position: 'bottom' or 'center'. Default 'bottom' when auto_size is true."),
+    response_format: ResponseFormatSchema
+}).strict();
+/**
+ * Image-to-3D input schema
+ */
+export const ImageTo3DInputSchema = z.object({
+    image_url: z.string()
+        .optional()
+        .describe("PUBLIC image URL (https://...). Use ONLY for remote images. For local files use file_path instead. NEVER manually base64-encode."),
+    file_path: z.string()
+        .optional()
+        .describe("ABSOLUTE path to LOCAL image (.jpg/.png). PREFERRED for local files. Server auto-encodes. Example: /Users/me/photo.jpg. NEVER manually base64-encode."),
+    ai_model: z.nativeEnum(AIModel)
+        .default(AIModel.LATEST)
+        .describe("AI model: 'meshy-5', 'meshy-6', or 'latest' (default, currently resolves to Meshy 6). IMPORTANT: Before calling this tool, ask the user which model to use and explain the differences: meshy-6/latest = best quality (20 credits), meshy-5 = previous gen (5 credits)"),
+    model_type: z.nativeEnum(ModelType)
+        .optional()
+        .describe("Model type: 'standard' or 'lowpoly'"),
+    pose_mode: z.nativeEnum(PoseMode)
+        .optional()
+        .describe("Pose mode for character models: 'a-pose' or 't-pose'. IMPORTANT: When the user intends to rig or animate the model, default to 't-pose' for best rigging results"),
+    enable_pbr: z.boolean()
+        .default(false)
+        .describe("Enable physically-based rendering textures. Default false"),
+    topology: z.nativeEnum(Topology)
+        .optional()
+        .describe("Mesh topology type (quad or triangle)"),
+    target_polycount: z.number()
+        .int()
+        .min(100, "Polycount must be at least 100")
+        .max(300000, "Polycount cannot exceed 300,000")
+        .optional()
+        .describe("Target polygon count for the model (100–300,000)"),
+    should_remesh: z.boolean()
+        .optional()
+        .describe("Whether to remesh. Default false for meshy-6, true for others"),
+    symmetry_mode: z.nativeEnum(SymmetryMode)
+        .optional()
+        .describe("Symmetry mode: 'off', 'auto' (default), or 'on'"),
+    should_texture: z.boolean()
+        .optional()
+        .describe("Whether to generate textures. Default true"),
+    texture_prompt: z.string()
+        .max(600)
+        .optional()
+        .describe("Text to guide texturing. Max 600 characters"),
+    texture_image_url: UrlSchema
+        .optional()
+        .describe("Image URL to guide texturing"),
+    image_enhancement: z.boolean()
+        .optional()
+        .describe("Optimize input image for better results. Default true. Meshy-6/latest only"),
+    remove_lighting: z.boolean()
+        .default(true)
+        .describe("Removes highlights and shadows from the base color texture for cleaner results under custom lighting. Default true. Only supported when ai_model is meshy-6 or latest"),
+    save_pre_remeshed_model: z.boolean()
+        .optional()
+        .describe("Store GLB before remeshing. Default false. Only applies when should_remesh is true"),
+    target_formats: TargetFormatsSchema,
+    auto_size: z.boolean()
+        .optional()
+        .describe("Use AI to auto-estimate real-world height and resize the model. Default false."),
+    origin_at: z.enum(["bottom", "center"])
+        .optional()
+        .describe("Origin position: 'bottom' or 'center'. Default 'bottom' when auto_size is true."),
+    response_format: ResponseFormatSchema
+}).strict();
+/**
+ * Text-to-3D Refine input schema
+ */
+export const TextTo3DRefineInputSchema = z.object({
+    preview_task_id: z.string()
+        .min(1, "Preview task ID is required")
+        .describe("Task ID of the completed preview task to refine"),
+    enable_pbr: z.boolean()
+        .default(false)
+        .describe("Enable physically-based rendering textures"),
+    texture_prompt: z.string()
+        .max(600, "Texture prompt must not exceed 600 characters")
+        .optional()
+        .describe("Text to guide texturing. Max 600 characters"),
+    texture_image_url: UrlSchema
+        .optional()
+        .describe("Image URL to guide texturing"),
+    ai_model: z.nativeEnum(AIModel)
+        .default(AIModel.LATEST)
+        .describe("AI model: 'meshy-5', 'meshy-6', or 'latest' (default, currently resolves to Meshy 6). IMPORTANT: Before calling this tool, ask the user which model to use and explain the differences: meshy-6/latest = best quality (10 credits), meshy-5 = previous gen (10 credits)"),
+    remove_lighting: z.boolean()
+        .default(true)
+        .describe("Removes highlights and shadows from the base color texture for cleaner results under custom lighting. Default true. Only supported when ai_model is meshy-6 or latest"),
+    target_formats: TargetFormatsSchema,
+    auto_size: z.boolean()
+        .optional()
+        .describe("Use AI to auto-estimate real-world height and resize the model. Default false."),
+    origin_at: z.enum(["bottom", "center"])
+        .optional()
+        .describe("Origin position: 'bottom' or 'center'. Default 'bottom' when auto_size is true."),
+    response_format: ResponseFormatSchema
+}).strict();
+/**
+ * Multi-image-to-3D input schema
+ */
+export const MultiImageTo3DInputSchema = z.object({
+    image_urls: z.array(z.string())
+        .min(1)
+        .max(4)
+        .optional()
+        .describe("Array of 1–4 publicly accessible image URLs. Provide this OR file_paths, not both"),
+    file_paths: z.array(z.string())
+        .min(1)
+        .max(4)
+        .optional()
+        .describe("Array of 1–4 absolute paths to local image files (.jpg, .jpeg, .png). The server reads and encodes them automatically"),
+    ai_model: z.nativeEnum(AIModel)
+        .default(AIModel.LATEST)
+        .describe("AI model: 'meshy-5', 'meshy-6', or 'latest' (default, currently resolves to Meshy 6). IMPORTANT: Before calling this tool, ask the user which model to use and explain the differences: meshy-6/latest = best quality (20 credits), meshy-5 = previous gen (5 credits)"),
+    model_type: z.nativeEnum(ModelType)
+        .optional()
+        .describe("Model type: 'standard' or 'lowpoly'"),
+    pose_mode: z.nativeEnum(PoseMode)
+        .optional()
+        .describe("Pose mode for character models: 'a-pose' or 't-pose'. IMPORTANT: When the user intends to rig or animate the model, default to 't-pose' for best rigging results"),
+    enable_pbr: z.boolean()
+        .default(false)
+        .describe("Enable physically-based rendering textures. Default false"),
+    topology: z.nativeEnum(Topology)
+        .optional()
+        .describe("Mesh topology type (quad or triangle)"),
+    target_polycount: z.number()
+        .int()
+        .min(100, "Polycount must be at least 100")
+        .max(300000, "Polycount cannot exceed 300,000")
+        .optional()
+        .describe("Target polygon count for the model (100–300,000)"),
+    should_remesh: z.boolean()
+        .optional()
+        .describe("Whether to remesh. Default false for meshy-6, true for others"),
+    symmetry_mode: z.nativeEnum(SymmetryMode)
+        .optional()
+        .describe("Symmetry mode: 'off', 'auto' (default), or 'on'"),
+    should_texture: z.boolean()
+        .optional()
+        .describe("Whether to generate textures. Default true"),
+    texture_prompt: z.string()
+        .max(600)
+        .optional()
+        .describe("Text to guide texturing. Max 600 characters"),
+    texture_image_url: UrlSchema
+        .optional()
+        .describe("Image URL to guide texturing"),
+    image_enhancement: z.boolean()
+        .optional()
+        .describe("Optimize input images for better results. Default true. Meshy-6/latest only"),
+    remove_lighting: z.boolean()
+        .default(true)
+        .describe("Removes highlights and shadows from the base color texture for cleaner results under custom lighting. Default true. Only supported when ai_model is meshy-6 or latest"),
+    save_pre_remeshed_model: z.boolean()
+        .optional()
+        .describe("Store GLB before remeshing. Default false. Only applies when should_remesh is true"),
+    target_formats: TargetFormatsSchema,
+    auto_size: z.boolean()
+        .optional()
+        .describe("Use AI to auto-estimate real-world height and resize the model. Default false."),
+    origin_at: z.enum(["bottom", "center"])
+        .optional()
+        .describe("Origin position: 'bottom' or 'center'. Default 'bottom' when auto_size is true."),
+    response_format: ResponseFormatSchema
+}).strict();

package/dist/schemas/image.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Zod schemas for image generation tools (text-to-image, image-to-image)
+ */
+import { z } from "zod";
+import { TextToImageModel, AspectRatio, PoseMode } from "../constants.js";
+/**
+ * Text-to-image input schema
+ */
+export declare const TextToImageInputSchema: z.ZodObject<{
+    ai_model: z.ZodNativeEnum<typeof TextToImageModel>;
+    prompt: z.ZodString;
+    generate_multi_view: z.ZodDefault<z.ZodBoolean>;
+    pose_mode: z.ZodOptional<z.ZodNativeEnum<typeof PoseMode>>;
+    aspect_ratio: z.ZodDefault<z.ZodNativeEnum<typeof AspectRatio>>;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../constants.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    ai_model: TextToImageModel;
+    response_format: import("../constants.js").ResponseFormat;
+    generate_multi_view: boolean;
+    aspect_ratio: AspectRatio;
+    pose_mode?: PoseMode | undefined;
+}, {
+    prompt: string;
+    ai_model: TextToImageModel;
+    pose_mode?: PoseMode | undefined;
+    response_format?: import("../constants.js").ResponseFormat | undefined;
+    generate_multi_view?: boolean | undefined;
+    aspect_ratio?: AspectRatio | undefined;
+}>;
+/**
+ * Image-to-image input schema
+ */
+export declare const ImageToImageInputSchema: z.ZodObject<{
+    ai_model: z.ZodNativeEnum<typeof TextToImageModel>;
+    prompt: z.ZodString;
+    reference_image_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    reference_file_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    generate_multi_view: z.ZodDefault<z.ZodBoolean>;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../constants.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    ai_model: TextToImageModel;
+    response_format: import("../constants.js").ResponseFormat;
+    generate_multi_view: boolean;
+    reference_image_urls?: string[] | undefined;
+    reference_file_paths?: string[] | undefined;
+}, {
+    prompt: string;
+    ai_model: TextToImageModel;
+    response_format?: import("../constants.js").ResponseFormat | undefined;
+    generate_multi_view?: boolean | undefined;
+    reference_image_urls?: string[] | undefined;
+    reference_file_paths?: string[] | undefined;
+}>;

package/dist/schemas/image.js

@@ -0,0 +1,46 @@
+/**
+ * Zod schemas for image generation tools (text-to-image, image-to-image)
+ */
+import { z } from "zod";
+import { TextToImageModel, AspectRatio, PoseMode } from "../constants.js";
+import { ResponseFormatSchema, PromptSchema } from "./common.js";
+/**
+ * Text-to-image input schema
+ */
+export const TextToImageInputSchema = z.object({
+    ai_model: z.nativeEnum(TextToImageModel)
+        .describe("AI model to use for image generation"),
+    prompt: PromptSchema,
+    generate_multi_view: z.boolean()
+        .default(false)
+        .describe("Generate multiple viewpoint images (front, side, back)"),
+    pose_mode: z.nativeEnum(PoseMode)
+        .optional()
+        .describe("Pose mode for character images: 'a-pose' or 't-pose'"),
+    aspect_ratio: z.nativeEnum(AspectRatio)
+        .default(AspectRatio.SQUARE)
+        .describe("Aspect ratio of generated image (default: '1:1')"),
+    response_format: ResponseFormatSchema
+}).strict();
+/**
+ * Image-to-image input schema
+ */
+export const ImageToImageInputSchema = z.object({
+    ai_model: z.nativeEnum(TextToImageModel)
+        .describe("AI model to use for image transformation"),
+    prompt: PromptSchema,
+    reference_image_urls: z.array(z.string())
+        .min(1)
+        .max(5)
+        .optional()
+        .describe("Array of 1–5 publicly accessible reference image URLs. Provide this OR reference_file_paths, not both"),
+    reference_file_paths: z.array(z.string())
+        .min(1)
+        .max(5)
+        .optional()
+        .describe("Array of 1–5 absolute paths to local reference image files. The server reads and encodes them automatically"),
+    generate_multi_view: z.boolean()
+        .default(false)
+        .describe("Generate multiple viewpoint images (front, side, back)"),
+    response_format: ResponseFormatSchema
+}).strict();