@applaunchflow/mcp 0.1.1 → 0.1.3

package/README.md

@@ -1,11 +1,26 @@
-# applaunchflow MCP
+# AppLaunchFlow MCP
 
-Local stdio MCP server for applaunchflow.
+MCP server for AppLaunchFlow — create App Store & Google Play screenshots with AI.
+
+## Setup
+
+Add to your MCP client config (e.g. Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "applaunchflow": {
+      "command": "npx",
+      "args": ["-y", "@applaunchflow/mcp@latest"]
+    }
+  }
+}
+```
 
 ## Auth
 
 ```bash
-pnpm --dir applaunchflow-mcp dev auth login --base-url http://localhost:3000
+npx -y @applaunchflow/mcp@latest auth login
 ```
 
 Credentials are stored in `~/.applaunchflow/credentials.json`.
@@ -16,11 +31,9 @@ Environment overrides:
 - `applaunchflow_MCP_TOKEN`
 - `applaunchflow_MCP_COOKIE_NAME`
 
-## Run
+## Development
 
 ```bash
-pnpm --dir applaunchflow-mcp build
-node applaunchflow-mcp/build/index.js
+pnpm install
+pnpm dev
 ```
-
-The server uses stdio transport and exposes tools/resources for project, screenshot, layout, template, variant, graphics, and ASO workflows.

package/build/client/api.js

@@ -34,7 +34,6 @@ export class AppLaunchFlowClient {
     buildHeaders(extraHeaders) {
         const headers = new Headers(extraHeaders);
         headers.set("Cookie", `${this.credentials.cookieName}=${this.credentials.token}`);
-        headers.set("Authorization", `Bearer ${this.credentials.token}`);
         return headers;
     }
     async requestJson(path, options = {}) {

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.
 
@@ -39,8 +39,8 @@ Preferred workflows:
 - When adding or editing elements, ensure text and screenshots do not overlap. Verify that positions place elements in distinct, non-conflicting areas of the canvas.
 - After composition-sensitive edits, inspect the returned translation or re-fetch the layout before reporting success. If elements overlap or are poorly positioned, fix them before telling the user the edit is done.
 - ALWAYS use browse_templates when a template choice is needed. Never offer templates via text bullet points or AskUserQuestion. The gallery opens in the browser and returns the user's selection automatically.
-- Use actual visual previews from the template tools/resources. Do not rely on adjective-heavy descriptions alone.
-- Keep the full template catalog available when the user is browsing templates. Only narrow to a small shortlist if the user explicitly asks for recommendations or fewer options.
+- When you need visual context about a screenshot (e.g. to extract colors, understand the app UI, or make context-specific edits), use view_screenshot to look at the actual image.
+- After generating a new variant, always include the editor URL in the reply so the user can open it directly.
 
 Translation and localization:
 - When the user asks to translate, localize, or create a version in another language, ALWAYS use translate_layouts. Do NOT manually edit text nodes via transform_layout for translation.

package/build/tools/layouts.js

@@ -117,7 +117,8 @@ export function registerLayoutTools(server, client) {
             "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.",
+            "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/screenshots.js

@@ -43,7 +43,27 @@ export function registerScreenshotTools(server, client) {
         },
     }, async (args) => {
         try {
-            return ok(await client.generateLayouts(args), "Generated layouts");
+            const result = await client.generateLayouts(args);
+            const generationId = args.generationId || args.projectId || "";
+            const variantId = result.variantId || "";
+            const editorUrl = `${client.credentials.baseUrl}/editor?projectId=${generationId}&variantId=${variantId}&device=phone`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            "Generated layouts successfully.",
+                            `Editor URL: ${editorUrl}`,
+                            "IMPORTANT: Paste this exact editor URL in the reply so the user can open it.",
+                        ].join("\n"),
+                    },
+                ],
+                structuredContent: {
+                    success: true,
+                    data: { ...result, editorUrl },
+                    message: "Generated layouts",
+                },
+            };
         }
         catch (error) {
             return fail(error);

package/build/tools/templates.js

@@ -291,40 +291,4 @@ export function registerTemplateTools(server, client, selectionCoordinator) {
             return fail(error);
         }
     });
-    server.registerTool("list_templates", {
-        title: "List Templates",
-        description: "List all AppLaunchFlow screenshot templates with visual preview resources. Prefer visual comparison over text-only descriptions.",
-        inputSchema: {
-            deviceType: z
-                .enum(TEMPLATE_PREVIEW_DEVICE_TYPES)
-                .optional()
-                .describe("Which preview device to attach for each template."),
-        },
-    }, async ({ deviceType = "phone" }) => {
-        try {
-            const payload = decorateTemplatePayload(await client.listTemplates(), client.credentials.baseUrl);
-            const galleryUrl = buildTemplateGalleryUrl(client.credentials.baseUrl, {
-                deviceType,
-            });
-            return buildListTemplatesResult(payload, deviceType, galleryUrl);
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
-    server.registerTool("get_template_details", {
-        title: "Get Template Details",
-        description: "Get details and visual preview resources for a single screenshot template.",
-        inputSchema: {
-            templateId: z.string(),
-        },
-    }, async ({ templateId }) => {
-        try {
-            const payload = decorateTemplatePayload(await client.getTemplate(templateId), client.credentials.baseUrl);
-            return buildTemplateDetailsResult(payload);
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
 }

package/build/tools/variants.js

@@ -53,20 +53,6 @@ export function registerVariantTools(server, client) {
             return fail(error);
         }
     });
-    server.registerTool("switch_variant", {
-        title: "Switch Variant",
-        description: "Set a variant as active",
-        inputSchema: {
-            variantId: z.string().uuid(),
-        },
-    }, async ({ variantId }) => {
-        try {
-            return ok(await client.switchVariant(variantId), "Switched variant");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
     server.registerTool("duplicate_variant", {
         title: "Duplicate Variant",
         description: "Duplicate an existing variant",
@@ -81,18 +67,4 @@ export function registerVariantTools(server, client) {
             return fail(error);
         }
     });
-    server.registerTool("delete_variant", {
-        title: "Delete Variant",
-        description: "Delete a content variant",
-        inputSchema: {
-            variantId: z.string().uuid(),
-        },
-    }, async ({ variantId }) => {
-        try {
-            return ok(await client.deleteVariant(variantId), "Deleted variant");
-        }
-        catch (error) {
-            return fail(error);
-        }
-    });
 }

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@applaunchflow/mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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,
-    };
-}