@appscreenshotstudio/mcp 0.1.4 → 0.1.5

package/README.md

@@ -59,7 +59,7 @@ Create a complete set of App Store screenshots. One tool call = one full project
 | `count` | number | No | Number of cards, 3-10 (default: 5) |
 | `story_flow` | string | No | Narrative structure (default: `auto`) |
 
-**Costs 1 credit.**
+**Costs 5 credits.**
 
 ### `edit-screenshots`
 
@@ -71,7 +71,7 @@ Make changes to an existing project with natural language. Optionally target spe
 | `message` | string | Yes | What to change |
 | `card_indices` | number[] | No | Target specific cards by index (0-based). Omit to edit all. |
 
-**Costs 1 credit.**
+**Costs 5 credits.**
 
 ### `render-screenshots`
 
@@ -103,7 +103,7 @@ Generate an AI background for a specific card. Uses project metadata (brand colo
 | `card_index` | number | Yes | Which card (0-based) |
 | `prompt` | string | Yes | Description of the background |
 
-**Costs 1 credit.**
+**Costs 6 credits.**
 
 ### `list-devices`
 
@@ -120,6 +120,17 @@ Show all supported device specs. No API call needed.
 | `android-phone` | Android Phone | 1080x2340 | Play Store |
 | `android-tablet-10` | Android Tablet 10" | 2560x1600 | Play Store |
 
+## Design Features
+
+The AI generates professional screenshots using:
+
+- **78+ decorative shapes** across 13 categories: nature (leaf, flower, tree), weather (cloud, sun, snowflake), celebration (sparkle, trophy, crown, confetti), social (chat-bubble, music-note), tech (rocket, code-bracket), health (dumbbell, flame), food (coffee-cup, pizza), travel (airplane, compass), finance (dollar-sign, piggy-bank), education (graduation-cap, lightbulb), pets (paw-print, cat-face), emoji (smiley, fire-emoji), abstract (swirl, infinity, gem)
+- **Rich text**: per-word color, bold, italic, underline, highlight pills (colored backgrounds behind words), gradient fills, text stroke outlines, emoji
+- **Laurel stats**: wing-left + wing-right shapes flanking stats like "4.9 Rating" or "1M+ Users"
+- **Floating UI snippets**: rounded-rect panels with text overlapping device edges
+- **11 device perspectives**: flat, left-15, left-30, right-15, right-30, isometric, top-down, flat-lay, side-profile, landscape-left, landscape-right
+- **7 layouts**: Text Top + Device Center (A), Text Top + Device Offset (B), Social Proof (C), Marketing Title (M1), Feature Callout (M2), CTA (M3), Testimonial (M4)
+
 ## Workflow
 
 1. **Generate** — Agent calls `generate-screenshots` with your app details

package/dist/index.js

@@ -89,13 +89,19 @@ Available layouts per card:
 Card types the system can generate:
 - Hero card (value proposition + device)
 - Feature spotlight (tilted phone + floating UI snippets)
-- Social proof (stars, quotes, badges)
+- Social proof (stars, quotes, badges, laurel wings with stats)
 - Marketing/title card (no device, bold text + rich background)
 - CTA/download card (no device, call to action)
 
+Design features:
+- 78+ decorative shapes across 13 categories (nature, weather, celebration, social, tech, health, food, travel, abstract, finance, education, pets, emoji)
+- Rich text with per-word color, weight, italic, underline, highlight pills, gradient fills, stroke outlines, and emoji
+- Laurel stats pattern: wing-left + wing-right shapes flanking stats like "4.9 Rating" or "1M+ Users"
+- Floating UI snippets: rounded-rect panels with text overlapping the device edges
+
 App Store 60/40 rule: minimum 60% of cards must show a device mockup, maximum 40% can be marketing-only.
 
-Costs 1 credit per generation.`,
+Costs 5 credits per generation.`,
     inputSchema: z.object({
         app_name: z.string().describe('Name of the app'),
         app_description: z.string().describe('What the app does — 1-3 sentences'),
@@ -170,16 +176,19 @@ Costs 1 credit per generation.`,
 // Tool 2: edit-screenshots
 server.registerTool('edit-screenshots', {
     title: 'Edit Screenshot Designs',
-    description: `Make changes to an existing screenshot project. Use natural language to describe what you want to change. Costs 1 credit per edit.
+    description: `Make changes to an existing screenshot project. Use natural language to describe what you want to change. Costs 5 credits per edit.
 
 What you can change:
 - Text: headlines, subtitles, badge text, font size, font family (Inter, Poppins, Montserrat, DM Sans, Space Grotesk, etc.)
+- Text styling: per-word color, bold, italic, underline, highlight pills (colored background behind words), gradient text, text stroke outlines
 - Colors: brand palette, gradient backgrounds, accent colors, text colors
 - Layout: reposition elements, switch between layouts (A/B/C/M1-M4), change device tilt
 - Device mockups: perspective tilts (flat, left-15, right-15), resize, reposition
 - Add/remove cards: add a social proof card, remove card 3, add a marketing title card
 - Floating elements: add/edit badges, star ratings, floating UI snippets (rounded-rect + text overlays)
 - Shapes: glow orbs, waves, blobs, rounded rectangles, circles, custom SVG paths
+- Decorative shapes: 78+ library shapes — leaf, flower, cloud, sparkle, heart, rocket, trophy, crown, coffee-cup, airplane, dollar-sign, paw-print, and many more across 13 categories
+- Laurel stats: wing-left + wing-right shapes flanking a stat (e.g. "4.9 Rating", "1M+ Users", "#1 App")
 - Backgrounds: change gradient colors/angle, set a backgroundPrompt for AI-generated backgrounds
 - Style: shadows, opacity, border radius, rotation, blur
 
@@ -190,7 +199,10 @@ Example edit messages:
 - "Tilt the phone on card 2 to the left"
 - "Add floating UI snippets around the device on card 1"
 - "Replace card 3 with a marketing CTA card saying Download Free"
-- "Add a wave shape flowing across all cards"`,
+- "Add a wave shape flowing across all cards"
+- "Add laurel wings around a 4.9 rating on card 1"
+- "Add decorative leaf and sparkle shapes scattered in the background"
+- "Make 'Every' underlined and italic in the headline"`,
     inputSchema: z.object({
         project_id: z.string().describe('Project ID from a previous generate-screenshots call'),
         message: z.string().describe('What to change — use natural language'),
@@ -281,9 +293,9 @@ server.registerTool('get-project', {
 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 highlights)
-- Device mockups: perspectiveVariant (flat, left-15, right-15), screenshotImage (null if no upload)
-- Shapes: shapeType (circle, rectangle, rounded-rect, blob, wave, etc.), fill, opacity
+- 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, flat-lay, side-profile, landscape-left, landscape-right), screenshotImage (null if no upload)
+- Shapes: 78+ shape types 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({
         project_id: z.string().describe('Project ID to inspect'),
@@ -328,7 +340,7 @@ Returns the canvas state with:
 // Tool 6: generate-background
 server.registerTool('generate-background', {
     title: 'Generate AI Background',
-    description: `Generate an AI background image for a specific card using Gemini. The background is generated based on a text prompt and applied directly to the card. Costs 1 credit.
+    description: `Generate an AI background image for a specific card using Gemini. The background is generated based on a text prompt and applied directly to the card. Costs 6 credits.
 
 Good prompts describe mood, lighting, and color — not objects or text:
 - "Deep purple nebula with soft pink and blue light rays"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appscreenshotstudio/mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "MCP server for generating App Store screenshots via AppScreenshotStudio",
   "type": "module",
   "license": "MIT",