@appscreenshotstudio/mcp 0.5.1 → 0.5.3

package/README.md

@@ -219,6 +219,7 @@ The AI generates professional screenshots using:
 
 ## Links
 
+- [Screenshot API + MCP overview](https://appscreenshotstudio.com/api)
 - [Full docs](https://appscreenshotstudio.com/docs/mcp)
 - [REST API reference](https://appscreenshotstudio.com/docs/api)
 - [Pricing](https://appscreenshotstudio.com/pricing)

package/dist/index.js

@@ -154,7 +154,7 @@ function buildDesignMessage(input) {
 // ─── MCP Server ─────────────────────────────────────────────────────────────────
 const server = new McpServer({
     name: 'appscreenshotstudio',
-    version: '0.4.4',
+    version: '0.5.2',
 });
 // Tool 1: generate-screenshots
 server.registerTool('generate-screenshots', {
@@ -312,7 +312,7 @@ What you can change:
 - Frame color: recolor the device frame — "natural" (default), "black", "white", "gold". Examples: "make the iPhone gold", "black titanium finish", "white iPhone". Requires Growth plan or higher.
 - Switch devices: "make this for Apple Watch" / "duplicate for Android tablet" clones the project at the target device's canvas size
 - Add/remove cards: add a social proof card, remove card 3, add a marketing title card
-- Compound fields (auto-positioned): statRow, laurelStat, pressBanner, starRating, quote, featureGrid, beforeAfterSplit
+- Compound fields (auto-positioned): statRow, laurelStat, pressBanner, starRating, quote, featureGrid, beforeAfterSplit, stepList
 - Panoramic backgrounds: one wide AI or Pexels image sliced across multiple cards ("pano the background across cards 1-3"). The edit only tags the cards; call generate-panoramic-background afterwards to create and slice the wide image.
 - Panoramic element spans: stretch a foreground image, device-mockup, or shape across adjacent cards ("pano the device across cards 1-2")
 - Floating elements: add/edit badges, star ratings
@@ -409,7 +409,7 @@ Example edit messages:
 // Tool 3: render-screenshots
 server.registerTool('render-screenshots', {
     title: 'Render Screenshots to PNG',
-    description: 'Export a screenshot project to high-resolution PNG files at exact App Store dimensions. Returns download URLs for each card. 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). 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.',
     inputSchema: z.object({
         project_id: z.string().describe('Project ID to render'),
     }),
@@ -431,6 +431,9 @@ server.registerTool('render-screenshots', {
                 '',
                 ...images.map((img, i) => `Card ${i + 1}: ${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).',
+                '',
                 'Previews are shown below. To compare all cards side by side at full size,',
                 'refine by hand, or export, open the project URL in the builder.',
             ].join('\n'),
@@ -480,7 +483,7 @@ Returns the canvas state with:
 - cards[]: each card has an id, elements array, and optional background settings
 - Each element has: type (text, device-mockup, shape, badge, image, star-rating), position (x, y), size (width, height), zIndex, and type-specific properties
 - Text elements: fontFamily, fontSize, fontWeight, color, segments (for multi-color text with per-word color, bold, italic, underline, highlightColor)
-- Device mockups: perspectiveVariant (flat, left-15, right-15, left-30, right-30, isometric, top-down, landscape-left, landscape-right), screenshotImage (null if no upload)
+- Device mockups: perspectiveVariant (flat, left-15, right-15, left-30, right-30, isometric, top-down, landscape-left, landscape-right), screenshotImage (null if no upload), frameStyle (realistic | none), showIsland (false hides the Dynamic Island pill; Apple accepts screenshots either way)
 - Shapes: 94 shape types (17 core + 77 decorative across 13 categories) — core shapes (circle, rectangle, rounded-rect, blob, wave, triangle, diamond, hexagon, ring, star, wing-left, wing-right, etc.) plus decorative library shapes (leaf, flower, cloud, sparkle, heart, rocket, trophy, crown, coffee-cup, airplane, dollar-sign, paw-print, and many more)
 - projectMeta: globalVisualTheme, brandColors, mood, appCategory`,
     inputSchema: z.object({
@@ -810,7 +813,7 @@ This tool helps you gather the right information so generate-screenshots produce
     if (platform === 'android' || platform === 'both') {
         deviceTips.push('**Android (required for Play Store):**');
         deviceTips.push('- Android Phone (android-phone): 1080×2340 — REQUIRED');
-        deviceTips.push('- Android Tablet 7" (android-tablet-10): 1200×1920 — optional');
+        deviceTips.push('- Android Tablet 7" (android-tablet-10): 1200×1920 — REQUIRED');
         deviceTips.push('');
     }
     // Schema reminder

package/package.json

@@ -1,13 +1,16 @@
-{
+{
   "name": "@appscreenshotstudio/mcp",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "MCP server for generating App Store screenshots via AppScreenshotStudio",
   "type": "module",
   "license": "MIT",
   "homepage": "https://appscreenshotstudio.com/docs/mcp",
   "repository": {
     "type": "git",
-    "url": "https://github.com/appscreenshotstudio/mcp-server"
+    "url": "https://github.com/TWWorks-org/mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/TWWorks-org/mcp-server/issues"
   },
   "keywords": [
     "mcp",

package/skills/appscreenshotstudio/SKILL.md

@@ -91,7 +91,7 @@ Hand off to the builder only when it genuinely helps: share the project URL and
 
 ### Step 6: Export
 
-`render-screenshots` is also the export: it returns download URLs for the final PNGs at exact App Store dimensions, and it is free. Give the user those URLs. The builder project URL is the alternative when they want to compare the full set visually or hand-tweak before downloading.
+`render-screenshots` is also the export: it returns download URLs for the final PNGs at exact App Store dimensions, and it is free. Give the user those URLs and note they stay valid for 7 days, so download promptly (re-rendering later is free if a URL has expired). The builder project URL is the alternative when they want to compare the full set visually or hand-tweak before downloading.
 
 ## Headline Rules