@atomixstudio/mcp 1.0.19 → 1.0.20

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,
@@ -2755,7 +2794,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 +2838,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