unframer 4.0.3 → 4.0.4

package/dist/lib/config.d.ts

@@ -0,0 +1,17 @@
+export interface CachedMcpTools {
+    tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: unknown;
+    }>;
+    timestamp: number;
+    sessionId?: string;
+}
+export interface UnframerConfig {
+    mcpUrl?: string;
+    cachedMcpTools?: CachedMcpTools;
+}
+export declare function loadConfig(): UnframerConfig;
+export declare function saveConfig(config: UnframerConfig): void;
+export declare function getConfigPath(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,KAAK,CAAC;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,WAAW,CAAC,EAAE,OAAO,CAAA;KACxB,CAAC,CAAA;IACF,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,cAAc,CAAA;CAClC;AAED,wBAAgB,UAAU,IAAI,cAAc,CAS3C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAKvD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/lib/config.js

@@ -0,0 +1,26 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const CONFIG_DIR = path.join(os.homedir(), '.unframer');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export function loadConfig() {
+    if (!fs.existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(config) {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAA;AACvD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;AAiBxD,MAAM,UAAU,UAAU,GAAmB;IACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAA;IACb,CAAC;AAAA,CACJ;AAED,MAAM,UAAU,UAAU,CAAC,MAAsB,EAAQ;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAAA,CACjE;AAED,MAAM,UAAU,aAAa,GAAW;IACpC,OAAO,WAAW,CAAA;AAAA,CACrB"}

package/dist/lib/mcp-to-cli.d.ts

@@ -0,0 +1,25 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { CAC } from "@xmorse/cac";
+export type { Transport };
+export interface AddMcpCommandsOptions {
+    cli: CAC;
+    commandPrefix: string;
+    /**
+     * Name used when connecting to the MCP server.
+     * @default 'mcp-cli-client'
+     */
+    clientName?: string;
+    /**
+     * Returns a transport to connect to the MCP server, or null if not configured.
+     * If null is returned, no MCP tool commands will be registered.
+     * @param sessionId - Optional session ID from cache to reuse existing session
+     */
+    getMcpTransport: (sessionId?: string) => Transport | null | Promise<Transport | null>;
+}
+/**
+ * Adds MCP tool commands to a cac CLI instance.
+ * Tools are cached for 1 hour to avoid connecting on every CLI invocation.
+ * Session ID is also cached to skip MCP initialization handshake.
+ */
+export declare function addMcpCommands(options: AddMcpCommandsOptions): Promise<void>;
+//# sourceMappingURL=mcp-to-cli.d.ts.map

package/dist/lib/mcp-to-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-to-cli.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-to-cli.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGvC,YAAY,EAAE,SAAS,EAAE,CAAC;AAI1B,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,GAAG,CAAC;IACT,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACvF;AA8ED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0HlF"}

package/dist/lib/mcp-to-cli.js

@@ -0,0 +1,176 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { loadConfig, saveConfig } from "./config.js";
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Convert JSON schema to compact JSON string for display
+ */
+function schemaToString(schema) {
+    // Show compact JSON schema
+    const compact = { ...schema };
+    // Remove verbose fields for display
+    delete compact.description;
+    return JSON.stringify(compact);
+}
+function parseToolArguments(options, inputSchema) {
+    const args = {};
+    if (!inputSchema?.properties) {
+        return args;
+    }
+    for (const [name, schema] of Object.entries(inputSchema.properties)) {
+        let value = options[name];
+        if (value === undefined) {
+            continue;
+        }
+        // cac wraps values in arrays when using type: [String] or type: [Number]
+        // Always unwrap single-element arrays - for object/array schema types,
+        // the inner value is a JSON string that we'll parse below
+        if (Array.isArray(value) && value.length === 1) {
+            value = value[0];
+        }
+        const type = schema.type || "string";
+        if ((type === "object" || type === "array") && typeof value === "string") {
+            try {
+                args[name] = JSON.parse(value);
+            }
+            catch {
+                console.error(`Invalid JSON for --${name}: ${value}`);
+                process.exit(1);
+            }
+        }
+        else {
+            args[name] = value;
+        }
+    }
+    return args;
+}
+function outputResult(result) {
+    for (const block of result.content) {
+        if (block.type === "text" && block.text) {
+            console.log(block.text);
+        }
+        else if (block.type === "image") {
+            // Skip base64 image data in CLI output
+            console.log("[Image content omitted]");
+        }
+        else {
+            console.log(JSON.stringify(block, null, 2));
+        }
+    }
+}
+/**
+ * Adds MCP tool commands to a cac CLI instance.
+ * Tools are cached for 1 hour to avoid connecting on every CLI invocation.
+ * Session ID is also cached to skip MCP initialization handshake.
+ */
+export async function addMcpCommands(options) {
+    const { cli, commandPrefix, clientName = "mcp-cli-client", getMcpTransport } = options;
+    // Try to use cached tools first
+    const config = loadConfig();
+    const cachedTools = config.cachedMcpTools;
+    const isCacheValid = cachedTools && (Date.now() - cachedTools.timestamp) < CACHE_TTL_MS;
+    let tools;
+    let cachedSessionId;
+    if (isCacheValid) {
+        // Use cached tools to register commands
+        tools = cachedTools.tools;
+        cachedSessionId = cachedTools.sessionId;
+    }
+    else {
+        // Cache invalid/missing - connect to fetch tools
+        const transport = await getMcpTransport();
+        if (!transport) {
+            return;
+        }
+        const client = new Client({ name: clientName, version: "1.0.0" }, { capabilities: {} });
+        try {
+            await client.connect(transport);
+            const result = await client.listTools();
+            tools = result.tools;
+            // Get session ID from transport if available
+            const sessionId = transport.sessionId;
+            // Save tools and session ID to cache
+            saveConfig({
+                ...config,
+                cachedMcpTools: {
+                    tools: tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        inputSchema: t.inputSchema,
+                    })),
+                    timestamp: Date.now(),
+                    sessionId,
+                },
+            });
+            cachedSessionId = sessionId;
+        }
+        catch (err) {
+            console.error(`Failed to connect to MCP server: ${err instanceof Error ? err.message : err}`);
+            return;
+        }
+        finally {
+            await client.close();
+        }
+    }
+    for (const tool of tools) {
+        const inputSchema = tool.inputSchema;
+        const cmdName = `${commandPrefix} ${tool.name}`;
+        const description = tool.description || `Run MCP tool ${tool.name}`;
+        const cmd = cli.command(cmdName, description);
+        // Add options for each property in the input schema
+        if (inputSchema?.properties) {
+            for (const [propName, propSchema] of Object.entries(inputSchema.properties)) {
+                const isRequired = inputSchema.required?.includes(propName) ?? false;
+                const schemaType = propSchema.type || "string";
+                // Boolean options are flags without <value>
+                // Other types use <value> syntax
+                const optionStr = schemaType === "boolean" ? `--${propName}` : `--${propName} <${propName}>`;
+                let optionDesc = propSchema.description || propName;
+                if (isRequired) {
+                    optionDesc += " (required)";
+                }
+                // Add schema hint for non-scalar types
+                if (schemaType === "object" || schemaType === "array") {
+                    optionDesc += ` (JSON: ${schemaToString(propSchema)})`;
+                }
+                // Build option config with type transform
+                // Use type: [Type] to prevent cac/mri from auto-converting values
+                // This wraps values in arrays which we unwrap in parseToolArguments
+                const optionConfig = {};
+                if (propSchema.default !== undefined) {
+                    optionConfig.default = propSchema.default;
+                }
+                if (schemaType === "number" || schemaType === "integer") {
+                    optionConfig.type = [Number];
+                }
+                else if (schemaType !== "boolean") {
+                    // String for string/object/array types - prevents mri from mangling JSON strings
+                    optionConfig.type = [String];
+                }
+                cmd.option(optionStr, optionDesc, optionConfig);
+            }
+        }
+        cmd.action(async (cliOptions) => {
+            const parsedArgs = parseToolArguments(cliOptions, inputSchema);
+            // Connect with cached session ID to skip initialization handshake
+            const transport = await getMcpTransport(cachedSessionId);
+            if (!transport) {
+                console.error("MCP transport not available");
+                process.exit(1);
+            }
+            const actionClient = new Client({ name: clientName, version: "1.0.0" }, { capabilities: {} });
+            await actionClient.connect(transport);
+            try {
+                const result = await actionClient.callTool({ name: tool.name, arguments: parsedArgs });
+                outputResult(result);
+            }
+            catch (err) {
+                console.error(`Error calling ${tool.name}:`, err instanceof Error ? err.message : err);
+                process.exit(1);
+            }
+            finally {
+                await actionClient.close();
+            }
+        });
+    }
+}
+//# sourceMappingURL=mcp-to-cli.js.map

package/dist/lib/mcp-to-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-to-cli.js","sourceRoot":"","sources":["../../src/lib/mcp-to-cli.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "4.0.3";
+export declare const version = "4.0.4";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const version = '4.0.3';
+export const version = '4.0.4';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,98 +1,99 @@
 {
-    "name": "unframer",
-    "version": "4.0.3",
-    "type": "module",
-    "description": "Import Framer components directly in your React app, type safe and customizable",
-    "sideEffects": false,
-    "repository": "https://github.com/remorses/unframer",
-    "scripts": {
-        "build": "rm -rf dist && pnpm tsgo && cp ../README.md ./README.md && cp ./src/framer.d.ts ./dist/framer.d.ts && cp ./src/framer.js ./dist/framer.js && cp -r ./src/framer-chunks ./dist/framer-chunks",
-        "test": "vitest",
-        "gen-client": "export DIR=./src/generated/ && cd ../../website && pnpm tsc; rm -rf $DIR && mkdir -p $DIR && cp ./dist/src/lib/api-client.* $DIR",
-        "prepublishOnly": "pnpm tsx scripts/version-replace.ts && pnpm build",
-        "download-framer": "tsx scripts/download.ts",
-        "watch": "rm -rf dist && pnpm tsc -w"
+  "name": "unframer",
+  "version": "4.0.4",
+  "type": "module",
+  "description": "Import Framer components directly in your React app, type safe and customizable",
+  "sideEffects": false,
+  "repository": "https://github.com/remorses/unframer",
+  "bin": "bin.js",
+  "files": [
+    "dist",
+    "framer-fixed",
+    "bin.js",
+    "src",
+    "!src/framer-chunks",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
-    "bin": "bin.js",
-    "files": [
-        "dist",
-        "framer-fixed",
-        "bin.js",
-        "src",
-        "!src/framer-chunks",
-        "README.md"
-    ],
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
-        },
-        "./src/framer.js": {
-            "types": "./dist/framer.d.ts",
-            "default": "./src/framer.js"
-        },
-        "./dist/exporter": {
-            "types": "./dist/exporter.d.ts",
-            "default": "./dist/exporter.js"
-        },
-        "./styles/*": {
-            "default": "./src/styles/*"
-        },
-        "./src/*": {
-            "default": "./src/*.ts"
-        },
-        "./package.json": "./package.json"
+    "./src/framer.js": {
+      "types": "./dist/framer.d.ts",
+      "default": "./src/framer.js"
     },
-    "keywords": [],
-    "author": "Tommaso De Rossi, morse <beats.by.morse@gmail.com>",
-    "license": "",
-    "peerDependencies": {
-        "react": "*",
-        "react-dom": "*"
+    "./dist/exporter": {
+      "types": "./dist/exporter.d.ts",
+      "default": "./dist/exporter.js"
     },
-    "engines": {
-        "node": ">=18.0.0"
+    "./styles/*": {
+      "default": "./src/styles/*"
     },
-    "dependencies": {
-        "@antfu/ni": "^25.0.0",
-        "@babel/core": "^7.28.6",
-        "@biomejs/js-api": "^0.7.1",
-        "@biomejs/wasm-nodejs": "^1.9.4",
-        "async-sema": "^3.1.1",
-        "cac": "^6.7.14",
-        "esbuild": "^0.25.8",
-        "esbuild-plugins-node-modules-polyfill": "^1.6.8",
-        "nanospinner": "^1.2.2",
-        "picocolors": "^1.1.1",
-        "real-framer-motion": "npm:framer-motion@^12.23.12",
-        "spiceflow": "^1.17.10",
-        "string-dedent": "^3.0.1",
-        "undici": "^7.18.2"
+    "./src/*": {
+      "default": "./src/*.ts"
     },
-    "devDependencies": {
-        "@babel/helper-annotate-as-pure": "^7.25.9",
-        "@babel/helper-environment-visitor": "^7.24.7",
-        "@babel/helper-split-export-declaration": "^7.24.7",
-        "@babel/plugin-transform-react-pure-annotations": "^7.25.9",
-        "@babel/traverse": "^7.28.6",
-        "@babel/types": "^7.28.6",
-        "@types/babel__core": "^7.20.5",
-        "@types/babel__traverse": "^7.28.0",
-        "@types/bun": "^1.1.6",
-        "@types/node": "^22.15.21",
-        "@types/react": "^19.2.7",
-        "@types/react-dom": "^19.2.3",
-        "@typescript/native-preview": "7.0.0-dev.20260117.1",
-        "@xmorse/deployment-utils": "^0.7.4",
-        "concurrently": "^9.1.2",
-        "dprint-node": "^1.0.8",
-        "openai": "^4.80.1",
-        "posthtml": "^0.16.6",
-        "react": "19.2.3",
-        "react-dom": "19.2.3",
-        "tiktoken": "^1.0.18",
-        "typescript": "^5.9.3"
-    }
-}
+    "./package.json": "./package.json"
+  },
+  "keywords": [],
+  "author": "Tommaso De Rossi, morse <beats.by.morse@gmail.com>",
+  "license": "",
+  "peerDependencies": {
+    "react": "*",
+    "react-dom": "*"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@antfu/ni": "^25.0.0",
+    "@babel/core": "^7.28.6",
+    "@biomejs/js-api": "^0.7.1",
+    "@biomejs/wasm-nodejs": "^1.9.4",
+    "@inquirer/prompts": "^8.2.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@xmorse/cac": "^6.0.7",
+    "async-sema": "^3.1.1",
+    "esbuild": "^0.25.8",
+    "esbuild-plugins-node-modules-polyfill": "^1.6.8",
+    "nanospinner": "^1.2.2",
+    "picocolors": "^1.1.1",
+    "real-framer-motion": "npm:framer-motion@^12.23.12",
+    "spiceflow": "^1.17.10",
+    "string-dedent": "^3.0.1",
+    "undici": "^7.18.2"
+  },
+  "devDependencies": {
+    "@babel/helper-annotate-as-pure": "^7.25.9",
+    "@babel/helper-environment-visitor": "^7.24.7",
+    "@babel/helper-split-export-declaration": "^7.24.7",
+    "@babel/plugin-transform-react-pure-annotations": "^7.25.9",
+    "@babel/traverse": "^7.28.6",
+    "@babel/types": "^7.28.6",
+    "@types/babel__core": "^7.20.5",
+    "@types/babel__traverse": "^7.28.0",
+    "@types/bun": "^1.1.6",
+    "@types/node": "^22.15.21",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@typescript/native-preview": "7.0.0-dev.20260117.1",
+    "@xmorse/deployment-utils": "^0.7.4",
+    "concurrently": "^9.1.2",
+    "dprint-node": "^1.0.8",
+    "openai": "^4.80.1",
+    "posthtml": "^0.16.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "tiktoken": "^1.0.18",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "rm -rf dist && pnpm tsgo && cp ../README.md ./README.md && cp ./src/framer.d.ts ./dist/framer.d.ts && cp ./src/framer.js ./dist/framer.js && cp -r ./src/framer-chunks ./dist/framer-chunks",
+    "test": "vitest",
+    "gen-client": "export DIR=./src/generated/ && cd ../../website && pnpm tsc; rm -rf $DIR && mkdir -p $DIR && cp ./dist/src/lib/api-client.* $DIR",
+    "download-framer": "tsx scripts/download.ts",
+    "watch": "rm -rf dist && pnpm tsc -w"
+  }
+}

package/src/bin.ts

@@ -0,0 +1,3 @@
+import { cli } from "./cli.js";
+
+cli.parse()

package/src/cli.ts

@@ -4,12 +4,13 @@ import pico from 'picocolors'
 const { blue, bgBlue, green } = pico
 import { fetch } from 'undici'
 import './sentry.js'
+import { input } from '@inquirer/prompts'
 
 import { bundle, StyleToken, createExampleComponentCode } from './exporter.js'
 import { createClient } from './generated/api-client.js'
 import { generateStackblitzFiles } from './stackblitz.js'
 
-import { cac } from 'cac'
+import { cac } from '@xmorse/cac'
 import { exec } from 'child_process'
 import { promisify } from 'util'
 
@@ -27,6 +28,11 @@ import {
 import { getPackageManager } from './package-manager.js'
 import { notifyError } from './sentry.js'
 import { dispatcher } from './undici-dispatcher.js'
+import { loadConfig, saveConfig, getConfigPath } from './lib/config.js'
+import { addMcpCommands } from './lib/mcp-to-cli.js'
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'
+
 const configNames = ['unframer.config.json', 'unframer.json']
 
 export const cli = cac('unframer')
@@ -50,7 +56,7 @@ cli.command('[projectId]', 'Run unframer with optional project ID')
     .option('--metafile', 'Generate meta.json file with build metadata', {
         default: false,
     })
-    .action(async function main(projectId, options) {
+  .action(async function main(projectId, options) {
         const external_ = options.external
         const allExternal = external_ === true
         const externalPackages: string[] = Array.isArray(external_)
@@ -178,6 +184,7 @@ function fixOldUnframerPath() {
 
 const version = pkg.version
 
+
 cli.version(version).help()
 
 cli.command(
@@ -312,6 +319,58 @@ cli.command(
         }
     })
 
+
+cli.command(
+    'mcp login [url]',
+    'Store MCP server URL. After login, other MCP commands will appear in --help. The MCP URL is visible in the Framer MCP plugin.',
+).action(async (url?: string) => {
+    // Prompt for URL if not provided, avoids shell escaping issues with & in URLs
+    if (!url) {
+        const shortcut = process.platform === 'darwin' ? 'Cmd+K' : 'Ctrl+K'
+        console.log('\nTo get your MCP URL:')
+        console.log('  1. Go to https://framer.com and open your project')
+        console.log(`  2. Press ${shortcut} and search for "MCP" plugin`)
+        console.log('  3. Copy the URL shown in the plugin\n')
+    }
+    let mcpUrl = url
+    if (!mcpUrl) {
+        try {
+            mcpUrl = await input({ message: 'Paste MCP URL:' })
+        } catch (error) {
+            // Handle Ctrl+C gracefully
+            if (error instanceof Error && error.name === 'ExitPromptError') {
+                process.exit(0)
+            }
+            throw error
+        }
+    }
+    if (!mcpUrl) {
+        console.error('MCP URL is required')
+        process.exit(1)
+    }
+    saveConfig({ mcpUrl })
+    console.log(`MCP URL saved to ${getConfigPath()}`)
+})
+
+// Add MCP tool commands - only registered if transport is available
+await addMcpCommands({
+    cli,
+    commandPrefix: 'mcp',
+    getMcpTransport: (sessionId?: string) => {
+        const config = loadConfig()
+        if (!config.mcpUrl) {
+            return null
+        }
+        const url = new URL(config.mcpUrl)
+        // Use /mcp endpoint for StreamableHTTP
+        if (url.pathname.endsWith('/sse')) {
+            url.pathname = url.pathname.replace(/\/sse$/, '/mcp')
+        }
+        return new StreamableHTTPClientTransport(url, { sessionId })
+    },
+}).catch(e => console.error(e))
+
+
 export type Config = {
     jsx?: boolean
     components: {