figma-console-mcp 1.43.0 → 1.44.0

package/dist/local.d.ts

@@ -29,6 +29,9 @@ declare class LocalFigmaConsoleMCP {
     private wsReaperStop;
     /** Heartbeat timer that refreshes port file to prove this server is active */
     private wsHeartbeatTimer;
+    /** Optional Streamable HTTP endpoint (FIGMA_MCP_HTTP_PORT), shared by local clients. */
+    private httpEndpoint;
+    private httpStartupError;
     private config;
     private variablesCache;
     private auditDataCache;
@@ -40,6 +43,11 @@ declare class LocalFigmaConsoleMCP {
      */
     private invalidateVariablesCache;
     constructor();
+    /**
+     * A configured McpServer with no tools yet. stdio uses one for the whole
+     * run; the optional HTTP endpoint builds one per request (see http-transport.ts).
+     */
+    private createMcpServer;
     /**
      * Get or create Figma API client
      */
@@ -87,6 +95,11 @@ declare class LocalFigmaConsoleMCP {
      * Start the MCP server
      */
     start(): Promise<void>;
+    /**
+     * Serve MCP over Streamable HTTP as well, when FIGMA_MCP_HTTP_PORT is set.
+     * A failure here (bad value, port taken) is reported but never stops stdio.
+     */
+    private startHttpEndpoint;
     /**
      * Cleanup and shutdown
      */

package/dist/local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAoGH;;;GAGG;AACH,cAAM,oBAAoB;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,cAAc,CAA+C;IACrE,uGAAuG;IACvG,OAAO,CAAC,YAAY,CAAuB;IAC3C,6DAA6D;IAC7D,OAAO,CAAC,eAAe,CAA2B;IAClD,2EAA2E;IAC3E,OAAO,CAAC,YAAY,CAA6B;IACjD,8EAA8E;IAC9E,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,MAAM,CAAe;IAI7B,OAAO,CAAC,cAAc,CAMR;IAOd,OAAO,CAAC,cAAc,CAMR;IACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IAE3D;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;;IAsFhC;;OAEG;YACW,WAAW;IAoBzB;;;OAGG;YACW,mBAAmB;IAyBjC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAmBvB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAkD5B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;YACW,iBAAiB;IAiB/B,wDAAwD;IACxD,OAAO,CAAC,gBAAgB,CAAuB;IAE/C;;;OAGG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IA8yGrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoP5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B/B;AAyGD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAsGH;;;GAGG;AACH,cAAM,oBAAoB;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,cAAc,CAA+C;IACrE,uGAAuG;IACvG,OAAO,CAAC,YAAY,CAAuB;IAC3C,6DAA6D;IAC7D,OAAO,CAAC,eAAe,CAA2B;IAClD,2EAA2E;IAC3E,OAAO,CAAC,YAAY,CAA6B;IACjD,8EAA8E;IAC9E,OAAO,CAAC,gBAAgB,CAA+C;IACvE,wFAAwF;IACxF,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,MAAM,CAAe;IAI7B,OAAO,CAAC,cAAc,CAMR;IAOd,OAAO,CAAC,cAAc,CAMR;IACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IAE3D;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;;IAWhC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAgFvB;;OAEG;YACW,WAAW;IAoBzB;;;OAGG;YACW,mBAAmB;IAyBjC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAmBvB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAkD5B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;YACW,iBAAiB;IAiB/B,wDAAwD;IACxD,OAAO,CAAC,gBAAgB,CAAuB;IAE/C;;;OAGG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAozGrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsP5B;;;OAGG;YACW,iBAAiB;IAgC/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAmC/B;AAyGD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/local.js

@@ -40,7 +40,8 @@ import { wrapServerForIdentity } from "./core/identity.js";
 import { PACKAGE_ROOT } from "./core/resolve-package-root.js";
 import { FigmaWebSocketServer, getBundledPluginVersion, getServerVersion } from "./core/websocket-server.js";
 import { WebSocketConnector } from "./core/websocket-connector.js";
-import { DEFAULT_WS_PORT, getPortRange, advertisePort, unadvertisePort, registerPortCleanup, startPeriodicReaper, discoverActiveInstances, cleanupStalePortFiles, cleanupOrphanedProcesses, evictOldestInstance, refreshPortAdvertisement, noteToolCall, HEARTBEAT_INTERVAL_MS, } from "./core/port-discovery.js";
+import { DEFAULT_WS_PORT, getPortRange, advertisePort, unadvertisePort, registerPortCleanup, startPeriodicReaper, discoverActiveInstances, cleanupStalePortFiles, cleanupOrphanedProcesses, evictOldestInstance, refreshPortAdvertisement, noteToolCall, setAdvertisedMcpHttpUrl, HEARTBEAT_INTERVAL_MS, } from "./core/port-discovery.js";
+import { parseHttpPort, startLocalHttpTransport } from "./core/http-transport.js";
 import { onStdinClosed } from "./core/stdin-lifecycle.js";
 import { registerTokenBrowserApp } from "./apps/token-browser/server.js";
 import { registerDesignSystemAuditTool, registerDesignSystemDashboardApp, } from "./apps/design-system-dashboard/server.js";
@@ -111,6 +112,9 @@ class LocalFigmaConsoleMCP {
         this.wsReaperStop = null;
         /** Heartbeat timer that refreshes port file to prove this server is active */
         this.wsHeartbeatTimer = null;
+        /** Optional Streamable HTTP endpoint (FIGMA_MCP_HTTP_PORT), shared by local clients. */
+        this.httpEndpoint = null;
+        this.httpStartupError = null;
         this.config = getConfig();
         // In-memory cache for variables data to avoid MCP token limits
         // Maps fileKey -> {data, timestamp}
@@ -123,7 +127,14 @@ class LocalFigmaConsoleMCP {
         this.auditDataCache = new Map();
         /** Stable plugin directory path (set during startup) */
         this.stablePluginPath = null;
-        this.server = new McpServer({
+        this.server = this.createMcpServer();
+    }
+    /**
+     * A configured McpServer with no tools yet. stdio uses one for the whole
+     * run; the optional HTTP endpoint builds one per request (see http-transport.ts).
+     */
+    createMcpServer() {
+        const server = new McpServer({
             name: "Figma Console MCP (Local)",
             // Was hard-coded "0.1.0" — every client saw that regardless of the release
             version: getServerVersion(),
@@ -194,7 +205,8 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
         // Stamp every tool response (and every thrown error) with our MCP identity
         // so LLMs can attribute output unambiguously when multiple Figma-related
         // MCPs are connected. Idempotent for already-tagged responses.
-        wrapServerForIdentity(this.server, { onToolCall: noteToolCall });
+        wrapServerForIdentity(server, { onToolCall: noteToolCall });
+        return server;
     }
     /**
      * Get or create Figma API client
@@ -366,9 +378,9 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
     /**
      * Register all MCP tools
      */
-    registerTools() {
+    registerTools(server) {
         // Tool 1: Get Console Logs
-        this.server.tool("figma_get_console_logs", "Retrieve console logs captured by the Desktop Bridge plugin: console output from code run through it (figma_execute and the other write tools) and from the bridge itself. It does NOT capture another plugin's console — Figma runs one plugin at a time in a file, each in its own sandbox, so the bridge cannot see a plugin you are developing. To debug your own plugin's logic, run that code through figma_execute and read the logs here, or use Figma's own developer console for the plugin.", {
+        server.tool("figma_get_console_logs", "Retrieve console logs captured by the Desktop Bridge plugin: console output from code run through it (figma_execute and the other write tools) and from the bridge itself. It does NOT capture another plugin's console — Figma runs one plugin at a time in a file, each in its own sandbox, so the bridge cannot see a plugin you are developing. To debug your own plugin's logic, run that code through figma_execute and read the logs here, or use Figma's own developer console for the plugin.", {
             count: z
                 .number()
                 .optional()
@@ -461,7 +473,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
         // Bridge-first: the plugin's exportAsync works on any Figma plan with no REST
         // token, and reflects the current runtime state (no cloud-sync lag).
         // Note: For screenshots of specific components, use figma_get_component_image instead
-        this.server.tool("figma_take_screenshot", `Export an image of the current Figma page or specific node. Uses the Desktop Bridge plugin (exportAsync) when connected — works on any plan, no REST token needed, reflects current runtime state. Falls back to the Figma REST API when the bridge is unavailable or for PDF format. Use for visual validation after design changes — check alignment, spacing, proportions. Pass nodeId to target specific elements. For components, prefer figma_get_component_image.`, {
+        server.tool("figma_take_screenshot", `Export an image of the current Figma page or specific node. Uses the Desktop Bridge plugin (exportAsync) when connected — works on any plan, no REST token needed, reflects current runtime state. Falls back to the Figma REST API when the bridge is unavailable or for PDF format. Use for visual validation after design changes — check alignment, spacing, proportions. Pass nodeId to target specific elements. For components, prefer figma_get_component_image.`, {
             nodeId: z
                 .string()
                 .optional()
@@ -646,7 +658,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             }
         });
         // Tool 3: Watch Console (Real-time streaming)
-        this.server.tool("figma_watch_console", "Stream console logs captured by the Desktop Bridge plugin in real-time for a specified duration (max 5 minutes). Covers code run through the bridge (figma_execute and the write tools) — not other plugins, which run in their own sandboxes. Returns all logs captured during the watch period with summary statistics. NOT for retrieving past logs (use figma_get_console_logs). Best for: watching long-running figma_execute scripts, debugging race conditions, monitoring async operations.", {
+        server.tool("figma_watch_console", "Stream console logs captured by the Desktop Bridge plugin in real-time for a specified duration (max 5 minutes). Covers code run through the bridge (figma_execute and the write tools) — not other plugins, which run in their own sandboxes. Returns all logs captured during the watch period with summary statistics. NOT for retrieving past logs (use figma_get_console_logs). Best for: watching long-running figma_execute scripts, debugging race conditions, monitoring async operations.", {
             duration: z
                 .number()
                 .optional()
@@ -696,7 +708,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             };
         });
         // Tool 4: Reload Plugin
-        this.server.tool("figma_reload_plugin", "Reload the current Figma page/plugin to test code changes. Optionally clears console logs before reload. Use when user says: 'reload plugin', 'refresh page', 'restart plugin', 'test my changes'. Returns reload confirmation and current URL. Best for rapid iteration during plugin development.", {
+        server.tool("figma_reload_plugin", "Reload the current Figma page/plugin to test code changes. Optionally clears console logs before reload. Use when user says: 'reload plugin', 'refresh page', 'restart plugin', 'test my changes'. Returns reload confirmation and current URL. Best for rapid iteration during plugin development.", {
             clearConsole: z
                 .boolean()
                 .optional()
@@ -764,7 +776,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             }
         });
         // Tool 5: Clear Console
-        this.server.tool("figma_clear_console", "Clear the console log buffer. Safely clears the buffer without disrupting the connection. Returns number of logs cleared.", {}, async () => {
+        server.tool("figma_clear_console", "Clear the console log buffer. Safely clears the buffer without disrupting the connection. Returns number of logs cleared.", {}, async () => {
             try {
                 let clearedCount = 0;
                 let transport = "websocket";
@@ -816,7 +828,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             }
         });
         // Tool 6: Navigate / switch active file
-        this.server.tool("figma_navigate", "Switch the active Figma file target among files that already have the Desktop Bridge plugin running. Local mode is WebSocket-only — this tool does NOT launch a browser or open files. If the requested URL is already the active file, it confirms the connection. If another connected plugin matches the URL, it switches the active target so subsequent tool calls hit that file. If no connected plugin matches, returns guidance for the user to open the Desktop Bridge plugin in the target file. Use figma_list_open_files to see all connected files.\n\nPass lock: true to PIN this file as the target — new connections, reconnects, and the user's own selection/page changes in other files will no longer move the target. Use this for parallel work (agent edits one file while the user works in another) so commands can't silently route to the wrong file. Switching to another file (or lock: false) releases the pin; it also releases automatically if the pinned file disconnects.", {
+        server.tool("figma_navigate", "Switch the active Figma file target among files that already have the Desktop Bridge plugin running. Local mode is WebSocket-only — this tool does NOT launch a browser or open files. If the requested URL is already the active file, it confirms the connection. If another connected plugin matches the URL, it switches the active target so subsequent tool calls hit that file. If no connected plugin matches, returns guidance for the user to open the Desktop Bridge plugin in the target file. Use figma_list_open_files to see all connected files.\n\nPass lock: true to PIN this file as the target — new connections, reconnects, and the user's own selection/page changes in other files will no longer move the target. Use this for parallel work (agent edits one file while the user works in another) so commands can't silently route to the wrong file. Switching to another file (or lock: false) releases the pin; it also releases automatically if the pinned file disconnects.", {
             url: z
                 .string()
                 .url()
@@ -953,7 +965,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             }
         });
         // Tool 7: Get Status (with setup validation)
-        this.server.tool("figma_get_status", "Check connection status to Figma Desktop. Reports transport status and connection health via the Desktop Bridge plugin (WebSocket transport). Use probe:true for an active roundtrip verification that the plugin is actually responding.", {
+        server.tool("figma_get_status", "Check connection status to Figma Desktop. Reports transport status and connection health via the Desktop Bridge plugin (WebSocket transport). Use probe:true for an active roundtrip verification that the plugin is actually responding.", {
             probe: z.boolean().optional().describe("When true, sends a live roundtrip command to the plugin to verify the connection is actually responsive (not just TCP-open). Returns probeResult with success/latency. Recommended for health checks."),
         }, async ({ probe }) => {
             try {
@@ -1049,6 +1061,11 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
                                 monitorWorkerCount: 0,
                                 transport: {
                                     active: activeTransport,
+                                    mcpHttp: this.httpEndpoint
+                                        ? { url: this.httpEndpoint.url, sessions: this.httpEndpoint.sessionCount(), auth: process.env.FIGMA_MCP_HTTP_TOKEN ? "bearer" : "none" }
+                                        : this.httpStartupError
+                                            ? { error: this.httpStartupError }
+                                            : undefined,
                                     websocket: {
                                         available: wsConnected,
                                         serverRunning: this.wsServer?.isStarted() ?? false,
@@ -1075,6 +1092,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
                                                     port: i.port,
                                                     pid: i.pid,
                                                     startedAt: i.startedAt,
+                                                    mcpHttpUrl: i.mcpHttpUrl,
                                                 }));
                                             }
                                             catch {
@@ -1180,7 +1198,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
         // CONNECTION MANAGEMENT TOOLS
         // ============================================================================
         // Tool: Force reconnect to Figma Desktop
-        this.server.tool("figma_reconnect", "Force a complete reconnection to Figma Desktop. Use when connection seems stale or after switching files.", {}, async () => {
+        server.tool("figma_reconnect", "Force a complete reconnection to Figma Desktop. Use when connection seems stale or after switching files.", {}, async () => {
             try {
                 // figma_reconnect is informational in WebSocket-only mode — the
                 // plugin handles its own reconnect logic. A TCP-open socket is not
@@ -1263,7 +1281,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
         // REAL-TIME AWARENESS TOOLS (WebSocket-only)
         // ============================================================================
         // Tool: Get current user selection in Figma
-        this.server.tool("figma_get_selection", "Get the currently selected nodes in Figma. Returns node IDs, names, types, and dimensions. WebSocket-only — requires Desktop Bridge plugin. Use this to understand what the user is pointing at instead of asking them to describe it.", {
+        server.tool("figma_get_selection", "Get the currently selected nodes in Figma. Returns node IDs, names, types, and dimensions. WebSocket-only — requires Desktop Bridge plugin. Use this to understand what the user is pointing at instead of asking them to describe it.", {
             verbose: z
                 .boolean()
                 .optional()
@@ -1356,7 +1374,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             }
         });
         // Tool: Get recent design changes
-        this.server.tool("figma_get_design_changes", "Get recent document changes detected in Figma. Returns buffered change events including which nodes changed, whether styles were modified, and change counts. WebSocket-only — events are captured via Desktop Bridge plugin. Use this to understand what changed since you last checked.", {
+        server.tool("figma_get_design_changes", "Get recent document changes detected in Figma. Returns buffered change events including which nodes changed, whether styles were modified, and change counts. WebSocket-only — events are captured via Desktop Bridge plugin. Use this to understand what changed since you last checked.", {
             since: z
                 .number()
                 .optional()
@@ -1433,7 +1451,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             }
         });
         // Tool: List all open files connected via WebSocket
-        this.server.tool("figma_list_open_files", "List all Figma files currently connected via the Desktop Bridge plugin. Shows which files have the plugin open and which one is the active target for tool calls. Use figma_navigate to switch between files. WebSocket multi-client mode — each file with the Desktop Bridge plugin maintains its own connection.", {}, async () => {
+        server.tool("figma_list_open_files", "List all Figma files currently connected via the Desktop Bridge plugin. Shows which files have the plugin open and which one is the active target for tool calls. Use figma_navigate to switch between files. WebSocket multi-client mode — each file with the Desktop Bridge plugin maintains its own connection.", {}, async () => {
             try {
                 if (!this.wsServer?.isClientConnected()) {
                     return {
@@ -1651,7 +1669,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
         // (Previously interleaved with write tools in local.ts; restored after the
         // Phase-2 write-tools dedupe excised them along with the surrounding writes.)
         // ============================================================================
-        this.server.tool("figma_get_design_system_summary", "Get a compact overview of the design system. Returns categories, component counts, and token collection names WITHOUT full details. Use this first to understand what's available, then use figma_search_components to find specific components. This tool is optimized for minimal token usage.", {
+        server.tool("figma_get_design_system_summary", "Get a compact overview of the design system. Returns categories, component counts, and token collection names WITHOUT full details. Use this first to understand what's available, then use figma_search_components to find specific components. This tool is optimized for minimal token usage.", {
             forceRefresh: z
                 .boolean()
                 .optional()
@@ -1855,7 +1873,7 @@ If Design Systems Assistant MCP is not available, install it from: https://githu
             }
         });
         // Tool 2: Search Components (~3000 tokens response max, paginated)
-        this.server.tool("figma_search_components", `Search for components by name, category, or description. Returns paginated results with component keys for instantiation. Automatically loads the design system cache if needed.
+        server.tool("figma_search_components", `Search for components by name, category, or description. Returns paginated results with component keys for instantiation. Automatically loads the design system cache if needed.
 
 **NEW: Cross-file library search!** Pass a libraryFileKey or libraryFileUrl to search for components in a published shared library (different file). This uses the REST API and requires FIGMA_ACCESS_TOKEN.
 
@@ -2096,7 +2114,7 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
             }
         });
         // Tool 3: Get Component Details (~500 tokens per component)
-        this.server.tool("figma_get_component_details", "Get full details for a specific component including all variants, properties, and keys needed for instantiation. Use the component key or name from figma_search_components.", {
+        server.tool("figma_get_component_details", "Get full details for a specific component including all variants, properties, and keys needed for instantiation. Use the component key or name from figma_search_components.", {
             componentKey: z
                 .string()
                 .optional()
@@ -2206,7 +2224,7 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
             }
         });
         // Tool 4: Get Token Values (~2000 tokens response max)
-        this.server.tool("figma_get_token_values", "Get actual values for design tokens (colors, spacing, etc). Use after figma_get_design_system_summary to get specific token values for implementation.", {
+        server.tool("figma_get_token_values", "Get actual values for design tokens (colors, spacing, etc). Use after figma_get_design_system_summary to get specific token values for implementation.", {
             type: z
                 .enum(["colors", "spacing", "all"])
                 .optional()
@@ -2299,7 +2317,7 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
             }
         });
         // Tool 5: Instantiate Component
-        this.server.tool("figma_get_library_components", `Discover published components from a shared/team library file.
+        server.tool("figma_get_library_components", `Discover published components from a shared/team library file.
 
 **USE THIS when you need to use components from a published design system library** (a different file than the one currently open). This bridges the gap between library discovery and instantiation.
 
@@ -2569,18 +2587,18 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
         // Register all write/manipulation tools (figma_execute, variable CRUD, node mutations,
         // design-token setup, accessibility audits, etc.). Sourced from src/core/write-tools.ts
         // so local mode and cloud mode share the same 30 implementations — no risk of drift.
-        registerWriteTools(this.server, () => this.getDesktopConnector());
+        registerWriteTools(server, () => this.getDesktopConnector());
         // Register cross-file tools (figma_execute_across_files) — run the same
         // code against every (or a chosen subset of) currently connected files
         // concurrently. Local mode only, needs direct wsServer access for
         // getConnectedFiles(), so it isn't part of the connector abstraction.
-        registerMultiFileTools(this.server, () => this.wsServer, () => this.getDesktopConnector());
+        registerMultiFileTools(server, () => this.wsServer, () => this.getDesktopConnector());
         // Register token sync tools — figma_export_tokens and figma_import_tokens.
         // Replace Style Dictionary and Tokens Studio's export pipeline for the
         // popular styling methods (DTCG canonical — legacy + 2025.10 dialects —
         // plus CSS/Tailwind/SCSS/TS/JSON/Style Dictionary/Tokens Studio, all
         // derived from a single internal token model).
-        registerTokensTools(this.server, () => this.getDesktopConnector(), {
+        registerTokensTools(server, () => this.getDesktopConnector(), {
             // Lets figma_export_tokens report WHICH connected file it read from —
             // the bridge reads the active file, which may not be the intended one.
             resolveFileName: (fileKey) => this.wsServer
@@ -2593,18 +2611,18 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
         // these read/write the local filesystem, which Cloudflare Workers
         // cannot (registerMultiFileTools precedent — never registered in
         // src/index.ts, so no Cloud Mode silent no-op is possible).
-        registerDesignSystemExtractionTools(this.server);
+        registerDesignSystemExtractionTools(server);
         // Register Figma API tools (Tools 8-11)
-        registerFigmaAPITools(this.server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), this.variablesCache, // Pass cache for efficient variable queries
+        registerFigmaAPITools(server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), this.variablesCache, // Pass cache for efficient variable queries
         undefined, // options (use default)
         () => this.getDesktopConnector());
         // Register Design-Code Parity & Documentation tools
-        registerDesignCodeTools(this.server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), this.variablesCache, undefined, // options
+        registerDesignCodeTools(server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), this.variablesCache, undefined, // options
         () => this.getDesktopConnector());
         // Register Comment tools
-        registerCommentTools(this.server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl());
+        registerCommentTools(server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl());
         // Register Version History tools
-        registerVersionTools(this.server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), undefined, // options
+        registerVersionTools(server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), undefined, // options
         () => {
             // Selection fallback for blame/diff/changelog tools
             const sel = this.wsServer?.getCurrentSelection();
@@ -2619,20 +2637,20 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
             return this.wsServer.getMetadataChanges(opts);
         });
         // Register Design System Kit tool
-        registerDesignSystemTools(this.server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), this.variablesCache, undefined, // options (use default)
+        registerDesignSystemTools(server, () => this.getFigmaAPI(), () => this.getCurrentFileUrl(), this.variablesCache, undefined, // options (use default)
         () => this.getDesktopConnector());
         // Register Library Tools (key-based component inspection across shared libraries)
-        registerLibraryTools(this.server, () => this.getFigmaAPI());
+        registerLibraryTools(server, () => this.getFigmaAPI());
         // Register Library Variable Tools (Plugin-API based — list + import variables
         // from subscribed team libraries; works on every Figma plan, no Enterprise needed)
-        registerLibraryVariableTools(this.server, () => this.getDesktopConnector());
+        registerLibraryVariableTools(server, () => this.getDesktopConnector());
         // Register code-side accessibility scanning (axe-core + JSDOM)
-        registerAccessibilityTools(this.server);
+        registerAccessibilityTools(server);
         // Register figma_diagnose — designer-readable health check + cross-MCP disambiguator.
         // This is the first tool to point a confused user at: it self-identifies the server,
         // reports plugin/token state in plain language, and explicitly disclaims any
         // token/OAuth error that may have been emitted by a different Figma-related MCP.
-        registerDiagnoseTool(this.server, {
+        registerDiagnoseTool(server, {
             mode: "local",
             getServerVersion: () => {
                 try {
@@ -2666,17 +2684,17 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
             },
         });
         // Register Annotation tools (read/write design annotations via Desktop Bridge)
-        registerAnnotationTools(this.server, () => this.getDesktopConnector());
+        registerAnnotationTools(server, () => this.getDesktopConnector());
         // Register Deep Component tools (full Plugin API tree extraction for code generation)
-        registerDeepComponentTools(this.server, () => this.getDesktopConnector());
+        registerDeepComponentTools(server, () => this.getDesktopConnector());
         // Register FigJam-specific tools (sticky notes, connectors, tables, etc.)
-        registerFigJamTools(this.server, () => this.getDesktopConnector());
+        registerFigJamTools(server, () => this.getDesktopConnector());
         // Register Figma Slides tools (slide management, transitions, content)
-        registerSlidesTools(this.server, () => this.getDesktopConnector());
-        registerSlotTools(this.server, () => this.getDesktopConnector());
+        registerSlidesTools(server, () => this.getDesktopConnector());
+        registerSlotTools(server, () => this.getDesktopConnector());
         // MCP Apps - gated behind ENABLE_MCP_APPS env var
         if (process.env.ENABLE_MCP_APPS === "true") {
-            registerTokenBrowserApp(this.server, async (fileUrl) => {
+            registerTokenBrowserApp(server, async (fileUrl) => {
                 const url = fileUrl || this.getCurrentFileUrl();
                 if (!url) {
                     throw new Error("No Figma file URL available. Either pass a fileUrl, call figma_navigate, or ensure the Desktop Bridge plugin is connected.");
@@ -3135,10 +3153,10 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
         };
         // Always available — any MCP client can run the audit, no MCP Apps
         // support required.
-        registerDesignSystemAuditTool(this.server, fetchDesignSystemAuditData, () => this.getCurrentFileUrl());
+        registerDesignSystemAuditTool(server, fetchDesignSystemAuditData, () => this.getCurrentFileUrl());
         // Visual dashboard app (MCP-Apps-capable hosts only).
         if (process.env.ENABLE_MCP_APPS === "true") {
-            registerDesignSystemDashboardApp(this.server, fetchDesignSystemAuditData, 
+            registerDesignSystemDashboardApp(server, fetchDesignSystemAuditData, 
             // Pass getCurrentUrl so dashboard can track which file was audited
             () => this.getCurrentFileUrl());
         }
@@ -3322,12 +3340,13 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
             logger.info("Checking Figma Desktop accessibility...");
             await this.checkFigmaDesktop();
             // Register all tools
-            this.registerTools();
+            this.registerTools(this.server);
             // Create stdio transport
             const transport = new StdioServerTransport();
             // Connect server to transport
             await this.server.connect(transport);
             logger.info("MCP server started successfully on stdio transport");
+            await this.startHttpEndpoint();
             // 🆕 AUTO-CONNECT: Start monitoring immediately if Figma Desktop is available
             // This enables "get latest logs" workflow without requiring manual setup
             // In WS-only mode, no auto-connect is needed — the Desktop Bridge plugin
@@ -3342,12 +3361,53 @@ Without libraryFileKey/libraryFileUrl, searches the currently open file (local c
             process.exit(1);
         }
     }
+    /**
+     * Serve MCP over Streamable HTTP as well, when FIGMA_MCP_HTTP_PORT is set.
+     * A failure here (bad value, port taken) is reported but never stops stdio.
+     */
+    async startHttpEndpoint() {
+        let port;
+        try {
+            port = parseHttpPort(process.env.FIGMA_MCP_HTTP_PORT);
+        }
+        catch (error) {
+            this.httpStartupError = error instanceof Error ? error.message : String(error);
+            logger.warn(this.httpStartupError);
+            return;
+        }
+        if (port === null)
+            return;
+        try {
+            this.httpEndpoint = await startLocalHttpTransport({
+                port,
+                token: process.env.FIGMA_MCP_HTTP_TOKEN || undefined,
+                createServer: () => {
+                    const server = this.createMcpServer();
+                    this.registerTools(server);
+                    return server;
+                },
+            });
+            setAdvertisedMcpHttpUrl(this.httpEndpoint.url);
+            console.error(`[figma-console-mcp] MCP over HTTP: ${this.httpEndpoint.url}`);
+        }
+        catch (error) {
+            const code = error?.code;
+            this.httpStartupError = code === "EADDRINUSE"
+                ? `Port ${port} is already in use, so the HTTP endpoint is off (stdio still works). Another figma-console-mcp may already serve it: check its port file, or pick another FIGMA_MCP_HTTP_PORT.`
+                : `HTTP endpoint failed to start on port ${port}: ${error instanceof Error ? error.message : String(error)}`;
+            logger.warn({ port, code }, this.httpStartupError);
+        }
+    }
     /**
      * Cleanup and shutdown
      */
     async shutdown() {
         logger.info("Shutting down MCP server...");
         try {
+            if (this.httpEndpoint) {
+                await this.httpEndpoint.close();
+                this.httpEndpoint = null;
+            }
             // Stop heartbeat timer
             if (this.wsHeartbeatTimer) {
                 clearInterval(this.wsHeartbeatTimer);