unframer 4.0.4 → 4.1.0

package/README.md

@@ -314,3 +314,70 @@ Here is the below landing page Lighthouse score when using Astro:
 ## Example
 
 Look at the [nextjs-app source code folder](./nextjs-app) for an example and [the deployed website here](https://unframer-nextjs-app.vercel.app/)
+
+## MCP CLI Commands
+
+Unframer can act as a command-line client for the [Framer MCP plugin](https://www.framer.com/marketplace/plugins/mcp/), allowing you to interact with your Framer project directly from the terminal.
+
+### Setup
+
+```sh
+# Login with your MCP URL (get it from the Framer MCP plugin)
+npx unframer mcp login
+```
+
+After login, all MCP commands become available. Run `npx unframer --help` to see the full list.
+
+### Example Commands
+
+```sh
+# Get project structure as XML
+npx unframer mcp getProjectXml
+
+# Get a specific node's XML by ID
+npx unframer mcp getNodeXml --nodeId "abc123"
+
+# Update node text or attributes
+npx unframer mcp updateXmlForNode --nodeId "abc123" --xml '<Text nodeId="abc123">New text</Text>'
+
+# Search for fonts
+npx unframer mcp searchFonts --query "Inter"
+
+# Export React components
+npx unframer mcp exportReactComponents
+
+# Get published website URL
+npx unframer mcp getProjectWebsiteUrl
+```
+
+### CMS Operations
+
+```sh
+# List all CMS collections
+npx unframer mcp getCMSCollections
+
+# Get items from a collection
+npx unframer mcp getCMSItems --collectionId "col123"
+
+# Create or update a CMS item
+npx unframer mcp upsertCMSItem --collectionId "col123" --slug "my-post" --fieldData '{"title": "Hello"}'
+```
+
+### Code Files
+
+```sh
+# Create a new code component
+npx unframer mcp createCodeFile --name "MyComponent.tsx" --content "export default function MyComponent() { return <div>Hello</div> }"
+
+# Read existing code file
+npx unframer mcp readCodeFile --codeFileId "code123"
+
+# Update code file content
+npx unframer mcp updateCodeFile --codeFileId "code123" --content "// updated code"
+```
+
+Run any command with `--help` for detailed options:
+
+```sh
+npx unframer mcp updateXmlForNode --help
+```

package/dist/cli-readonly-server-api.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-readonly-server-api.test.d.ts.map

package/dist/cli-readonly-server-api.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-readonly-server-api.test.d.ts","sourceRoot":"","sources":["../src/cli-readonly-server-api.test.ts"],"names":[],"mappings":""}

package/dist/cli-readonly-server-api.test.js

@@ -0,0 +1,96 @@
+// Read-only integration checks for server-api CLI commands and reconnect latency.
+import childProcess from 'node:child_process';
+import process from 'node:process';
+import util from 'node:util';
+import { expect, test } from 'vitest';
+const execFile = util.promisify(childProcess.execFile);
+const defaultProjectUrl = 'https://framer.com/projects/Framer-MCP-project-Designor-Framer-Template-copy--lfAw10qcrLpLLEznmZmo-irrP1?node=CpFAHygNJ';
+const hasApiKey = Boolean(process.env.FRAMER_API_KEY);
+function sleep({ ms }) {
+    return new Promise((resolve) => {
+        setTimeout(() => {
+            resolve();
+        }, ms);
+    });
+}
+async function runServerApiCliReadOnly({ args, timeoutMs = 180_000, }) {
+    const projectUrl = process.env.FRAMER_PROJECT_URL || defaultProjectUrl;
+    const startMs = performance.now();
+    const { stdout, stderr } = await execFile('pnpm', ['tsx', 'src/bin.ts', ...args, '--project', projectUrl], {
+        cwd: process.cwd(),
+        env: process.env,
+        timeout: timeoutMs,
+        maxBuffer: 8 * 1024 * 1024,
+    });
+    return {
+        stdout,
+        stderr,
+        durationMs: performance.now() - startMs,
+    };
+}
+async function runServerApiCliReadOnlyWithRetry({ args, timeoutMs = 180_000, attempt = 1, maxAttempts = 3, }) {
+    try {
+        return await runServerApiCliReadOnly({ args, timeoutMs });
+    }
+    catch (error) {
+        if (attempt >= maxAttempts) {
+            throw error;
+        }
+        await sleep({ ms: 1_000 * attempt });
+        return runServerApiCliReadOnlyWithRetry({
+            args,
+            timeoutMs,
+            attempt: attempt + 1,
+            maxAttempts,
+        });
+    }
+}
+function extractJsonFromCliOutput({ output }) {
+    const jsonStart = output.indexOf('{');
+    if (jsonStart < 0) {
+        throw new Error(`Could not find JSON in CLI output:\n${output}`);
+    }
+    return JSON.parse(output.slice(jsonStart));
+}
+test.skipIf(!hasApiKey)('server-api read-only cli commands return expected output', async () => {
+    const websiteRun = await runServerApiCliReadOnly({
+        args: ['mcp', 'getProjectWebsiteUrl'],
+    });
+    const website = extractJsonFromCliOutput({ output: websiteRun.stdout });
+    expect(Object.keys(website).length).toBeGreaterThan(0);
+    const websiteJson = JSON.stringify(website);
+    expect(websiteJson.includes('https://')).toBe(true);
+    expect(websiteRun.stderr.includes('Running getProjectWebsiteUrl')).toBe(true);
+    const xmlRun = await runServerApiCliReadOnly({
+        args: ['mcp', 'getProjectXml'],
+    });
+    expect(xmlRun.stdout.includes('# Project structure:')).toBe(true);
+    expect(xmlRun.stdout.includes('<Project>')).toBe(true);
+    expect(xmlRun.stderr.includes('Running getProjectXml')).toBe(true);
+    const selectedNodesRun = await runServerApiCliReadOnly({
+        args: ['mcp', 'getSelectedNodesXml'],
+    });
+    expect(selectedNodesRun.stdout.includes('No nodes are currently selected.')).toBe(true);
+    const focusedNodeMatch = xmlRun.stdout.match(/currently focused [^`]* ID is: `([^`]+)`/);
+    const focusedNodeId = focusedNodeMatch?.[1];
+    expect(Boolean(focusedNodeId)).toBe(true);
+    const zoomRun = await runServerApiCliReadOnly({
+        args: ['mcp', 'zoomIntoView', '--nodeId', focusedNodeId || ''],
+    });
+    expect(zoomRun.stdout.includes('Zoomed into view for node')).toBe(true);
+}, 180_000);
+test.skipIf(!hasApiKey)('server-api reconnects cleanly for repeated read-only calls', async () => {
+    const firstRun = await runServerApiCliReadOnly({
+        args: ['mcp', 'getProjectWebsiteUrl'],
+    });
+    const secondRun = await runServerApiCliReadOnlyWithRetry({
+        args: ['mcp', 'getProjectWebsiteUrl'],
+    });
+    expect(firstRun.durationMs).toBeGreaterThan(0);
+    expect(secondRun.durationMs).toBeGreaterThan(0);
+    expect(firstRun.durationMs).toBeLessThan(120_000);
+    expect(secondRun.durationMs).toBeLessThan(120_000);
+    const reconnectDeltaMs = secondRun.durationMs - firstRun.durationMs;
+    console.info(`getProjectWebsiteUrl latency ms: first=${firstRun.durationMs.toFixed(0)}, second=${secondRun.durationMs.toFixed(0)}, delta=${reconnectDeltaMs.toFixed(0)}`);
+}, 240_000);
+//# sourceMappingURL=cli-readonly-server-api.test.js.map

package/dist/cli-readonly-server-api.test.js.map

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

package/dist/cli.d.ts

@@ -1,7 +1,7 @@
 import './sentry.js';
 import { StyleToken } from './exporter.js';
 import { BreakpointSizes } from './css.js';
-export declare const cli: import("@xmorse/cac").CAC;
+export declare const cli: import("goke").Goke;
 export type Config = {
     jsx?: boolean;
     components: {

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,aAAa,CAAA;AAGpB,OAAO,EAAU,UAAU,EAA8B,MAAM,eAAe,CAAA;AAU9E,OAAO,EAAE,eAAe,EAA0B,MAAM,UAAU,CAAA;AAmBlE,eAAO,MAAM,GAAG,2BAAkB,CAAA;AAgVlC,MAAM,MAAM,MAAM,GAAG;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,UAAU,EAAE;QACR,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KACzB,CAAA;IACD,oBAAoB,CAAC,EAAE;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,aAAa,EAAE,MAAM,CAAA;QACrB,cAAc,EAAE,MAAM,CAAA;QACtB,KAAK,EAAE,MAAM,CAAA;KAChB,EAAE,CAAA;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;QACrB,IAAI,EAAE,MAAM,CAAA;KACf,EAAE,CAAA;IAEH,OAAO,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACf,EAAE,CAAA;IACH,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6BAA6B,EAAE,uBAAuB,EAAE,CAAA;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAE/B,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IAEjB,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAsB,eAAe,CAAC,EAClC,SAAS,EACT,gBAAiC,EACjC,WAAmB,EACnB,KAAU,EACV,MAAwC,EAC3C;;;;;;CAAA;;;;GAyHA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,OAAO,aAAa,CAAA;AAGpB,OAAO,EAAU,UAAU,EAA8B,MAAM,eAAe,CAAA;AAU9E,OAAO,EAAE,eAAe,EAA0B,MAAM,UAAU,CAAA;AAsBlE,eAAO,MAAM,GAAG,qBAAmB,CAAA;AAkkBnC,MAAM,MAAM,MAAM,GAAG;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,UAAU,EAAE;QACR,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KACzB,CAAA;IACD,oBAAoB,CAAC,EAAE;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,aAAa,EAAE,MAAM,CAAA;QACrB,cAAc,EAAE,MAAM,CAAA;QACtB,KAAK,EAAE,MAAM,CAAA;KAChB,EAAE,CAAA;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;QACrB,IAAI,EAAE,MAAM,CAAA;KACf,EAAE,CAAA;IAEH,OAAO,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACf,EAAE,CAAA;IACH,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6BAA6B,EAAE,uBAAuB,EAAE,CAAA;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAE/B,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IAEjB,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAsB,eAAe,CAAC,EAClC,SAAS,EACT,gBAAiC,EACjC,WAAmB,EACnB,KAAU,EACV,MAAwC,EAC3C;;;;;;CAAA;;;;GAyHA"}

package/dist/cli.js

@@ -1,14 +1,15 @@
+import { z } from 'zod';
 import { setMaxListeners } from 'events';
 import pkg from '../package.json' with { type: 'json' };
 import pico from 'picocolors';
 const { blue, bgBlue, green } = pico;
 import { fetch } from 'undici';
 import './sentry.js';
-import { input } from '@inquirer/prompts';
+import { input, select, password } from '@inquirer/prompts';
 import { bundle, createExampleComponentCode } from './exporter.js';
 import { createClient } from './generated/api-client.js';
 import { generateStackblitzFiles } from './stackblitz.js';
-import { cac } from '@xmorse/cac';
+import { goke, wrapJsonSchema } from 'goke';
 import { exec } from 'child_process';
 import { promisify } from 'util';
 import fs from 'fs';
@@ -18,27 +19,22 @@ import { componentNameToPath, dedent, isTruthy, logger, sleep, spinner, } from '
 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 { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { loadConfig, saveConfig, getConfigPath, } from './config.js';
+import { addMcpCommands } from '@goke/mcp';
 const configNames = ['unframer.config.json', 'unframer.json'];
-export const cli = cac('unframer');
+export const cli = goke('unframer');
 let defaultOutDir = 'framer';
 cli.command('[projectId]', 'Run unframer with optional project ID')
-    .option('--outDir <dir>', 'Output directory', { default: defaultOutDir })
-    .option('--external [package]', 'Make some package external, do not pass a package name to make all packages external', {
-    default: true,
-})
-    .option('--watch', 'Watch for changes and rebuild', { default: false })
-    .option('--jsx', 'Output jsx code instead of minified .js code', {
-    default: true,
-})
-    .option('--debug', 'Enable debug logging', { default: false })
-    .option('--metafile', 'Generate meta.json file with build metadata', {
-    default: false,
-})
+    .option('--outDir <dir>', 'Output directory')
+    .option('--external [package]', 'Make some package external, do not pass a package name to make all packages external')
+    .option('--watch', 'Watch for changes and rebuild')
+    .option('--jsx', 'Output jsx code instead of minified .js code')
+    .option('--debug', 'Enable debug logging')
+    .option('--metafile', 'Generate meta.json file with build metadata')
     .action(async function main(projectId, options) {
-    const external_ = options.external;
+    const outDir = options.outDir || defaultOutDir;
+    const jsx = options.jsx ?? true;
+    const external_ = options.external ?? true;
     const allExternal = external_ === true;
     const externalPackages = Array.isArray(external_)
         ? external_.filter((x) => x.trim())
@@ -49,7 +45,6 @@ cli.command('[projectId]', 'Run unframer with optional project ID')
         if (options.debug) {
             logger.debug = true;
         }
-        const outDir = options.outDir;
         const controller = new AbortController();
         const signal = controller.signal;
         const watch = options.watch;
@@ -60,7 +55,6 @@ cli.command('[projectId]', 'Run unframer with optional project ID')
                 outDir,
                 projectId,
             });
-            let jsx = options.jsx;
             const { rebuild, buildContext } = await bundle({
                 config: {
                     jsx,
@@ -149,16 +143,14 @@ function fixOldUnframerPath() {
 const version = pkg.version;
 cli.version(version).help();
 cli.command('example-app <projectId>', 'Create an example app with Framer components')
-    .option('--outDir <dir>', 'Output directory', {
-    default: 'example-unframer-app',
-})
+    .option('--outDir <dir>', 'Output directory')
     .action(async (projectId, options) => {
     if (!projectId?.trim()) {
         console.log(`unframer example-app requires a project id positional param`);
         process.exit(1);
     }
     try {
-        const outDir = options.outDir;
+        const outDir = options.outDir || 'example-unframer-app';
         console.log(`Creating example app in ${outDir}`);
         // Create the output directory
         const absoluteOutDir = path.resolve(process.cwd(), outDir);
@@ -257,52 +249,238 @@ cli.command('example-app <projectId>', 'Create an example app with Framer compon
         throw error;
     }
 });
-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) => {
-    // 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:' });
+cli.command('mcp login [url]', 'Login to Framer MCP. Choose between plugin mode (requires Framer open) or server API mode (works headlessly with API key).').action(async (url) => {
+    try {
+        // If URL is passed directly, use plugin mode
+        if (url) {
+            saveConfig({ mode: 'plugin', mcpUrl: url });
+            console.log(`MCP URL saved to ${getConfigPath()}`);
+            console.log(`Run \`unframer --help\` to see all available MCP commands`);
+            return;
         }
-        catch (error) {
-            // Handle Ctrl+C gracefully
-            if (error instanceof Error && error.name === 'ExitPromptError') {
-                process.exit(0);
+        // Show mode selection dropdown
+        const mode = await select({
+            message: 'Select authentication mode:',
+            choices: [
+                {
+                    value: 'plugin',
+                    name: 'MCP Plugin (Recommended)',
+                    description: 'Requires Framer to be open with MCP plugin running. Paste URL from plugin.',
+                },
+                {
+                    value: 'server-api',
+                    name: 'Server API',
+                    description: 'Works without Framer open. Requires API key from project settings.',
+                },
+            ],
+        });
+        if (mode === 'plugin') {
+            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');
+            const mcpUrl = await input({ message: 'Paste MCP URL:' });
+            if (!mcpUrl) {
+                console.error('MCP URL is required');
+                process.exit(1);
+            }
+            saveConfig({ mode: 'plugin', mcpUrl });
+            console.log(`\nMCP URL saved to ${getConfigPath()}`);
+            console.log(`Run \`unframer --help\` to see all available MCP commands`);
+        }
+        else {
+            // Server API mode
+            console.log('\nTo get your API key:');
+            console.log('  1. Open your Framer project at https://framer.com/projects');
+            console.log('  2. Go to Project Settings > API');
+            console.log('  3. Generate or copy your API key\n');
+            const apiKey = await password({ message: 'Enter Framer API key:', mask: '*' });
+            if (!apiKey) {
+                console.error('API key is required');
+                process.exit(1);
+            }
+            console.log('\nTo get your project URL:');
+            console.log('  Copy the URL from your browser when viewing the project');
+            console.log('  Example: https://framer.com/projects/MyProject--abc123\n');
+            const projectUrl = await input({
+                message: 'Enter Framer project URL (optional, can use --project later):',
+            });
+            saveConfig({
+                mode: 'server-api',
+                framerApiKey: apiKey,
+                framerProjectUrl: projectUrl || undefined,
+            });
+            console.log(`\nServer API credentials saved to ${getConfigPath()}`);
+            console.log(`\nUsage:`);
+            if (projectUrl) {
+                console.log(`  unframer mcp getProjectXml`);
+            }
+            else {
+                console.log(`  unframer mcp getProjectXml --project "https://framer.com/projects/..."`);
             }
-            throw error;
+            console.log(`\nOr set FRAMER_PROJECT_URL environment variable`);
         }
     }
-    if (!mcpUrl) {
-        console.error('MCP URL is required');
-        process.exit(1);
+    catch (error) {
+        if (error instanceof Error && error.name === 'ExitPromptError') {
+            process.exit(0);
+        }
+        throw error;
     }
-    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) => {
-        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');
+// Add MCP tool commands
+const config = loadConfig();
+const cliArgs = process.argv.slice(2);
+const hasMcpCommand = cliArgs.includes('mcp');
+const hasProjectOption = cliArgs.some((arg) => {
+    return arg === '--project' || arg.startsWith('--project=');
+});
+const shouldUseServerApiForProjectOption = hasMcpCommand && hasProjectOption;
+const mcpMode = shouldUseServerApiForProjectOption
+    ? 'server-api'
+    : config.mode || (config.mcpUrl ? 'plugin' : undefined);
+if (mcpMode === 'server-api') {
+    // Server API mode - use framer-api directly
+    // Commands are registered via registerServerApiCommands below
+    await registerServerApiCommands();
+}
+else {
+    // Plugin mode - use MCP transport
+    await addMcpCommands({
+        cli,
+        commandPrefix: 'mcp',
+        getMcpTransport: async (sessionId) => {
+            const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+            // UNFRAMER_MCP_URL env var overrides config file (contains full URL with auth)
+            const mcpUrl = process.env.UNFRAMER_MCP_URL || loadConfig().mcpUrl;
+            if (!mcpUrl) {
+                return null;
+            }
+            const url = new URL(mcpUrl);
+            // Use /mcp endpoint for StreamableHTTP
+            if (url.pathname.endsWith('/sse')) {
+                url.pathname = url.pathname.replace(/\/sse$/, '/mcp');
+            }
+            return new StreamableHTTPClientTransport(url, { sessionId });
+        },
+        loadCache: () => {
+            return loadConfig().cachedMcpTools;
+        },
+        saveCache: (cache) => {
+            const configNow = loadConfig();
+            saveConfig({ ...configNow, cachedMcpTools: cache });
+        },
+    }).catch((e) => console.error(e));
+}
+/**
+ * Register MCP commands for server-api mode using framer-api directly.
+ * This bypasses the MCP transport and calls handlers directly.
+ */
+async function registerServerApiCommands() {
+    // Dynamic import to avoid loading framer-api in plugin mode
+    const { connect } = await import('framer-api');
+    // Import tool definitions and handler from plugin-mcp
+    // Note: Run `pnpm --filter plugin-mcp build && pnpm --filter plugin-mcp gen-unframer` first
+    const { mcpTools, mcpToolHandler } = await import('./plugin-mcp-dist/lib/mcp-handlers.js');
+    if (!mcpTools || !mcpToolHandler) {
+        return;
+    }
+    // Register a command for each MCP tool
+    for (const [toolName, toolDef] of Object.entries(mcpTools)) {
+        const cmd = cli.command(`mcp ${toolName}`, toolDef.description.split('\n')[0]);
+        cmd.option('--project <url>', 'Framer project URL. Uses server-api mode (framer-api headless). Works alongside plugin mode login, pass --project to switch to server-api for a single command. Also reads FRAMER_PROJECT_URL env var.');
+        // Add options based on tool input schema, using zod v4 native JSON Schema conversion
+        const inputSchema = toolDef.input;
+        if (inputSchema) {
+            const jsonSchema = z.toJSONSchema(inputSchema);
+            const properties = jsonSchema.properties || {};
+            const required = new Set(jsonSchema.required || []);
+            for (const [key, prop] of Object.entries(properties)) {
+                const isRequired = required.has(key);
+                const isBooleanType = prop.type === 'boolean';
+                const optionName = isBooleanType
+                    ? `--${key}`
+                    : `--${key} <value>`;
+                const optionDescription = [
+                    prop.description || key,
+                    isRequired ? '(required)' : '',
+                ]
+                    .filter(Boolean)
+                    .join(' ');
+                if (isBooleanType && prop.default === undefined) {
+                    cmd.option(optionName, optionDescription);
+                    continue;
+                }
+                cmd.option(optionName, wrapJsonSchema({
+                    ...prop,
+                    description: optionDescription,
+                }));
+            }
         }
-        return new StreamableHTTPClientTransport(url, { sessionId });
-    },
-}).catch(e => console.error(e));
+        cmd.action(async (options) => {
+            const projectOption = typeof options.project === 'string'
+                ? options.project
+                : undefined;
+            const projectUrl = projectOption ||
+                process.env.FRAMER_PROJECT_URL ||
+                loadConfig().framerProjectUrl;
+            const apiKey = process.env.FRAMER_API_KEY || loadConfig().framerApiKey;
+            if (!projectUrl) {
+                console.error('Project URL required. Use --project option, FRAMER_PROJECT_URL env var, or set during login.');
+                process.exit(1);
+            }
+            if (!apiKey) {
+                console.error('API key required. Set FRAMER_API_KEY env var or run `unframer mcp login` first.');
+                process.exit(1);
+            }
+            // Remove CLI-specific options from input
+            const toolInput = Object.fromEntries(Object.entries(options).filter(([key]) => {
+                return key !== 'project';
+            }));
+            const globalWithFramer = globalThis;
+            let framerClient = undefined;
+            let actionError = undefined;
+            try {
+                spinner.start(`Connecting to Framer...`);
+                framerClient = await connect(projectUrl, apiKey);
+                // Set global framer for utility functions that use it
+                globalWithFramer.framer = framerClient;
+                spinner.start(`Running ${toolName}...`);
+                const result = await mcpToolHandler({
+                    type: toolName,
+                    input: toolInput,
+                });
+                spinner.stop('');
+                // Output result
+                if (typeof result === 'string') {
+                    console.log(result);
+                }
+                else {
+                    console.log(JSON.stringify(result, null, 2));
+                }
+            }
+            catch (error) {
+                actionError = error;
+            }
+            finally {
+                if (framerClient) {
+                    try {
+                        await framerClient.disconnect();
+                    }
+                    catch (disconnectError) {
+                        logger.error('Failed disconnecting from Framer:', disconnectError);
+                    }
+                }
+                delete globalWithFramer.framer;
+            }
+            if (actionError) {
+                spinner.error(`Failed: ${actionError instanceof Error ? actionError.message : String(actionError)}`);
+                process.exit(1);
+            }
+        });
+    }
+}
 export async function configFromFetch({ projectId, externalPackages = [], allExternal = false, agent = '', outDir = undefined, }) {
     logger.log(`Fetching config for project ${projectId}`);
     const url = process.env.UNFRAMER_SERVER_URL;