voidless-mcp 1.6.7 → 1.6.9

package/README.md

@@ -53,6 +53,18 @@ Claude Code:
 claude mcp add voidless -e VOIDLESS_API_KEY=void_... -- npx -y voidless-mcp
 ```
 
+### Claude Code plugin
+
+The hosted connector plus skills for character sets, tilesets and Godot import
+([source](https://github.com/voidless-03/voidless-mcp)):
+
+```
+/plugin marketplace add voidless-03/voidless-mcp
+/plugin install voidless@voidless
+```
+
+Or just the hosted connector, no key: `claude mcp add --transport http voidless https://mcp.voidless.dev/mcp`
+
 ## Tools
 
 **Your library** (free, read-only)
@@ -79,7 +91,8 @@ claude mcp add voidless -e VOIDLESS_API_KEY=void_... -- npx -y voidless-mcp
 | `rotate_sprite` | An 8-way set (front, back, sides, diagonals) in one pass |
 | `extract_parts` | Split a character into body parts for rigging |
 | `upload_image` | Add an image you already have to your library |
-| `pixelate_image` | Convert any image to pixel art |
+| `pixelate_image` | Convert any image to pixel art (32 to 1024 px) |
+| `clean_up_sprite` | Make a sprite or a 1-5 s animation from anywhere game-ready: background removed, pixel art on a real grid, stray pixels fixed; videos come back as 16 frames |
 
 **Animation**
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "voidless-mcp",
   "mcpName": "dev.voidless/voidless",
-  "version": "1.6.7",
+  "version": "1.6.9",
   "description": "MCP server for Voidless: generate game sprites, animations, sound, music, video and 3D models",
   "license": "MIT",
   "author": "Voidless Dev Inc. <contact@voidless.dev>",
@@ -20,6 +20,14 @@
     "node": ">=18"
   },
   "homepage": "https://voidless.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voidless-03/voidless-mcp.git",
+    "directory": "server"
+  },
+  "bugs": {
+    "url": "https://github.com/voidless-03/voidless-mcp/issues"
+  },
   "keywords": [
     "mcp",
     "model-context-protocol",

package/tools.js

@@ -25,7 +25,7 @@ import { Agent, setGlobalDispatcher } from "undici";
 // server does.
 setGlobalDispatcher(new Agent({ headersTimeout: 0, bodyTimeout: 0, connectTimeout: 30_000 }));
 
-export const VERSION = "1.6.7";
+export const VERSION = "1.6.9";
 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
@@ -46,7 +46,7 @@ const GALLERY_MIME = "text/html;profile=mcp-app";
 const GALLERY_TOOLS = [
   "generate_image", "upload_image", "edit_image", "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",
+  "list_assets", "extract_parts", "pixelate_image", "extend_video", "clean_up_sprite",
 ];
 const GALLERY_HTML = readFileSync(new URL("./gallery.html", import.meta.url), "utf8");
 
@@ -620,9 +620,9 @@ export function createVoidlessServer(API_KEY) {
         ),
       dimension: z.enum(["2d", "top down", "isometric"]).default("2d").describe("'2d' = side view, 'top down' = overhead, 'isometric' = 2.5D"),
       size: z
-        .union([z.literal(32), z.literal(64), z.literal(128), z.literal(512), z.literal(1024)])
+        .union([z.literal(32), z.literal(64), z.literal(128), z.literal(256), z.literal(512), z.literal(1024)])
         .default(512)
-        .describe("Output px. 32/64/128 give a pixel-art look; 512 for every other style; 1024 for high-res."),
+        .describe("Output px. 32/64/128/256 give a pixel-art look; 512 for every other style; 1024 for high-res."),
       colours: z.number().int().min(4).max(12).default(8).describe("Colour count for pixel-art reduction (4–12)"),
       style: z
         .string()
@@ -736,7 +736,7 @@ export function createVoidlessServer(API_KEY) {
   server.tool(
     "upload_image",
     "Add an image the user already has to their library, so it can be animated, rotated or edited. It must " +
-      "be square at 32, 64, 128, 512 or 1024 px. Free.",
+      "be square at 32, 64, 128, 256, 512 or 1024 px. Free.",
     {
       image: z.string().describe("Base64 image (a data: prefix is stripped automatically)"),
       type: z.enum(["object", "character", "character portrait", "artwork"]).default("character"),
@@ -755,7 +755,8 @@ export function createVoidlessServer(API_KEY) {
       "saved to the library. 1 credit.",
     {
       image: z.string().describe("Base64 source image (a data: prefix is stripped automatically)"),
-      size: z.union([z.literal(32), z.literal(64), z.literal(128), z.literal(512)]).default(64),
+      size: z.union([z.literal(32), z.literal(64), z.literal(128), z.literal(256), z.literal(512), z.literal(1024)]).default(64)
+        .describe("Pixel size. 512 and 1024 are drawn on a real 4x grid (128 / 256 art pixels)"),
       colours: z.number().int().min(4).max(12).default(8),
     },
     writeTool("Pixelate image"),
@@ -771,6 +772,56 @@ export function createVoidlessServer(API_KEY) {
     })
   );
 
+  server.tool(
+    "clean_up_sprite",
+    "Make a sprite or a short animation made ANYWHERE (another AI tool, an artist, a screen recording) " +
+      "game-ready with Voidless's own clean-up: background removed with stray pieces checked (sparks and dust " +
+      "kept, smudges removed); pixel art put on a real pixel grid with one palette and stray pixels fixed. A 1-5 s " +
+      "video comes back as 16 frames: kind 'loop' cuts the cleanest loop (walk, run, idle), 'once' keeps the " +
+      "whole move (attack, jump). Saved to the user's library. Give the file as a public URL (best for videos) or " +
+      "base64. 1 free run a day (10 on Voidless+), then 1 credit an image, 2 a video. For a quick pixel-art " +
+      "version of an already clean image, pixelate_image is enough.",
+    {
+      url: z.string().optional().describe("Public http(s) link to the image or video. Use this for videos"),
+      file: z.string().optional().describe("Base64 file instead of url (a data: prefix is stripped automatically)"),
+      kind: z.enum(["image", "video"]).optional().describe("What the file is. Inferred from the url's extension when omitted"),
+      style: z.enum(["pixel", "smooth"]).default("pixel").describe("pixel = pixel art at 32-1024; smooth = clean cut-out at 512 or 1024"),
+      size: z.union([z.literal(32), z.literal(64), z.literal(128), z.literal(256), z.literal(512), z.literal(1024)]).optional()
+        .describe("Output size. Default 64 for pixel, 512 for smooth (smooth allows only 512 or 1024)"),
+      motion: z.enum(["loop", "once"]).default("loop").describe("Video only: loop = find the cleanest loop; once = keep the whole clip"),
+    },
+    writeTool("Clean up sprite"),
+    tool(async ({ url, file, kind, style, size, motion }) => {
+      if (!url && !file) throw new Error("Give the file as a url or as base64 in file.");
+      const pixel = style !== "smooth";
+      const out = size || (pixel ? 64 : 512);
+      if (!pixel && out !== 512 && out !== 1024) throw new Error("Smooth art comes back at 512 or 1024.");
+      const guessed = /\.(mp4|webm|mov|m4v)(\?|$)/i.test(String(url || "")) ? "video"
+        : /^data:video\//i.test(String(file || "")) ? "video" : "image";
+      const body = { kind: kind || guessed, size: out, pixel, loop: motion };
+      if (url) body.url = url;
+      else body.data = String(file).replace(/^data:[^,]*,/, "");
+      const data = await apiPost("/cleanup/run", body);
+      const link = data.assetId ? `${APP_URL}/asset/${data.assetId}` : undefined;
+      const lines = [
+        `Cleaned up: ${data.kind === "video" ? `${(data.images || []).length} frames` : "1 sprite"} at ${data.size}px${data.pixel ? " pixel art" : ""}.`,
+        data.assetId ? `Asset ID: ${data.assetId} · ${link}` : null,
+        data.kind === "video" && Array.isArray(data.span) ? `Frames taken from ${data.span[0]}s to ${data.span[1]}s of the clip.` : null,
+        data.free ? `Free run (${data.freeLeft} free left today).` : null,
+        money(data),
+      ].filter(Boolean);
+      const content = [{ type: "text", text: lines.join("\n") }];
+      if (data.kind === "video") {
+        const frame = { id: 0, name: "Clean-up", type: "animation", images: data.images || [], gif: data.gif };
+        content.push(...(await frameContent([frame])));
+        return withGallery({ content }, frameItems(frame, data.assetId), "Clean-up");
+      }
+      const image = await inlineImage(data.file);
+      if (image) content.push(image);
+      return withGallery({ content }, [mediaItem(data.file, "Cleaned up", { link })], "Clean-up");
+    })
+  );
+
   // ---------------------------------------------------------------------------
   // Animation
   // ---------------------------------------------------------------------------
@@ -920,12 +971,12 @@ export function createVoidlessServer(API_KEY) {
 
   server.tool(
     "generate_3d_model",
-    "Generate a 3D model (GLB) from a prompt. 15 credits (lq) or 25 (hq).",
+    "Generate a 3D model (GLB) from a prompt. 15 credits (lq) or 60 (hq).",
     {
       prompt: z.string().describe("The model to make"),
       type: z.enum(["object", "character"]).default("object").describe("'character' makes a T-posed figure ready for rigging"),
       style: z.string().default("cartoon style").describe("e.g. 'cartoon style', 'low-poly', 'realistic'"),
-      mode: z.enum(["lq", "hq"]).default("hq").describe("lq = fast draft, hq = detailed"),
+      mode: z.enum(["lq", "hq"]).default("hq").describe("lq = fast draft (15 credits), hq = detailed (60 credits)"),
       bodyType: z.enum(["humanoid", "quadruped"]).default("humanoid").describe("Characters only"),
       seed: z.number().int().min(0).default(0),
     },