@applaunchflow/mcp 0.1.0 → 0.1.2

package/build/index.js

@@ -17,7 +17,7 @@ import { registerVariantTools } from "./tools/variants.js";
 const SERVER_INSTRUCTIONS = `
 AppLaunchFlow MCP is screenshot-focused at this stage.
 Only use it for screenshot project setup, screenshot uploads, screenshot template generation, variants, and direct screenshot layout editing.
-Do not treat this MCP as an ASO, localization, graphics, or promo-video assistant.
+Do not treat this MCP as an ASO, localization, or graphics assistant.
 
 Use AppLaunchFlow MCP as an execution tool, not a questionnaire.
 

package/build/tools/layouts.js

@@ -109,13 +109,16 @@ export function registerLayoutTools(server, client) {
     server.registerTool("transform_layout", {
         title: "Transform Layout",
         description: "Apply transform operations to an existing layout. Primary editing tool for text, screenshots, colors, and structure changes. " +
+            "IMPORTANT: Always call get_layout FIRST to inspect the current layout state before using this tool. Never transform blindly. " +
             "RULES: " +
-            "1. nodeType is REQUIRED in every operation target. The backend rejects operations without it. " +
-            "2. Omit nodeId to update ALL nodes of that type in the target screens. This is the efficient way to do bulk changes (e.g. change all illustration colors: {nodeType:'illustration', screens:'all'} with changes {primaryColor:'#xxx'}). " +
+            "1. nodeType is REQUIRED in every operation target. " +
+            "2. Omit nodeId to update ALL nodes of that type in the target screens. " +
             "3. Use screens:'all' to target every screen at once. Do NOT send one operation per screen when the same change applies to all. " +
-            "4. For add_node, changes MUST include an 'id' field. " +
-            "5. To add new screens, first add empty screen containers, then populate them in a SECOND call using selector 'screenId:<id>'. " +
-            "6. Default to layouts:['mobile']. Only include tablet/desktop if the user asks.",
+            "4. Dot-notation is supported for deep updates without replacing the whole object. Example: {'richContent.attrs.defaultFontSize': 96} updates only the font size inside richContent.attrs, preserving all other fields. Always use dot-notation for nested property changes. " +
+            "5. For add_node, changes MUST include an 'id' field. " +
+            "6. To add new screens, first add empty screen containers, then populate them in a SECOND call using selector 'screenId:<id>'. " +
+            "7. Default to layouts:['mobile']. Only include tablet/desktop if the user asks. " +
+            "8. FONT SIZE: The rendered font size is controlled ONLY by 'richContent.attrs.defaultFontSize' (pixel value). To change font size, use dot-notation: {'richContent.attrs.defaultFontSize': 80}. Do NOT use 'fontSizeScale' — that property is for promo videos only and has NO effect on screenshot rendering.",
         inputSchema: {
             generationId: z.string().uuid(),
             language: z.string(),

package/build/tools/variants.js

@@ -1,3 +1,4 @@
+import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { fail, ok } from "./utils.js";
 const contentTypeEnum = z.enum(["screenshots"]);
@@ -26,9 +27,27 @@ export function registerVariantTools(server, client) {
             label: z.string().optional(),
             setActive: z.boolean().optional(),
         },
-    }, async (args) => {
+    }, async (args, extra) => {
         try {
-            return ok(await client.createVariant(args), "Created variant");
+            const result = await client.createVariant(args);
+            const variantId = result?.variant?.id;
+            const generationId = args.generationId;
+            if (variantId && generationId) {
+                const editorUrl = `${client.credentials.baseUrl}/editor?projectId=${generationId}&variantId=${variantId}&device=phone`;
+                try {
+                    await server.server.elicitInput({
+                        mode: "url",
+                        elicitationId: randomUUID(),
+                        message: "Opening the new variant in the editor.",
+                        url: editorUrl,
+                    }, { signal: extra.signal });
+                }
+                catch {
+                    // Client may not support URL elicitation — include URL in response
+                }
+                return ok({ ...result, editorUrl }, "Created variant");
+            }
+            return ok(result, "Created variant");
         }
         catch (error) {
             return fail(error);

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@applaunchflow/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for AppLaunchFlow — create App Store & Google Play screenshots with AI.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ynnickw/applaunchflow-mcp"
+  },
   "type": "module",
   "bin": {
     "applaunchflow-mcp": "./build/index.js"

package/build/tools/analysis.js

@@ -1,23 +0,0 @@
-import { z } from "zod";
-import { fail, ok } from "./utils.js";
-import { lookupStoreMetadata } from "./store-metadata.js";
-export function registerAnalysisTools(server, client) {
-    server.registerTool("analyze_app", {
-        title: "Analyze App",
-        description: "Analyze an App Store or Google Play URL and return app metadata",
-        inputSchema: {
-            app: z.string().min(1),
-            country: z.string().length(2).optional(),
-        },
-    }, async ({ app, country }) => {
-        try {
-            const data = await lookupStoreMetadata(client, app, country || "us");
-            return ok(data, data.provider === "google_play"
-                ? "Fetched Google Play metadata"
-                : "Fetched App Store metadata");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-}

package/build/tools/aso.js

@@ -1,84 +0,0 @@
-import { z } from "zod";
-import { fail, ok } from "./utils.js";
-export function registerAsoTools(server, client) {
-    server.registerTool("generate_aso_copy", {
-        title: "Generate ASO Copy",
-        description: "Generate ASO copy for a project",
-        inputSchema: {
-            generationId: z.string().uuid(),
-            variantId: z.string().uuid().optional(),
-            metadata: z.record(z.any()).optional(),
-            competitorAppIds: z.array(z.number()).optional(),
-        },
-    }, async (args) => {
-        try {
-            return ok(await client.generateAsoCopy(args), "Generated ASO copy");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-    server.registerTool("get_aso_copy", {
-        title: "Get ASO Copy",
-        description: "Get ASO copy for a project",
-        inputSchema: {
-            generationId: z.string().uuid(),
-            variantId: z.string().uuid().optional(),
-        },
-    }, async ({ generationId, variantId }) => {
-        try {
-            return ok(await client.getAsoCopy(generationId, variantId), "Fetched ASO copy");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-    server.registerTool("update_aso_copy", {
-        title: "Update ASO Copy",
-        description: "Persist edited ASO copy",
-        inputSchema: {
-            generationId: z.string().uuid(),
-            variantId: z.string().uuid().optional(),
-            asoCopy: z.record(z.any()),
-        },
-    }, async (args) => {
-        try {
-            return ok(await client.updateAsoCopy(args), "Updated ASO copy");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-    server.registerTool("translate_aso_copy", {
-        title: "Translate ASO Copy",
-        description: "Translate ASO copy into target languages",
-        inputSchema: {
-            generationId: z.string().uuid(),
-            variantId: z.string().uuid().optional(),
-            targetLanguages: z.array(z.string()).min(1),
-        },
-    }, async (args) => {
-        try {
-            return ok(await client.translateAsoCopy(args), "Translated ASO copy");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-    server.registerTool("suggest_competitors", {
-        title: "Suggest Competitors",
-        description: "Suggest competitor apps for ASO analysis",
-        inputSchema: {
-            appName: z.string(),
-            category: z.string(),
-            platform: z.enum(["ios", "android", "both"]).optional(),
-        },
-    }, async (args) => {
-        try {
-            return ok(await client.suggestCompetitors(args), "Fetched competitors");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-}

package/build/tools/graphics.js

@@ -1,69 +0,0 @@
-import { z } from "zod";
-import { fail, ok } from "./utils.js";
-export function registerGraphicsTools(server, client) {
-    server.registerTool("generate_graphics", {
-        title: "Generate Graphics",
-        description: "Generate social graphics suggestions for a project",
-        inputSchema: {
-            generationId: z.string().uuid(),
-            templateId: z.string(),
-        },
-    }, async (args) => {
-        try {
-            return ok(await client.generateGraphics(args), "Generated graphics");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-    server.registerTool("get_graphics", {
-        title: "Get Graphics",
-        description: "Get saved social graphics for a project",
-        inputSchema: {
-            projectId: z.string().uuid(),
-            variantId: z.string().uuid().optional(),
-        },
-    }, async ({ projectId, variantId }) => {
-        try {
-            return ok(await client.getGraphics(projectId, variantId), "Fetched graphics");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-    server.registerTool("save_graphics", {
-        title: "Save Graphics",
-        description: "Persist social graphics layouts for a project",
-        inputSchema: {
-            generationId: z.string().uuid(),
-            variantId: z.string().uuid().optional(),
-            socialTemplateId: z.string(),
-            socialPrimaryFormat: z.enum([
-                "og",
-                "x_post",
-                "play_store_feature",
-                "x_header",
-                "linkedin_banner",
-            ]),
-            graphics: z
-                .array(z.object({
-                format: z.enum([
-                    "og",
-                    "x_post",
-                    "play_store_feature",
-                    "x_header",
-                    "linkedin_banner",
-                ]),
-                layout: z.record(z.any()),
-            }))
-                .min(1),
-        },
-    }, async (args) => {
-        try {
-            return ok(await client.saveGraphics(args), "Saved graphics");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-}

package/build/tools/store-metadata.js

@@ -1,66 +0,0 @@
-export function extractAppStoreId(input) {
-    if (/^\d+$/.test(input)) {
-        return input;
-    }
-    const match = input.match(/id(\d+)/);
-    return match ? match[1] : null;
-}
-export async function fetchGooglePlayMetadata(urlString) {
-    const url = new URL(urlString);
-    const packageName = url.searchParams.get("id");
-    if (!packageName) {
-        throw new Error("Google Play URL must include an id query parameter");
-    }
-    const response = await fetch(url.toString(), {
-        headers: {
-            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
-            "Accept-Language": "en-US,en;q=0.9",
-        },
-    });
-    if (!response.ok) {
-        throw new Error(`Google Play request failed with status ${response.status}`);
-    }
-    const html = await response.text();
-    const scriptMatch = html.match(/<script type="application\/ld\+json">([\s\S]*?)<\/script>/);
-    if (!scriptMatch) {
-        throw new Error("Unable to parse Google Play metadata");
-    }
-    const payload = JSON.parse(scriptMatch[1]);
-    return {
-        provider: "google_play",
-        packageName,
-        appName: payload.name || null,
-        description: payload.description || null,
-        category: payload.applicationCategory || null,
-        iconUrl: payload.image || null,
-        rating: payload.aggregateRating?.ratingValue || null,
-        ratingCount: payload.aggregateRating?.ratingCount || null,
-        url: url.toString(),
-    };
-}
-export async function lookupStoreMetadata(client, app, country = "us") {
-    if (app.includes("play.google.com")) {
-        return fetchGooglePlayMetadata(app);
-    }
-    const appId = extractAppStoreId(app);
-    if (!appId) {
-        throw new Error("Provide an App Store URL, Google Play URL, or App Store numeric id");
-    }
-    const lookup = await client.lookupAppStore(appId, country);
-    const appResult = lookup.results?.[0];
-    if (!appResult) {
-        throw new Error("App Store app not found");
-    }
-    return {
-        provider: "apple",
-        appleAppId: appId,
-        appName: appResult.trackName || null,
-        description: appResult.description || null,
-        iconUrl: appResult.artworkUrl512 || appResult.artworkUrl100 || null,
-        category: appResult.primaryGenreName || null,
-        screenshotUrls: appResult.screenshotUrls || [],
-        averageUserRating: appResult.averageUserRating || null,
-        userRatingCount: appResult.userRatingCount || null,
-        appStoreUrl: appResult.trackViewUrl || null,
-    };
-}