@atomixstudio/mcp 1.0.19 → 1.0.21

package/README.md

@@ -65,7 +65,9 @@ Once connected, the AI can call these tools:
 | `exportMCPConfig(tool)` | Get MCP configuration for different tools |
 | `getSetupInstructions(tool)` | Get detailed setup guide |
 | `getDependencies(platform?, stack?)` | Get suggested dependencies (icons, fonts, SKILL.md, token files). Optional: `platform` (web, ios, android), `stack` (e.g. react, vue, next). Use with **/--get-started** prompt. |
-| `syncToFigma()` | Push design system to Figma (variables, paint styles, text styles, effect styles). Uses built-in bridge + Atomix plugin. If the plugin is not connected, the response includes `agentInstruction` to connect. |
+| `syncToFigma()` | Push design system to Figma (variables, paint styles, text styles, effect styles). Uses built-in bridge + Atomix plugin. If the plugin is not connected, the response includes `agentInstruction` to connect. **Available on all tiers (Free and Pro).** |
+
+Other Figma tools (getFigmaVariablesAndStyles, createDesignPlaceholder, resolveFigmaIdsForTokens, designCreateFrame, designCreateText, etc.) are **Pro only** — they appear when the design system owner has a Pro subscription.
 
 ### getDependencies
 
@@ -101,8 +103,8 @@ Run these prompts from your AI tool (e.g. **/--hello**, **/--get-started**):
 | **/--rules** | Governance rules for your AI tool (Cursor, Copilot, Windsurf, etc.). |
 | **/--sync** | Sync tokens, AI rules, skills files, and dependencies manifest (icons, fonts). Use **/--refactor** to migrate deprecated tokens. |
 | **/--refactor** | Migrate deprecated tokens in codebase. Run after **/--sync**. |
-| **/--sync-to-figma** | Push design system to Figma. Requires bridge + Atomix plugin; see [Sync to Figma](#sync-to-figma) below. |
-| **/--design-in-figma** | Design UI in Figma: **3 passes** (wireframe → tokens/rules → audit), **getDesignScreenshot** after each pass, then **finalizeDesignFrame** (rename + ✅, remove placeholder) and summarise. No code generation. |
+| **/--sync-to-figma** | Push design system to Figma. Requires bridge + Atomix plugin; see [Sync to Figma](#sync-to-figma) below. **Available on all tiers (Free and Pro).** |
+| **/--design-in-figma** | Design UI in Figma: **3 passes** (wireframe → tokens/rules → audit), **getDesignScreenshot** after each pass, then **finalizeDesignFrame** (rename + ✅, remove placeholder) and summarise. No code generation. **Pro only.** |
 
 ## --get-started (get started)
 
@@ -123,6 +125,8 @@ The **/--get-started** prompt suggests dependencies for your design system so yo
 
 **/--sync-to-figma** (or the **syncToFigma** tool) pushes your design system into the open Figma file: color variables, paint styles, number variables (spacing, radius, borders, sizing, breakpoints), text styles, and shadow effect styles. The **Figma bridge runs inside this MCP server** (no separate process). You only need the Atomix Figma plugin and "Connect to Cursor" (no Figma REST API or token).
 
+**Tier:** Sync to Figma is available on **all tiers** (Free and Pro). The design-in-Figma prompt and design tools (getFigmaVariablesAndStyles, createDesignPlaceholder, resolveFigmaIdsForTokens, designCreateFrame, etc.) require a **Pro** subscription for the design system owner.
+
 **Flow:**
 
 1. **Plugin not connected?** The tool checks first. If the plugin is not connected, the response includes `bridgeNotRunning`, `agentInstruction`, and `userInstruction`. Ensure Cursor has this MCP server running, then in Figma run the Atomix plugin and click **Connect to Cursor**, then call **syncToFigma** again.

package/dist/index.js

@@ -1291,6 +1291,8 @@ function getTokenStats(data) {
 // src/index.ts
 import * as path2 from "path";
 import * as fs2 from "fs";
+import { execSync } from "child_process";
+import { platform } from "os";
 import WebSocket, { WebSocketServer } from "ws";
 var FIGMA_BRIDGE_PORT = Number(process.env.FIGMA_BRIDGE_PORT) || 8765;
 var FIGMA_BRIDGE_HOST = process.env.FIGMA_BRIDGE_HOST || "127.0.0.1";
@@ -1304,9 +1306,46 @@ var FIGMA_CONNECTION_INSTRUCTIONS = {
 var bridgeWss = null;
 var pluginWs = null;
 var pendingBridgeRequests = /* @__PURE__ */ new Map();
+function ensureFigmaBridgePortFree(port) {
+  const portStr = String(port);
+  const ourPid = String(process.pid);
+  try {
+    if (platform() === "win32") {
+      const out = execSync(`netstat -ano`, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] });
+      const pids = /* @__PURE__ */ new Set();
+      for (const line of out.split(/\r?\n/)) {
+        if (line.includes(`:${portStr}`) && line.includes("LISTENING")) {
+          const parts = line.trim().split(/\s+/);
+          const pid = parts[parts.length - 1];
+          if (/^\d+$/.test(pid) && pid !== ourPid) pids.add(pid);
+        }
+      }
+      for (const pid of pids) {
+        try {
+          execSync(`taskkill /PID ${pid} /F`, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] });
+          console.error(`[atomix-mcp] Freed Figma bridge port ${port} (killed PID ${pid})`);
+        } catch (_) {
+        }
+      }
+    } else {
+      const out = execSync(`lsof -ti :${portStr}`, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+      if (!out) return;
+      const pids = out.split(/\s+/).filter((p) => p && p !== ourPid);
+      for (const pid of pids) {
+        try {
+          execSync(`kill -9 ${pid}`, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] });
+          console.error(`[atomix-mcp] Freed Figma bridge port ${port} (killed PID ${pid})`);
+        } catch (_) {
+        }
+      }
+    }
+  } catch {
+  }
+}
 function startFigmaBridge() {
   if (bridgeWss) return;
   try {
+    ensureFigmaBridgePortFree(FIGMA_BRIDGE_PORT);
     bridgeWss = new WebSocketServer({
       host: FIGMA_BRIDGE_HOST,
       port: FIGMA_BRIDGE_PORT,
@@ -1771,8 +1810,8 @@ function hasValidAuthConfig() {
 }
 var AUTH_REQUIRED_MESSAGE = "Atomix MCP requires authentication. Add both --ds-id and --atomix-token to your MCP config (Settings \u2192 MCP), then restart Cursor. Get your token from Atomix Studio: Export modal or Settings \u2192 Regenerate Atomix access token.";
 var lastChangeSummary = null;
-var FIGMA_TOOL_NAMES = /* @__PURE__ */ new Set([
-  "syncToFigma",
+var FIGMA_SYNC_TOOL_NAME = "syncToFigma";
+var FIGMA_DESIGN_TOOL_NAMES = /* @__PURE__ */ new Set([
   "getFigmaVariablesAndStyles",
   "createDesignPlaceholder",
   "resolveFigmaIdsForTokens",
@@ -1785,6 +1824,7 @@ var FIGMA_TOOL_NAMES = /* @__PURE__ */ new Set([
   "getDesignScreenshot",
   "finalizeDesignFrame"
 ]);
+var FIGMA_TOOL_NAMES = /* @__PURE__ */ new Set([FIGMA_SYNC_TOOL_NAME, ...FIGMA_DESIGN_TOOL_NAMES]);
 var lastSyncAffectedTokens = null;
 function getLastChangeSummary() {
   return lastChangeSummary;
@@ -1821,7 +1861,7 @@ var TOKEN_CATEGORIES = ["colors", "typography", "spacing", "sizing", "shadows",
 var server = new Server(
   {
     name: "atomix-mcp-user",
-    version: "1.0.19"
+    version: "1.0.21"
   },
   {
     capabilities: {
@@ -1844,7 +1884,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         console.error("[Atomix MCP] Resolved tier = pro. Figma sync/design tools are available.");
       } else if (cachedMcpTier === "free") {
         console.error(
-          "[Atomix MCP] Resolved tier = free. Figma sync/design tools are hidden. Pro tools appear when the DS owner has Pro and the pro_figma_export flag is enabled."
+          "[Atomix MCP] Resolved tier = free. Figma design tools and --design-in-figma are hidden. syncToFigma and /--sync-to-figma are available. Pro design tools appear when the DS owner has Pro and the pro_figma_export flag is enabled."
         );
       }
     } catch (err) {
@@ -2173,7 +2213,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       }
     }
   ];
-  const tools = cachedMcpTier === "pro" ? toolsList : toolsList.filter((t) => !FIGMA_TOOL_NAMES.has(t.name));
+  const tools = cachedMcpTier === "pro" ? toolsList : toolsList.filter((t) => !FIGMA_DESIGN_TOOL_NAMES.has(t.name));
   return { tools };
 });
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -2190,12 +2230,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   try {
     const shouldForceRefresh = name === "syncAll";
     const data = await fetchDesignSystemForMCP(shouldForceRefresh);
-    if (FIGMA_TOOL_NAMES.has(name) && cachedMcpTier !== "pro") {
+    if (FIGMA_DESIGN_TOOL_NAMES.has(name) && cachedMcpTier !== "pro") {
       return {
         content: [
           {
             type: "text",
-            text: "This design system does not have Pro Figma access. Figma sync and design tools are available when the design system owner has a Pro subscription."
+            text: "This design system does not have Pro Figma access. Figma design tools (design-in-Figma, createDesignPlaceholder, resolveFigmaIdsForTokens, etc.) are available when the design system owner has a Pro subscription. Sync to Figma (syncToFigma) is available on all tiers."
           }
         ],
         isError: true
@@ -2755,7 +2795,7 @@ ${tokenResponseText}` : summary;
         };
       }
       case "getDependencies": {
-        const platform = args?.platform;
+        const platform2 = args?.platform;
         const stack = args?.stack;
         const tokens = data.tokens;
         const typography = tokens?.typography;
@@ -2799,14 +2839,14 @@ ${tokenResponseText}` : summary;
             files: ["tokens.css", "tokens.json"],
             copyInstructions: "Call the syncAll MCP tool to create the token file, skills, and atomix-dependencies.json; do not only suggest the user run sync later."
           },
-          showcase: platform === "web" || !platform ? {
+          showcase: platform2 === "web" || !platform2 ? {
             path: "atomix-setup-showcase.html",
             template: SHOWCASE_HTML_TEMPLATE,
             substitutionInstructions: "Replace placeholders with values from the synced token file. MCP/sync/export use the --atmx- prefix. {{TOKENS_CSS_PATH}} = path to the synced token file (e.g. ./tokens.css, same as syncAll output). {{DS_NAME}} = design system name. {{BRAND_PRIMARY_VAR}} = var(--atmx-color-brand-primary). {{BRAND_PRIMARY_FOREGROUND_VAR}} = var(--atmx-color-brand-primary-foreground). {{HEADING_FONT_VAR}} = var(--atmx-typography-font-family-heading) or var(--atmx-typography-font-family-display). {{FONT_FAMILY_VAR}} = var(--atmx-typography-font-family-body). {{FONT_LINK_TAG}} = Google Fonts <link> for the font, or empty string. Do not invent CSS variable names; use only vars that exist in the export."
           } : void 0,
           meta: {
             dsName: data.meta.name,
-            platform: platform ?? void 0,
+            platform: platform2 ?? void 0,
             stack: stack ?? void 0,
             designSystemVersion: data.meta.version ?? "1.0.0",
             designSystemExportedAt: data.meta.exportedAt
@@ -3456,7 +3496,7 @@ Get your DS ID and token from the Export modal or Settings \u2192 Regenerate Ato
   }
   throw new Error(`Unknown resource: ${uri}`);
 });
-var FIGMA_PROMPT_NAMES = /* @__PURE__ */ new Set(["--sync-to-figma", "--design-in-figma"]);
+var FIGMA_DESIGN_PROMPT_NAMES = /* @__PURE__ */ new Set(["--design-in-figma"]);
 server.setRequestHandler(ListPromptsRequestSchema, async () => {
   if (!hasValidAuthConfig()) {
     authFailedNoTools = true;
@@ -3481,7 +3521,7 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => {
     { name: "--sync-to-figma", description: "Push this design system to Figma (variables, color + typography styles). Uses local bridge + plugin; no Figma token." },
     { name: "--design-in-figma", description: "Design UI in Figma: 3 passes (wireframe \u2192 tokens/rules \u2192 audit), getDesignScreenshot after each pass, then finalizeDesignFrame (rename + \u2705, remove placeholder) and summarise." }
   ];
-  const prompts = cachedMcpTier === "pro" ? allPrompts : allPrompts.filter((p) => !FIGMA_PROMPT_NAMES.has(p.name));
+  const prompts = cachedMcpTier === "pro" ? allPrompts : allPrompts.filter((p) => !FIGMA_DESIGN_PROMPT_NAMES.has(p.name));
   return { prompts };
 });
 server.setRequestHandler(GetPromptRequestSchema, async (request) => {
@@ -3583,7 +3623,7 @@ Both are required. Configure the MCP server in your Cursor settings, then restar
     }
     throw error;
   }
-  if (FIGMA_PROMPT_NAMES.has(name) && cachedMcpTier !== "pro") {
+  if (FIGMA_DESIGN_PROMPT_NAMES.has(name) && cachedMcpTier !== "pro") {
     return {
       description: "Pro Figma required",
       messages: [
@@ -3591,7 +3631,7 @@ Both are required. Configure the MCP server in your Cursor settings, then restar
           role: "user",
           content: {
             type: "text",
-            text: "This design system does not have Pro Figma access. Figma sync and design prompts are available when the design system owner has a Pro subscription."
+            text: "This design system does not have Pro Figma access. The design-in-Figma prompt is available when the design system owner has a Pro subscription. Sync to Figma (/--sync-to-figma) is available on all tiers."
           }
         }
       ]