@appscreenshotstudio/mcp 0.8.2 → 0.8.4

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 AppScreenshotStudio
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 AppScreenshotStudio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -348,8 +348,15 @@ Costs 5 credits per generation.`,
                     hasScreens
                         ? '1. Your attached screenshots were placed into the device frames (upload-screenshots can swap any card later)'
                         : '1. Use upload-screenshots to add your app screenshots into the device frames',
-                    '2. Use render-screenshots to export final PNGs',
-                    '3. Or open the project URL in a browser to preview and adjust',
+                    // edit-screenshots was missing from this list until 2026-09-14, and the
+                    // omission has a measurable cost: with no in-band pointer to the refine
+                    // path, the cheapest visible way to change a design is to call generate
+                    // again, which bills 5 credits and starts a NEW project every time. User
+                    // 5b0a496d called generate 4x and edit 0x on one brief, spending 20 of 25
+                    // trial credits on four near-identical projects.
+                    '2. Use edit-screenshots to refine THIS project (change copy, colours, layout). Prefer it over calling generate again: generate always starts a new project and re-bills.',
+                    '3. Use render-screenshots to export final PNGs (needs a paid plan; trials can build and iterate but not export)',
+                    '4. Or open the project URL in a browser to preview and adjust',
                     '',
                     imageErrors.length ? `Image read warnings:\n${imageErrors.join('\n')}` : '',
                     chatData.suggestions?.length
@@ -493,12 +500,18 @@ server.registerTool('render-screenshots', {
         idempotentHint: true,
         openWorldHint: false,
     },
-    description: 'Export a screenshot project to high-resolution PNG files at exact App Store dimensions. Returns download URLs for each card; URLs stay valid for 7 days, so save the PNGs to disk promptly (re-rendering is free if a URL has expired). Free (no credit cost). Rendering blocks until the PNGs are ready: expect roughly 20-40s for iPhone sets and 60-120s for iPad (the larger canvas renders slower), so allow up to ~2 minutes before treating it as failed. Note: device mockups will show empty frames unless app screenshots have been uploaded via upload-screenshots first.',
+    description: 'Export a screenshot project to high-resolution PNG files at exact App Store dimensions. Returns download URLs for each card; URLs stay valid for 7 days, so save the PNGs to disk promptly (re-rendering is free if a URL has expired). Costs no credits, but export is unlocked by the first payment: on a trial this returns 402 PAYMENT_REQUIRED, so check the plan before promising a user their PNGs. Pass device_ids to get the same canvas at several device sizes in one call, re-laid-out for each, instead of building a second project: an App Store submission wants the 6.9-inch iPhone and, when the app supports iPad, the 13-inch iPad, and Google Play is a separate listing. Rendering blocks until the PNGs are ready: expect roughly 20-40s per iPhone set and 60-120s per iPad set (the larger canvas renders slower), and those add up per device, so allow up to ~2 minutes each before treating it as failed. Note: device mockups will show empty frames unless app screenshots have been uploaded via upload-screenshots first.',
     inputSchema: z.object({
         project_id: z.string().describe('Project ID to render'),
+        device_ids: z
+            .array(z.string())
+            .min(1)
+            .max(4)
+            .optional()
+            .describe('Optional. Render the same canvas at these device sizes instead of the project device. Each id is a full render, so up to 4. Use list-devices for valid ids.'),
     }),
-}, async ({ project_id }) => {
-    const res = await apiCall('POST', `/api/v1/projects/${project_id}/render`);
+}, async ({ project_id, device_ids }) => {
+    const res = await apiCall('POST', `/api/v1/projects/${project_id}/render`, device_ids?.length ? { device_ids } : undefined);
     if (!res.ok) {
         return {
             content: [{ type: 'text', text: `Render failed: ${JSON.stringify(res.data)}` }],
@@ -506,14 +519,20 @@ server.registerTool('render-screenshots', {
     }
     const data = res.data.data;
     const images = data.images || [];
+    // With more than one device in the response, "Card 1" appears once per set,
+    // so the device has to be on the line or the URLs cannot be told apart.
+    const deviceCount = new Set(images.map((img) => img.device_id).filter(Boolean)).size;
+    const label = (img, i) => deviceCount > 1 && img.device_id
+        ? `${img.device_id} card ${(img.card_index ?? i) + 1}`
+        : `Card ${i + 1}`;
     // Text block: full-resolution download URLs (for export / saving to disk).
     const content = [
         {
             type: 'text',
             text: [
-                `Rendered ${images.length} screenshot${images.length === 1 ? '' : 's'}:`,
+                `Rendered ${images.length} screenshot${images.length === 1 ? '' : 's'}${deviceCount > 1 ? ` across ${deviceCount} device sizes` : ''}:`,
                 '',
-                ...images.map((img, i) => `Card ${i + 1}: ${img.url} (${img.width}×${img.height})`),
+                ...images.map((img, i) => `${label(img, i)}: ${img.url} (${img.width}×${img.height})`),
                 '',
                 'Download URLs are valid for 7 days. Save the PNGs to disk now if you',
                 'need them long-term (re-rendering later is free).',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appscreenshotstudio/mcp",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "mcpName": "com.appscreenshotstudio/mcp",
   "description": "MCP server for generating App Store screenshots via AppScreenshotStudio",
   "type": "module",