@hubspot/cli 7.7.3-experimental.0 → 7.7.5-experimental.0

package/bin/cli.js

@@ -44,6 +44,7 @@ const feedback_1 = __importDefault(require("../commands/feedback"));
 const doctor_1 = __importDefault(require("../commands/doctor"));
 const completion_1 = __importDefault(require("../commands/completion"));
 const app_1 = __importDefault(require("../commands/app"));
+const mcp_1 = __importDefault(require("../commands/mcp"));
 function getTerminalWidth() {
     const width = yargs_1.default.terminalWidth();
     if (width >= 100)
@@ -122,6 +123,7 @@ const argv = yargs_1.default
     .command(doctor_1.default)
     .command(completion_1.default)
     .command(app_1.default)
+    .command(mcp_1.default)
     .help()
     .alias('h', 'help')
     .recommendCommands()

package/commands/account/auth.d.ts

@@ -1,6 +1,8 @@
 import { CommonArgs, ConfigArgs, YargsCommandModule } from '../../types/Yargs';
 type AccountAuthArgs = CommonArgs & ConfigArgs & {
     disableTracking?: boolean;
+} & {
+    personalAccessKey?: string;
 };
 declare const accountAuthCommand: YargsCommandModule<unknown, AccountAuthArgs>;
 export default accountAuthCommand;

package/commands/account/auth.js

@@ -26,12 +26,14 @@ const TRACKING_STATUS = {
     COMPLETE: 'complete',
 };
 const authType = auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value;
-async function updateConfigWithNewAccount(env, configAlreadyExists, accountId) {
+async function updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId) {
     try {
-        const { personalAccessKey } = await (0, personalAccessKeyPrompt_1.personalAccessKeyPrompt)({
-            env,
-            account: accountId,
-        });
+        const { personalAccessKey } = providedPersonalAccessKey
+            ? { personalAccessKey: providedPersonalAccessKey }
+            : await (0, personalAccessKeyPrompt_1.personalAccessKeyPrompt)({
+                env,
+                account: accountId,
+            });
         const token = await (0, personalAccessKey_1.getAccessToken)(personalAccessKey, env);
         const defaultAccountName = token.hubName
             ? (0, text_1.toKebabCase)(token.hubName)
@@ -96,7 +98,7 @@ async function handleConfigMigration() {
 const describe = en_1.commands.account.subcommands.auth.describe;
 const command = 'auth';
 async function handler(args) {
-    const { providedAccountId, disableTracking } = args;
+    const { providedAccountId, disableTracking, personalAccessKey: providedPersonalAccessKey, } = args;
     if (!disableTracking) {
         (0, usageTracking_1.trackCommandUsage)('account-auth', {}, providedAccountId);
         await (0, usageTracking_1.trackAuthAction)('account-auth', authType, TRACKING_STATUS.STARTED);
@@ -112,7 +114,7 @@ async function handler(args) {
     }
     (0, config_1.loadConfig)('');
     (0, process_1.handleExit)(config_1.deleteEmptyConfigFile);
-    const updatedConfig = await updateConfigWithNewAccount(args.qa ? environments_1.ENVIRONMENTS.QA : environments_1.ENVIRONMENTS.PROD, configAlreadyExists, providedAccountId);
+    const updatedConfig = await updateConfigWithNewAccount(args.qa ? environments_1.ENVIRONMENTS.QA : environments_1.ENVIRONMENTS.PROD, configAlreadyExists, providedPersonalAccessKey, providedAccountId);
     if (!updatedConfig) {
         if (!disableTracking) {
             await (0, usageTracking_1.trackAuthAction)('account-auth', authType, TRACKING_STATUS.ERROR);
@@ -151,6 +153,12 @@ function accountAuthBuilder(yargs) {
             hidden: true,
             default: false,
         },
+        'personal-access-key': {
+            describe: en_1.commands.account.subcommands.auth.options.personalAccessKey,
+            type: 'string',
+            hidden: false,
+            alias: 'pak',
+        },
     });
     return yargs;
 }

package/commands/auth.d.ts

@@ -1,6 +1,8 @@
 import { AccountArgs, CommonArgs, ConfigArgs, TestingArgs, YargsCommandModule } from '../types/Yargs';
 type AuthArgs = CommonArgs & ConfigArgs & TestingArgs & AccountArgs & {
     authType?: string;
+} & {
+    personalAccessKey?: string;
 };
 declare const authCommand: YargsCommandModule<unknown, AuthArgs>;
 export default authCommand;

package/commands/auth.js

@@ -20,6 +20,7 @@ const oauth_1 = require("../lib/oauth");
 const exitCodes_1 = require("../lib/enums/exitCodes");
 const ui_1 = require("../lib/ui");
 const index_1 = require("../lib/errorHandlers/index");
+const en_1 = require("../lang/en");
 const TRACKING_STATUS = {
     STARTED: 'started',
     ERROR: 'error',
@@ -33,7 +34,7 @@ const SUPPORTED_AUTHENTICATION_PROTOCOLS_TEXT = (0, text_1.commaSeparatedValues)
 const command = 'auth';
 const describe = (0, lang_1.i18n)('commands.auth.describe');
 async function handler(args) {
-    const { authType: authTypeFlagValue, config: configFlagValue, qa, providedAccountId, } = args;
+    const { authType: authTypeFlagValue, config: configFlagValue, qa, providedAccountId, personalAccessKey: providedPersonalAccessKey, } = args;
     const authType = (authTypeFlagValue && authTypeFlagValue.toLowerCase()) ||
         auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value;
     (0, commonOpts_1.setLogLevel)(args);
@@ -68,14 +69,16 @@ async function handler(args) {
             successAuthMethod = auth_1.OAUTH_AUTH_METHOD.name;
             break;
         case auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value:
-            configData = await (0, personalAccessKeyPrompt_1.personalAccessKeyPrompt)({
-                env,
-                account: providedAccountId,
-            });
+            const { personalAccessKey } = providedPersonalAccessKey
+                ? { personalAccessKey: providedPersonalAccessKey }
+                : await (0, personalAccessKeyPrompt_1.personalAccessKeyPrompt)({
+                    env,
+                    account: providedAccountId,
+                });
             try {
-                token = await (0, personalAccessKey_1.getAccessToken)(configData.personalAccessKey, env);
+                token = await (0, personalAccessKey_1.getAccessToken)(personalAccessKey, env);
                 defaultName = token.hubName ? (0, text_1.toKebabCase)(token.hubName) : undefined;
-                updatedConfig = await (0, personalAccessKey_1.updateConfigWithAccessToken)(token, configData.personalAccessKey, env);
+                updatedConfig = await (0, personalAccessKey_1.updateConfigWithAccessToken)(token, personalAccessKey, env);
             }
             catch (e) {
                 (0, index_1.logError)(e);
@@ -108,7 +111,7 @@ async function handler(args) {
         await (0, usageTracking_1.trackAuthAction)('auth', authType, TRACKING_STATUS.ERROR, providedAccountId);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    const nameFromConfigData = 'name' in configData ? configData.name : undefined;
+    const nameFromConfigData = configData && 'name' in configData ? configData.name : undefined;
     const accountName = (updatedConfig && updatedConfig.name) || validName || nameFromConfigData;
     await (0, setAsDefaultAccountPrompt_1.setAsDefaultAccountPrompt)(accountName);
     logger_1.logger.success((0, lang_1.i18n)('commands.auth.success.configFileUpdated', {
@@ -141,6 +144,12 @@ function authBuilder(yargs) {
             type: 'string',
             alias: 'a',
         },
+        'personal-access-key': {
+            describe: en_1.commands.auth.options.personalAccessKey.describe,
+            type: 'string',
+            hidden: false,
+            alias: 'pak',
+        },
     });
     return yargs;
 }

package/commands/hubdb/list.d.ts

@@ -0,0 +1,4 @@
+import { CommonArgs, ConfigArgs, AccountArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs';
+type HubdbListArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs;
+declare const hubdbListCommand: YargsCommandModule<unknown, HubdbListArgs>;
+export default hubdbListCommand;

package/commands/hubdb/list.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const hubdb_1 = require("@hubspot/local-dev-lib/api/hubdb");
+const config_1 = require("@hubspot/local-dev-lib/config");
+const urls_1 = require("@hubspot/local-dev-lib/urls");
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const logger_1 = require("../../lib/ui/logger");
+const index_1 = require("../../lib/errorHandlers/index");
+const en_1 = require("../../lang/en");
+const yargsUtils_1 = require("../../lib/yargsUtils");
+const usageTracking_1 = require("../../lib/usageTracking");
+const table_1 = require("../../lib/ui/table");
+const command = ['list', 'ls'];
+const describe = en_1.commands.hubdb.subcommands.list.describe;
+async function getTableData(accountId) {
+    try {
+        const response = await (0, hubdb_1.fetchTables)(accountId);
+        return response.data;
+    }
+    catch (err) {
+        (0, index_1.logError)(err);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+}
+// stripping the types and unnecessary fields so this data can be turned into a UI table
+function mapTablesToUI(tables) {
+    return tables.map(({ id, label, name, columnCount, rowCount }) => [
+        `${id}`,
+        label,
+        name,
+        `${columnCount || 0}`,
+        `${rowCount}`,
+    ]);
+}
+async function handler(args) {
+    const { derivedAccountId } = args;
+    (0, usageTracking_1.trackCommandUsage)('hubdb-list', {}, derivedAccountId);
+    const { results: tables, total } = await getTableData(derivedAccountId);
+    const tableUIData = mapTablesToUI(tables);
+    tableUIData.unshift((0, table_1.getTableHeader)([
+        en_1.commands.hubdb.subcommands.list.labels.id,
+        en_1.commands.hubdb.subcommands.list.labels.label,
+        en_1.commands.hubdb.subcommands.list.labels.name,
+        en_1.commands.hubdb.subcommands.list.labels.columns,
+        en_1.commands.hubdb.subcommands.list.labels.rows,
+    ]));
+    logger_1.uiLogger.success(en_1.commands.hubdb.subcommands.list.success(derivedAccountId));
+    logger_1.uiLogger.log(' ');
+    // link devs to the hubdb page in hubspot for easy access
+    // TODO: This is hacky, we should make a util like getBaseUrl()
+    const baseUrl = (0, urls_1.getHubSpotWebsiteOrigin)((0, config_1.getEnv)());
+    logger_1.uiLogger.log(en_1.commands.hubdb.subcommands.list.viewTablesLink(baseUrl, derivedAccountId));
+    // don't bother showing an empty list of tables
+    if (tables.length > 0) {
+        // if truncated is 0, it will be interpreted as falsy
+        const truncated = total - tables.length;
+        logger_1.uiLogger.log(en_1.commands.hubdb.subcommands.list.tablesDisplayed(tables.length, total, truncated));
+        logger_1.uiLogger.log('--------------------------------');
+        logger_1.uiLogger.log(en_1.commands.hubdb.subcommands.list.tables);
+        logger_1.uiLogger.log((0, table_1.getTableContents)(tableUIData, { border: { bodyLeft: '  ' } }));
+    }
+    else {
+        logger_1.uiLogger.log(en_1.commands.hubdb.subcommands.list.noTables(derivedAccountId));
+    }
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+}
+function hubdbListBuilder(yargs) {
+    yargs.example([['$0 hubdb list']]);
+    return yargs;
+}
+const builder = (0, yargsUtils_1.makeYargsBuilder)(hubdbListBuilder, command, describe, {
+    useGlobalOptions: true,
+    useConfigOptions: true,
+    useAccountOptions: true,
+    useEnvironmentOptions: true,
+});
+const hubdbListCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = hubdbListCommand;

package/commands/hubdb.js

@@ -8,6 +8,7 @@ const create_1 = __importDefault(require("./hubdb/create"));
 const fetch_1 = __importDefault(require("./hubdb/fetch"));
 const delete_1 = __importDefault(require("./hubdb/delete"));
 const clear_1 = __importDefault(require("./hubdb/clear"));
+const list_1 = __importDefault(require("./hubdb/list"));
 const lang_1 = require("../lib/lang");
 const yargsUtils_1 = require("../lib/yargsUtils");
 exports.command = 'hubdb';
@@ -18,6 +19,7 @@ function hubdbBuilder(yargs) {
         .command(create_1.default)
         .command(fetch_1.default)
         .command(delete_1.default)
+        .command(list_1.default)
         .demandCommand(1, '');
     return yargs;
 }

package/commands/mcp/setup.d.ts

@@ -0,0 +1,13 @@
+import { ArgumentsCamelCase, Argv } from 'yargs';
+interface MCPSetupArgs {
+    targets?: string[];
+}
+declare function builder(yargs: Argv): Argv;
+declare function handler(argv: ArgumentsCamelCase<MCPSetupArgs>): Promise<void>;
+declare const _default: {
+    command: string[];
+    describe: string;
+    builder: typeof builder;
+    handler: typeof handler;
+};
+export default _default;

package/commands/mcp/setup.js

@@ -0,0 +1,248 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const SpinniesManager_1 = __importDefault(require("../../lib/ui/SpinniesManager"));
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const promptUtils_1 = require("../../lib/prompts/promptUtils");
+const chalk_1 = __importDefault(require("chalk"));
+const command = ['setup', 'update'];
+const describe = 'Add or update MCP server configuration to claude and cursor';
+const mcpServerPath = path_1.default.join(os_1.default.homedir(), 'src', 'hubspot-cli', 'dist', 'mcp-server', 'server.js');
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const supportedTools = [
+    { name: 'Claude', value: 'claude' },
+    { name: 'Claude Desktop', value: 'claude-desktop' },
+    { name: 'Cursor', value: 'cursor' },
+];
+function builder(yargs) {
+    yargs.option('targets', {
+        describe: 'Target application to configure',
+        type: 'array',
+        choices: [...supportedTools.map(tool => tool.value)],
+    });
+    return yargs;
+}
+async function handler(argv) {
+    await addMcpServerToConfig(argv.targets);
+}
+exports.default = { command, describe, builder, handler };
+async function addMcpServerToConfig(targets) {
+    try {
+        let derivedTargets = [];
+        if (!targets || targets.length === 0) {
+            const { selectedTargets } = await (0, promptUtils_1.promptUser)({
+                name: 'selectedTargets',
+                type: 'checkbox',
+                message: '[--targets] Which tools would you like to add the HubSpot CLI MCP server to?',
+                choices: supportedTools,
+                validate: (choices) => {
+                    return choices.length === 0 ? 'Must choose at least one tool' : true;
+                },
+            });
+            derivedTargets = selectedTargets;
+        }
+        else {
+            derivedTargets = targets;
+        }
+        SpinniesManager_1.default.init();
+        if (derivedTargets.includes('claude-desktop')) {
+            await runSetupFunction(setupClaudeDesktop);
+        }
+        if (derivedTargets.includes('claude')) {
+            await runSetupFunction(setupClaudeCode);
+        }
+        if (derivedTargets.includes('cursor')) {
+            await runSetupFunction(setupCursor);
+        }
+        logger_1.logger.info(`You can now use the HubSpot CLI tools in ${derivedTargets.join(', ')}.  ${chalk_1.default.bold('You may need to restart these tools to apply the changes')}.`);
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('mcpSetup', {
+            text: 'Failed to configure HubSpot CLI MCP server.',
+        });
+        logger_1.logger.error(error);
+    }
+}
+async function runSetupFunction(func) {
+    const result = await func();
+    if (!result) {
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+}
+async function setupClaudeDesktop() {
+    try {
+        const configPath = getClaudeDesktopConfigPath();
+        SpinniesManager_1.default.add('claudeDesktop', {
+            text: 'Configuring Claude Desktop...',
+        });
+        // eslint-disable-next-line  @typescript-eslint/no-explicit-any
+        let config = {};
+        // Read existing config if it exists
+        if (fs_1.default.existsSync(configPath)) {
+            try {
+                const configContent = fs_1.default.readFileSync(configPath, 'utf8');
+                config = JSON.parse(configContent);
+                logger_1.logger.debug(`Found existing Claude Desktop config at ${configPath}`);
+            }
+            catch (error) {
+                logger_1.logger.debug(`Could not parse existing Claude Desktop config, creating new one: ${error}`);
+            }
+        }
+        else {
+            // Create config directory if it doesn't exist
+            const configDir = path_1.default.dirname(configPath);
+            fs_1.default.mkdirSync(configDir, { recursive: true });
+            logger_1.logger.debug(`Created Claude Desktop config directory at ${configDir}`);
+        }
+        // Initialize mcpServers if it doesn't exist
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        // Add or update HubSpot CLI MCP server
+        config.mcpServers['hubspot-cli-mcp'] = {
+            // TODO: Before merging, change these to `hs mcp start` and do a test publish
+            command: 'node',
+            args: [mcpServerPath],
+        };
+        // Write the updated config
+        fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
+        SpinniesManager_1.default.succeed('claudeDesktop', {
+            text: 'Configured Claude Desktop',
+        });
+        return true;
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('claudeDesktop', {
+            text: 'Failed to configure Claude Desktop',
+        });
+        logger_1.logger.debug(`Failed to configure Claude Desktop: ${error}`);
+        return false;
+    }
+}
+async function setupClaudeCode() {
+    try {
+        SpinniesManager_1.default.add('claudeCode', {
+            text: 'Configuring Claude Code...',
+        });
+        try {
+            // Check if claude command is available
+            await execAsync('claude --version');
+            // Run claude mcp add command
+            const mcpConfig = JSON.stringify({
+                type: 'stdio',
+                // TODO: Before merging, change these to `hs mcp start` and do a test publish
+                command: 'node',
+                args: [mcpServerPath],
+            });
+            const { stdout } = await execAsync('claude mcp list');
+            if (stdout.includes('hubspot-cli-mcp')) {
+                SpinniesManager_1.default.update('claudeCode', {
+                    text: 'CLI mcp server already installed, reinstalling',
+                });
+                try {
+                    await execAsync('claude mcp remove "hubspot-cli-mcp" --scope user');
+                }
+                catch (error) {
+                    // @ts-ignore
+                    logger_1.logger.warn(error.stderr);
+                }
+            }
+            await execAsync(`claude mcp add-json "hubspot-cli-mcp" '${mcpConfig}' --scope user`);
+            SpinniesManager_1.default.succeed('claudeCode', {
+                text: 'Configured Claude Code',
+            });
+            return true;
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                error.message.includes('claude: command not found')) {
+                SpinniesManager_1.default.fail('claudeCode', {
+                    text: 'Claude Code CLI not found - skipping configuration',
+                });
+                logger_1.logger.info('  Install Claude Code CLI to enable this configuration');
+            }
+            else {
+                SpinniesManager_1.default.fail('claudeCode', {
+                    text: 'Claude Code CLI not working - skipping configuration',
+                });
+                logger_1.logger.error(`Error: ${error}`);
+            }
+            return false;
+        }
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('claudeCode', {
+            text: 'Failed to configure Claude Code',
+        });
+        logger_1.logger.error(`Failed to configure Claude Code: ${error}`);
+        return false;
+    }
+}
+async function setupCursor() {
+    try {
+        SpinniesManager_1.default.add('cursor', {
+            text: 'Configuring Cursor...',
+        });
+        const cursorConfigPath = path_1.default.join(os_1.default.homedir(), '.cursor', 'mcp.json');
+        if (!fs_1.default.existsSync(cursorConfigPath)) {
+            SpinniesManager_1.default.succeed('cursor', {
+                text: 'No .cursor/mcp.json file found - skipping Cursor configuration',
+            });
+            logger_1.logger.info('  Create a .cursor/mcp.json file in your project to enable Cursor MCP support');
+            return false;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let config = {};
+        // Read existing config
+        try {
+            const configContent = fs_1.default.readFileSync(cursorConfigPath, 'utf8');
+            config = JSON.parse(configContent);
+            logger_1.logger.debug(`Found existing Cursor config at ${cursorConfigPath}`);
+        }
+        catch (error) {
+            logger_1.logger.warn(`Could not parse existing Cursor config, creating new one: ${error}`);
+        }
+        // Initialize mcpServers if it doesn't exist
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        // Add or update HubSpot CLI MCP server
+        config.mcpServers['hubspot-cli-mcp'] = {
+            // TODO: Before merging, change these to `hs mcp start` and do a test publish
+            command: 'node',
+            args: [mcpServerPath],
+        };
+        // Write the updated config
+        fs_1.default.writeFileSync(cursorConfigPath, JSON.stringify(config, null, 2));
+        SpinniesManager_1.default.succeed('cursor', {
+            text: 'Configured Cursor',
+        });
+        return true;
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('cursor', {
+            text: 'Failed to configure Cursor',
+        });
+        logger_1.logger.error(`Failed to configure Cursor: ${error}`);
+        return false;
+    }
+}
+function getClaudeDesktopConfigPath() {
+    const platform = os_1.default.platform();
+    const homeDir = os_1.default.homedir();
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA || path_1.default.join(homeDir, 'AppData', 'Roaming');
+        return path_1.default.join(appData, 'Claude', 'claude_desktop_config.json');
+    }
+    else {
+        return path_1.default.join(homeDir, '.config', 'claude', 'claude_desktop_config.json');
+    }
+}

package/commands/mcp/start.d.ts

@@ -0,0 +1,10 @@
+import { Argv } from 'yargs';
+declare function builder(yargs: Argv): Argv;
+declare function handler(): Promise<void>;
+declare const _default: {
+    command: string;
+    describe: undefined;
+    builder: typeof builder;
+    handler: typeof handler;
+};
+export default _default;

package/commands/mcp/start.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const command = 'start';
+const describe = undefined; // Keep this command hidden, doesn't seem useful to expose
+function builder(yargs) {
+    return yargs;
+}
+async function handler() {
+    await startMcpServer();
+}
+exports.default = { command, describe, builder, handler };
+async function startMcpServer() {
+    try {
+        const serverPath = path_1.default.join(__dirname, '..', '..', 'mcp-server', 'server.js');
+        // Check if server file exists
+        if (!fs_1.default.existsSync(serverPath)) {
+            logger_1.logger.error(`MCP server file not found at ${serverPath}`);
+            return;
+        }
+        logger_1.logger.info('Starting HubSpot CLI MCP server...');
+        logger_1.logger.info(`Server path: ${serverPath}`);
+        logger_1.logger.info('The server will run in stdio mode for MCP client connections');
+        logger_1.logger.info('Press Ctrl+C to stop the server');
+        // Start the server using ts-node
+        const child = (0, child_process_1.spawn)('node', [serverPath], {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+            },
+        });
+        // Handle server process events
+        child.on('error', error => {
+            logger_1.logger.error(error);
+            logger_1.logger.error('Failed to start MCP server:', error.message);
+        });
+        child.on('close', code => {
+            if (code === 0) {
+                logger_1.logger.info('MCP server stopped gracefully');
+            }
+            else {
+                logger_1.logger.error(`MCP server exited with code ${code}`);
+            }
+        });
+        // Handle graceful shutdown
+        process.on('SIGINT', () => {
+            logger_1.logger.info('Shutting down MCP server...');
+            child.kill('SIGTERM');
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            logger_1.logger.info('Shutting down MCP server...');
+            child.kill('SIGTERM');
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        logger_1.logger.error('Error starting MCP server:', error);
+    }
+}

package/commands/mcp.d.ts

@@ -0,0 +1,10 @@
+import { Argv } from 'yargs';
+declare function builder(yargs: Argv): Argv;
+declare function handler(): void;
+declare const _default: {
+    command: string;
+    describe: string;
+    builder: typeof builder;
+    handler: typeof handler;
+};
+export default _default;

package/commands/mcp.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const start_1 = __importDefault(require("./mcp/start"));
+const setup_1 = __importDefault(require("./mcp/setup"));
+const command = 'mcp';
+const describe = 'Manage the Model Context Protocol server';
+function builder(yargs) {
+    return yargs
+        .command(start_1.default)
+        .command(setup_1.default)
+        .demandCommand(1, 'You must specify a subcommand')
+        .help();
+}
+function handler() {
+    // This function is required by yargs but not used since we have subcommands
+}
+exports.default = { command, describe, builder, handler };

package/commands/project/listBuilds.js

@@ -17,6 +17,7 @@ const lang_1 = require("../../lib/lang");
 const index_2 = require("../../lib/errorHandlers/index");
 const exitCodes_1 = require("../../lib/enums/exitCodes");
 const yargsUtils_1 = require("../../lib/yargsUtils");
+const en_1 = require("../../lang/en");
 const command = 'list-builds';
 const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.listBuilds.describe`), false);
 async function fetchAndDisplayBuilds(accountId, project, options) {
@@ -29,11 +30,7 @@ async function fetchAndDisplayBuilds(accountId, project, options) {
         }));
     }
     else {
-        logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.listBuilds.logs.showingRecentBuilds`, {
-            count: results.length,
-            projectName: project.name,
-            viewBuildsLink: (0, ui_1.uiLink)((0, lang_1.i18n)(`commands.project.subcommands.listBuilds.logs.viewAllBuildsLink`), (0, urls_1.getProjectDetailUrl)(project.name, accountId)),
-        }));
+        logger_1.logger.log(en_1.commands.project.listBuilds.showingRecentBuilds(results.length, project.name, (0, ui_1.uiLink)(en_1.commands.project.listBuilds.viewAllBuildsLink, (0, urls_1.getProjectDetailUrl)(project.name, accountId))));
     }
     if (results.length === 0) {
         logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.listBuilds.errors.noBuilds`));