@applaunchflow/mcp 0.1.2 → 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

@@ -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/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,6 +1,6 @@
 {
   "name": "@applaunchflow/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "MCP server for AppLaunchFlow — create App Store & Google Play screenshots with AI.",
   "license": "MIT",
   "repository": {