@appscreenshotstudio/mcp 0.8.1 → 0.8.3

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

@@ -32,6 +32,10 @@ const API_KEY = process.env.APPSCREENSHOTSTUDIO_API_KEY;
 //    mcp-server/skills/appscreenshotstudio/SKILL.md (ships in the npm package, so it drifts unseen),
 //    public/api-docs.md (served raw at /api-docs.md, linked from nowhere, so it drifts unseen too)
 //    Enforced by `npm run test:device-specs`, which reads all six files.
+// Hand-copied from lib/device-specs.ts because this package ships standalone.
+// `required` means required to PUBLISH, and it is emitted to agents as
+// "required for store submission", so a wrong flag here is a wrong instruction
+// rather than a cosmetic slip. Keep it in step with the source file.
 const DEVICES = [
     { id: 'iphone-6.9', name: 'iPhone 16 Pro Max', width: 1260, height: 2736, category: 'iphone', required: true },
     { id: 'iphone-6.3', name: 'iPhone 17 Pro', width: 1206, height: 2622, category: 'iphone', required: false },
@@ -39,7 +43,9 @@ const DEVICES = [
     { id: 'android-phone', name: 'Android Phone', width: 1080, height: 2340, category: 'android-phone', required: true },
     { id: 'pixel-11-pro', name: 'Google Pixel 11 Pro', width: 1280, height: 2856, category: 'android-phone', required: false },
     { id: 'galaxy-s26-ultra', name: 'Samsung Galaxy S26 Ultra', width: 1440, height: 3120, category: 'android-phone', required: false },
-    { id: 'android-tablet-10', name: 'Android Tablet 7"', width: 1200, height: 1920, category: 'android-tablet', required: true },
+    // Play Console requires 2 screenshots to publish; tablets are "can add", not
+    // "must provide". Was `true` until 2026-09-07. See lib/device-specs.ts.
+    { id: 'android-tablet-10', name: 'Android Tablet 7"', width: 1200, height: 1920, category: 'android-tablet', required: false },
     { id: 'android-tablet-large', name: 'Android Tablet 10"', width: 1600, height: 2560, category: 'android-tablet', required: false },
     { id: 'apple-watch-ultra', name: 'Apple Watch Ultra 2', width: 410, height: 502, category: 'apple-watch', required: true },
 ];
@@ -487,12 +493,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). Free (no credit cost). 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)}` }],
@@ -500,14 +512,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.1",
+  "version": "0.8.3",
   "mcpName": "com.appscreenshotstudio/mcp",
   "description": "MCP server for generating App Store screenshots via AppScreenshotStudio",
   "type": "module",