@blockrun/franklin 3.3.1 → 3.3.2

package/dist/commands/migrate.js

@@ -96,8 +96,28 @@ function migrateMcp(source) {
     // Claude Code format: { mcpServers: { name: { command, args, env } } }
     // Franklin format:    { mcpServers: { name: { transport, command, args, label } } }
     const servers = {};
+    const skipped = [];
     if (raw.mcpServers) {
         for (const [name, config] of Object.entries(raw.mcpServers)) {
+            // Skip MCP servers that require external credentials (OAuth, API keys,
+            // tokens) — importing them causes noisy startup errors because the
+            // credentials aren't available in Franklin's context. Users can add
+            // these manually via ~/.blockrun/mcp.json if they set up the credentials.
+            const configStr = JSON.stringify(config).toLowerCase();
+            const needsCredentials = configStr.includes('oauth') ||
+                configStr.includes('credential') ||
+                configStr.includes('api_key') ||
+                configStr.includes('api-key') ||
+                configStr.includes('token') ||
+                name.includes('calendar') ||
+                name.includes('gmail') ||
+                name.includes('google') ||
+                name.includes('slack') ||
+                name.includes('notion');
+            if (needsCredentials) {
+                skipped.push(name);
+                continue;
+            }
             servers[name] = {
                 transport: config.transport || 'stdio',
                 command: config.command,
@@ -123,7 +143,11 @@ function migrateMcp(source) {
     };
     fs.mkdirSync(BLOCKRUN_DIR, { recursive: true });
     fs.writeFileSync(target, JSON.stringify(merged, null, 2));
-    console.log(chalk.green(`    ✓ ${Object.keys(servers).length} MCP server(s) imported`));
+    const importedCount = Object.keys(servers).length;
+    console.log(chalk.green(`    ✓ ${importedCount} MCP server(s) imported`));
+    if (skipped.length > 0) {
+        console.log(chalk.dim(`    · ${skipped.length} skipped (need credentials): ${skipped.join(', ')}`));
+    }
 }
 function migrateInstructions(source) {
     // Read CLAUDE.md and convert key preferences to learnings

package/dist/mcp/config.js

@@ -86,6 +86,34 @@ export function loadMcpConfig(workDir) {
     catch {
         // Ignore corrupt project config
     }
+    // Filter out servers whose required credential files are missing.
+    // This prevents noisy startup errors from MCP servers that were imported
+    // (e.g. via `franklin migrate`) but don't have credentials configured yet.
+    // The server stays in the config file — it just gets auto-disabled until
+    // the user provides the credentials.
+    for (const [name, config] of Object.entries(servers)) {
+        if (config.disabled)
+            continue;
+        const env = (config.env || {});
+        const args = (config.args || []);
+        const configStr = JSON.stringify(config).toLowerCase();
+        // Check if any env var points to a file that doesn't exist
+        let missingFile = false;
+        for (const [, val] of Object.entries(env)) {
+            if (typeof val === 'string' && (val.endsWith('.json') || val.endsWith('.key') || val.endsWith('.pem'))) {
+                if (!fs.existsSync(val)) {
+                    missingFile = true;
+                    break;
+                }
+            }
+        }
+        // Check for common credential-dependent patterns in config
+        const needsAuth = missingFile ||
+            (configStr.includes('oauth') && !args.some(a => fs.existsSync(a)));
+        if (needsAuth) {
+            servers[name].disabled = true;
+        }
+    }
     return { mcpServers: servers };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.3.1",
+  "version": "3.3.2",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {