voidless-mcp 1.7.0 → 1.7.1

package/README.md

@@ -118,7 +118,9 @@ Or just the hosted connector, no key: `claude mcp add --transport http voidless
 
 **Free game-dev tools** (no credits)
 
-The same tools as [voidless.dev/tools](https://voidless.dev/tools), for any image, not just your library. Inputs are image URLs (a `cdn.voidless.dev` link from `get_asset` works) or base64/data URIs, PNG or GIF, up to 2048x2048, 256 frames and 32 MB per call. Results come back in the chat: images as PNG/GIF, the `.tres` and atlas `.json` as text. They run on Voidless's server: the hosted connector serves them, and the npm package forwards them there with your key (so they need a connection).
+The same tools as [voidless.dev/tools](https://voidless.dev/tools), for any image, not just your library. Inputs are image URLs (a `cdn.voidless.dev` link from `get_asset` or a saved result works), image keys from your library (`assets/…png`, as `get_asset` lists them), or base64/data URIs, PNG or GIF, up to 2048x2048, 256 frames and 32 MB per call. Results come back in the chat: images as PNG/GIF, the `.tres` and atlas `.json` as text.
+
+Results can also be saved to your library (free, private, counts toward your storage), which gives them an asset id and `cdn.voidless.dev` URLs to pass to the next tool instead of base64 (for example `generate_vfx` → `palette_swap` → `add_outline` → `animate_sprite`). `generate_vfx` saves its effect by default (with its recipe, so it can be rendered again; `save: false` skips it); `palette_swap`, `add_outline`, `pack_sprite_sheet`, `slice_sprite_sheet` and `make_gif` save only when you pass `save: true`. They run on Voidless's server: the hosted connector serves them, and the npm package forwards them there with your key (so they need a connection).
 
 | Tool | What it does |
 | --- | --- |
@@ -142,7 +144,7 @@ Generation tools create new content in your library; none deletes or overwrites
 
 ## Privacy Policy
 
-This server sends your prompts, any images you pass in, and your API key to the Voidless API (api.voidless.dev) to run generations; results are stored in your Voidless account. The free tools send their inputs to mcp.voidless.dev, which processes them in memory and stores nothing; each call is logged against your account (tool, time taken, success, result size) for usage statistics. It collects nothing else and keeps no local data. See the [Voidless Privacy Policy](https://voidless.dev/privacy-policy) for how Voidless collects, uses, stores, shares and retains data, and the [Terms of Service](https://voidless.dev/terms-of-service).
+This server sends your prompts, any images you pass in, and your API key to the Voidless API (api.voidless.dev) to run generations; results are stored in your Voidless account. The free tools send their inputs to mcp.voidless.dev, which processes them in memory and stores nothing unless a result is saved to your library (`generate_vfx` by default, the others with `save: true`), where it is kept like any other asset of yours; each call is logged against your account (tool, time taken, success, result size) for usage statistics. It collects nothing else and keeps no local data. See the [Voidless Privacy Policy](https://voidless.dev/privacy-policy) for how Voidless collects, uses, stores, shares and retains data, and the [Terms of Service](https://voidless.dev/terms-of-service).
 
 ## Support
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "voidless-mcp",
   "mcpName": "dev.voidless/voidless",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "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

@@ -286,7 +286,8 @@ export function createVoidlessServer(API_KEY, transport = "stdio") {
     const content = [
       {
         type: "text",
-        text: [`${label} added to asset ${assetId} (${APP_URL}/asset/${assetId}).`, money(data)]
+        // note: e.g. an end frame of another size was scaled to the start image's.
+        text: [`${label} added to asset ${assetId} (${APP_URL}/asset/${assetId}).`, data.note, money(data)]
           .filter(Boolean)
           .join("\n"),
       },
@@ -425,8 +426,8 @@ export function createVoidlessServer(API_KEY, transport = "stdio") {
     .string()
     .default("")
     .describe(
-      "Work from one image of an existing frame instead of the asset's base: pass an image key exactly as " +
-        "get_asset lists it. Empty = the asset's current base image."
+      "Work from one image instead of the asset's base: an image key from any of your assets (as get_asset " +
+        "lists it), or its cdn.voidless.dev URL. Empty = the asset's current base image."
     );
   const frameId = z
     .number()
@@ -628,7 +629,7 @@ export function createVoidlessServer(API_KEY, transport = "stdio") {
     "get_asset",
     "Show one asset with every frame: frame ids, types (animation, rotations - 8-way, edit - text, layer…), " +
       "names, facings and image keys. Frame ids are what frameIndex/items/frameId take elsewhere; image keys " +
-      "are what referenceFile and end_frame take. Free.",
+      "are what referenceFile and end_frame take, on this asset or any other of yours. Free.",
     { id: assetId, preview: z.boolean().default(true).describe("Include the base image inline") },
     readTool("Get asset"),
     tool(async ({ id, preview }) => {
@@ -838,7 +839,7 @@ export function createVoidlessServer(API_KEY, transport = "stdio") {
       prompt: z.string().describe("What to change"),
       referenceFile,
       frameId,
-      images: z.array(z.string()).max(4).default([]).describe("Optional extra reference images: image keys from get_asset or https URLs"),
+      images: z.array(z.string()).max(4).default([]).describe("Optional extra reference images: image keys from any of your assets (get_asset lists them), or their cdn.voidless.dev URLs. Other links are refused: upload the picture first"),
       remove_bg: z.boolean().default(true).describe("Remove the background from the result, as the app's editor does. Set false for artwork or a scene that should keep its background"),
     },
     writeTool("Edit image"),
@@ -1043,7 +1044,11 @@ export function createVoidlessServer(API_KEY, transport = "stdio") {
       id: assetId,
       prompt: z.string().describe("The motion, e.g. 'walk cycle', 'swings sword overhead'"),
       referenceFile,
-      end_frame: z.string().default("").describe("Optional image key for the clip to end on (e.g. to loop back to a pose). Empty = free ending"),
+      end_frame: z.string().default("").describe(
+        "Optional image for the clip to end on: an image key from any of your assets (get_asset lists them), or its " +
+          "cdn.voidless.dev URL, e.g. the start image to loop, or another sprite's pose. Empty = free ending. An end " +
+          "image of another size is scaled to the start image's; one of a very different shape is refused (nothing charged)"
+      ),
       frameId,
     },
     writeTool("Animate sprite"),