voidless-mcp 1.6.15 → 1.6.17

package/README.md

@@ -113,6 +113,7 @@ Or just the hosted connector, no key: `claude mcp add --transport http voidless
 | `generate_sfx` / `generate_music` | Sound effect, or a music track with length, tempo and key |
 | `generate_video` / `extend_video` | Short clip from a prompt and reference images, or continue one |
 | `generate_3d_model` / `rig_3d_model` / `animate_3d_model` | 3D model, rig it, animate it |
+| `render_3d_sprites` | A 3D model's move (or the model standing) as 2D sprites: 8, 4, platformer, isometric or front views, 16 frames, 32-512 px; free |
 
 Generation tools create new content in your library; none deletes or overwrites existing assets. Each tool's description lists its credit cost.
 

package/index.js

@@ -19,5 +19,5 @@ if (!API_KEY) {
   process.exit(1);
 }
 
-const server = createVoidlessServer(API_KEY);
+const server = createVoidlessServer(API_KEY, "stdio");
 await server.connect(new StdioServerTransport());

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "voidless-mcp",
   "mcpName": "dev.voidless/voidless",
-  "version": "1.6.15",
+  "version": "1.6.17",
   "description": "MCP server for Voidless: generate game sprites, animations, sound, music, video and 3D models",
   "license": "MIT",
   "author": "Voidless Dev Inc. <contact@voidless.dev>",

package/tools.js

@@ -27,7 +27,7 @@ import { Agent, setGlobalDispatcher } from "undici";
 // server does.
 setGlobalDispatcher(new Agent({ headersTimeout: 0, bodyTimeout: 0, connectTimeout: 30_000 }));
 
-export const VERSION = "1.6.15";
+export const VERSION = "1.6.17";
 const BASE_URL = process.env.VOIDLESS_API_URL || "https://api.voidless.dev";
 const CDN_URL = "https://cdn.voidless.dev";
 // Where asset links point. Results link to the asset's page in the app rather than to raw GIFs: the
@@ -49,6 +49,7 @@ const GALLERY_TOOLS = [
   "generate_image", "upload_image", "edit_image", "make_normal_map", "make_glow_map", "rotate_sprite", "animate_sprite", "generate_animation_set",
   "flip_left_side", "generate_video", "generate_sfx", "generate_music", "generate_3d_model", "get_asset",
   "list_assets", "extract_parts", "pixelate_image", "extend_video", "clean_up_sprite", "check_generation",
+  "render_3d_sprites",
 ];
 const GALLERY_HTML = readFileSync(new URL("./gallery.html", import.meta.url), "utf8");
 
@@ -61,6 +62,7 @@ const LONG_PATHS = new Set([
   "/generate/image", "/generate/image-edit", "/generate/bbox-edit", "/generate/image-rotations", "/generate/image-parts",
   "/generate/image-animation", "/generate/multi-animation", "/generate/video", "/generate/video-extend",
   "/generate/sfx", "/generate/music", "/generate/3d-model", "/generate/model-rig", "/generate/model-animation",
+  "/generate/model-sprites",
 ]);
 const WAIT_MS = Number(process.env.VOIDLESS_WAIT_MS) || 80_000;
 const CUT_OFF = /\((502|504|520|522|524)\)|fetch failed|ECONNRESET|socket|terminated|other side closed/i;
@@ -92,11 +94,14 @@ function restoredText(result) {
   ].filter(Boolean).join("\n");
 }
 
-export function createVoidlessServer(API_KEY) {
+// `transport` is "stdio" (index.js) or "hosted" (http.js). Every API call says it comes from the MCP
+// server, so Voidless can tell these generations from the web app's and from direct API use.
+export function createVoidlessServer(API_KEY, transport = "stdio") {
+  const CLIENT = `mcp/${VERSION} (${transport})`;
   async function api(method, path, body, headers = {}) {
     const res = await fetch(`${BASE_URL}/api${path}`, {
       method,
-      headers: { "Content-Type": "application/json", "x-api-key": API_KEY, ...headers },
+      headers: { "Content-Type": "application/json", "x-api-key": API_KEY, "X-Voidless-Client": CLIENT, ...headers },
       body: body === undefined ? undefined : JSON.stringify(body),
     });
 
@@ -1237,6 +1242,50 @@ export function createVoidlessServer(API_KEY) {
     })
   );
 
+  server.tool(
+    "render_3d_sprites",
+    "Render a 3D model as 2D game sprites: one of its moves (from animate_3d_model) or the model standing, " +
+      "seen from 8 directions, 4, the two sides of a platformer, 4 isometric diagonals, or the front. 16 frames " +
+      "by default, at 32-512 px (pixel art up to 128, from the same pass as generated sprites; smooth above). Saved as an " +
+      "animated sprite asset linked to the model, one animation per direction, ready to export as a sheet or " +
+      "edit. Every render of the same model goes onto that one asset. Free.",
+    {
+      id: z.number().int().describe("3D model asset ID"),
+      animation: z
+        .string()
+        .optional()
+        .describe("The move to render: its name ('walk'), preset or animation id. Empty = the model standing"),
+      directions: z
+        .enum(["eight", "four", "platformer", "isometric", "front"])
+        .default("eight")
+        .describe("Which views: 8 around, 4 (down/right/up/left), platformer (right, left, side-on), isometric diagonals, or the front"),
+      size: z
+        .union([z.literal(32), z.literal(64), z.literal(128), z.literal(256), z.literal(512)])
+        .default(128)
+        .describe("Sprite size in pixels: 32-128 come out as pixel art, 256 and 512 as smooth renders"),
+      frames: z.number().int().min(2).max(32).default(16).describe("Frames per direction (default 16)"),
+    },
+    writeTool("Render 3D sprites"),
+    tool(async (args) => {
+      const data = await apiPost("/generate/model-sprites", args);
+      const asset = await apiGet(`/assets/${data.assetId}`).catch(() => null);
+      const name = String(data.animation?.name || "still").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
+      const made = ((asset?.meta_data?.frames) || [])
+        .filter((f) => f && f.type === "animation" && String(f.name || "").startsWith(`${name}-`))
+        .slice(-(data.directions || []).length || undefined);
+      const head = [
+        `${data.animation ? `"${data.animation.name}"` : "The model standing"} rendered from 3D: ` +
+          `${(data.directions || []).length} direction${(data.directions || []).length === 1 ? "" : "s"} ` +
+          `(${(data.directions || []).join(", ")}), ${data.frameCount} frame${data.frameCount === 1 ? "" : "s"} each at ${data.size} px, ${data.fps} fps.`,
+        `${data.added ? "Added to" : "Saved as"} sprite asset ${data.assetId} (${APP_URL}/asset/${data.assetId}), linked to model ${args.id}.`,
+        money(data),
+      ].filter(Boolean).join("\n");
+      const content = [{ type: "text", text: head }];
+      if (made.length) content.push(...(await frameContent(made)));
+      return withGallery({ content }, made.flatMap((f) => frameItems(f, data.assetId)), "3D sprites");
+    })
+  );
+
   // The inline gallery, and the tools whose results it shows.
   server.registerResource(
     "gallery",