@hubspot/cli 7.7.4-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/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`));

package/lang/en.d.ts

@@ -1081,7 +1081,7 @@ ${string}`;
             readonly continueOrExitPrompt: "Press <enter> to load more, or ctrl+c to exit";
             readonly viewAllBuildsLink: "View all builds";
             readonly showingNextBuilds: (count: string, projectName: string) => string;
-            readonly showingRecentBuilds: (count: string, projectName: string, viewAllBuildsLink: string) => string;
+            readonly showingRecentBuilds: (count: number, projectName: string, viewAllBuildsLink: string) => string;
             readonly errors: {
                 readonly noBuilds: "No builds for this project were found.";
                 readonly projectNotFound: (projectName: string) => string;

package/lang/en.js

@@ -1036,7 +1036,7 @@ exports.commands = {
                 },
             },
             creatingComponent: (projectName) => `\nAdding a new component to ${chalk_1.default.bold(projectName)}\n`,
-            success: (componentName, multiple = false) => `${componentName} ${multiple ? 'were' : 'was'} successfully added to your app.`,
+            success: (componentName, multiple = false) => `${componentName || 'An app'} ${multiple ? 'were' : 'was'} successfully added to your ${componentName ? 'app' : 'project'}.`,
             error: {
                 failedToDownloadComponent: 'Failed to download project component. Please try again later.',
                 maxExceeded: (maxCount) => `This project has the maximum allowed(${maxCount})`,

package/lib/prompts/projectAddPrompt.js

@@ -66,7 +66,7 @@ async function projectAddPromptV3(components, selectedFeatures) {
         {
             name: 'componentTemplate',
             message: en_1.lib.prompts.projectAddPrompt.selectType,
-            when: selectedComponents.length === 0,
+            when: !selectedFeatures && selectedComponents.length === 0,
             type: 'checkbox',
             choices: components,
         },

package/lib/prompts/promptUtils.d.ts

@@ -4,10 +4,11 @@ export declare function confirmPrompt(message: string, options?: {
     defaultAnswer?: boolean;
     when?: PromptWhen;
 }): Promise<boolean>;
-export declare function listPrompt<T = string>(message: string, { choices, when, defaultAnswer, }: {
+export declare function listPrompt<T = string>(message: string, { choices, when, defaultAnswer, validate, }: {
     choices: PromptChoices<T>;
     when?: PromptWhen;
     defaultAnswer?: string | number | boolean;
+    validate?: (input: T[]) => (boolean | string) | Promise<boolean | string>;
 }): Promise<T>;
 export declare function inputPrompt(message: string, { when, validate, defaultAnswer, }?: {
     when?: boolean | (() => boolean);

package/lib/prompts/promptUtils.js

@@ -22,7 +22,7 @@ async function confirmPrompt(message, options = {}) {
     ]);
     return choice;
 }
-async function listPrompt(message, { choices, when, defaultAnswer, }) {
+async function listPrompt(message, { choices, when, defaultAnswer, validate, }) {
     const { choice } = await promptUser([
         {
             name: 'choice',
@@ -31,6 +31,7 @@ async function listPrompt(message, { choices, when, defaultAnswer, }) {
             choices,
             when,
             default: defaultAnswer,
+            validate,
         },
     ]);
     return choice;

package/mcp-server/server.d.ts

@@ -0,0 +1 @@
+export {};

package/mcp-server/server.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const tools_1 = require("./tools");
+const server = new mcp_js_1.McpServer({
+    name: 'HubSpot CLI MCP Server',
+    version: '0.0.1',
+    description: 'Helps perform tasks for local development of HubSpot projects.',
+    capabilities: {
+        tools: {},
+        prompts: {},
+    },
+});
+(0, tools_1.registerProjectTools)(server);
+// Start receiving messages on stdin and sending messages on stdout
+const transport = new stdio_js_1.StdioServerTransport();
+server.connect(transport);

package/mcp-server/tools/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectTools(mcpServer: McpServer): RegisteredTool[];

package/mcp-server/tools/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProjectTools = registerProjectTools;
+const UploadProjectTools_1 = require("./project/UploadProjectTools");
+const CreateProjectTool_1 = require("./project/CreateProjectTool");
+const GuidedWalkthroughTool_1 = require("./project/GuidedWalkthroughTool");
+const DeployProject_1 = require("./project/DeployProject");
+const AddFeatureToProject_1 = require("./project/AddFeatureToProject");
+function registerProjectTools(mcpServer) {
+    return [
+        UploadProjectTools_1.UploadProjectTools.register(mcpServer),
+        CreateProjectTool_1.CreateProjectTool.register(mcpServer),
+        GuidedWalkthroughTool_1.GuidedWalkthroughTool.register(mcpServer),
+        DeployProject_1.DeployProject.register(mcpServer),
+        AddFeatureToProject_1.AddFeatureToProject.register(mcpServer),
+    ];
+}

package/mcp-server/tools/project/AddFeatureToProject.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class AddFeatureToProject extends Tool {
+    private static mcpServer;
+    static register(mcpServer: McpServer): RegisteredTool;
+}

package/mcp-server/tools/project/AddFeatureToProject.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddFeatureToProject = void 0;
+const types_1 = require("../../types");
+const zod_1 = require("zod");
+const constants_1 = require("../../../lib/constants");
+const command_1 = require("../../utils/command");
+const constants_2 = require("./constants");
+const project_1 = require("../../utils/project");
+class AddFeatureToProject extends types_1.Tool {
+    static mcpServer;
+    static register(mcpServer) {
+        this.mcpServer = mcpServer;
+        return this.mcpServer.registerTool('add-feature-to-hubspot-project', {
+            title: 'Add feature to HubSpot Project',
+            description: 'Adds a feature to an existing HubSpot project',
+            inputSchema: {
+                absoluteProjectPath: constants_2.absoluteProjectPath,
+                addApp: zod_1.z.boolean().describe('Would you like to add an app?'),
+                distribution: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE),
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.PRIVATE),
+                ]))
+                    .describe('Private is used if you do not wish to distribute your application on the HubSpot marketplace. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.'),
+                auth: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.STATIC),
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.OAUTH),
+                ]))
+                    .describe('Static uses a static non changing authentication token, and is only available for private distribution. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.')
+                    .optional(),
+                features: zod_1.z
+                    .array(zod_1.z
+                    .union([
+                    zod_1.z.literal('card'),
+                    zod_1.z.literal('settings'),
+                    zod_1.z.literal('app-function'),
+                    zod_1.z.literal('webhooks'),
+                ])
+                    .describe('The features to include in the project, multiple options can be selected'))
+                    .optional(),
+            },
+        }, async ({ absoluteProjectPath, distribution, auth, features, addApp }) => {
+            try {
+                let command = `hs project add`;
+                const content = [];
+                if (distribution) {
+                    command = (0, command_1.addFlag)(command, 'distribution', distribution);
+                }
+                else if (addApp) {
+                    content.push({
+                        type: 'text',
+                        text: `Ask the user how they would you like to distribute the application? Options are ${constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE} and ${constants_1.APP_DISTRIBUTION_TYPES.PRIVATE}`,
+                    });
+                }
+                if (auth) {
+                    command = (0, command_1.addFlag)(command, 'auth', auth);
+                }
+                else if (addApp) {
+                    content.push({
+                        type: 'text',
+                        text: `Ask the user which auth type they would like to use? Options are ${constants_1.APP_AUTH_TYPES.STATIC} and ${constants_1.APP_AUTH_TYPES.OAUTH}`,
+                    });
+                }
+                if (content.length > 0) {
+                    return {
+                        content,
+                    };
+                }
+                // If features isn't provided, pass an empty array to bypass the prompt
+                command = (0, command_1.addFlag)(command, 'features', features || []);
+                const { stdout, stderr } = await (0, project_1.runCommandInDir)(absoluteProjectPath, command);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: stdout,
+                        },
+                        {
+                            type: 'text',
+                            text: stderr,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: error instanceof Error ? error.message : `${error}`,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+}
+exports.AddFeatureToProject = AddFeatureToProject;

package/mcp-server/tools/project/CreateProjectTool.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class CreateProjectTool extends Tool {
+    private static mcpServer;
+    static register(mcpServer: McpServer): RegisteredTool;
+}

package/mcp-server/tools/project/CreateProjectTool.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateProjectTool = void 0;
+const types_1 = require("../../types");
+const zod_1 = require("zod");
+const constants_1 = require("../../../lib/constants");
+const command_1 = require("../../utils/command");
+const v3_1 = require("../../../lib/projects/create/v3");
+const constants_2 = require("./constants");
+const project_1 = require("../../utils/project");
+class CreateProjectTool extends types_1.Tool {
+    static mcpServer;
+    static register(mcpServer) {
+        this.mcpServer = mcpServer;
+        return this.mcpServer.registerTool('create-hubspot-project', {
+            title: 'Create HubSpot Project',
+            description: 'Creates a HubSpot project with the provided name and outputs it in the provided destination',
+            inputSchema: {
+                absoluteCurrentWorkingDirectory: constants_2.absoluteCurrentWorkingDirectory,
+                name: zod_1.z
+                    .string()
+                    .describe('The name of the project to be created.  This name is how your project will appear in HubSpot.'),
+                destination: zod_1.z
+                    .string()
+                    .describe('Relative path to the directory the project will be created in. It is not recommended to use the current directory unless it is an empty directory'),
+                projectBase: zod_1.z
+                    .union([zod_1.z.literal(v3_1.EMPTY_PROJECT), zod_1.z.literal(v3_1.PROJECT_WITH_APP)])
+                    .describe('Empty will create and empty project, and app will create a project with an app inside of it.'),
+                distribution: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE),
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.PRIVATE),
+                ]))
+                    .describe('Private is used if you do not wish to distribute your application on the HubSpot marketplace. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.'),
+                auth: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.STATIC),
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.OAUTH),
+                ]))
+                    .describe('Static uses a static non changing authentication token, and is only available for private distribution. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.')
+                    .optional(),
+                features: zod_1.z
+                    .array(zod_1.z
+                    .union([
+                    zod_1.z.literal('card'),
+                    zod_1.z.literal('settings'),
+                    zod_1.z.literal('app-function'),
+                    zod_1.z.literal('webhooks'),
+                ])
+                    .describe('The features to include in the project, multiple options can be selected'))
+                    .optional(),
+            },
+        }, async ({ name, destination, projectBase, distribution, auth, features, absoluteCurrentWorkingDirectory, }) => {
+            let command = (0, command_1.addFlag)('hs project create', 'platform-version', '2025.2');
+            const content = [];
+            if (name) {
+                command = (0, command_1.addFlag)(command, 'name', name);
+            }
+            if (destination) {
+                command = (0, command_1.addFlag)(command, 'dest', destination);
+            }
+            if (projectBase) {
+                command = (0, command_1.addFlag)(command, 'project-base', projectBase);
+            }
+            if (distribution) {
+                command = (0, command_1.addFlag)(command, 'distribution', distribution);
+            }
+            else if (projectBase === v3_1.PROJECT_WITH_APP) {
+                content.push({
+                    type: 'text',
+                    text: `Ask the user how they would you like to distribute the application? Options are ${constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE} and ${constants_1.APP_DISTRIBUTION_TYPES.PRIVATE}`,
+                });
+            }
+            if (auth) {
+                command = (0, command_1.addFlag)(command, 'auth', auth);
+            }
+            else if (projectBase === v3_1.PROJECT_WITH_APP) {
+                content.push({
+                    type: 'text',
+                    text: `Ask the user which auth type they would like to use? Options are ${constants_1.APP_AUTH_TYPES.STATIC} and ${constants_1.APP_AUTH_TYPES.OAUTH}`,
+                });
+            }
+            if (content.length > 0) {
+                return {
+                    content,
+                };
+            }
+            if (features && features.length) {
+                command = (0, command_1.addFlag)(command, 'features', features);
+            }
+            try {
+                const { stdout, stderr } = await (0, project_1.runCommandInDir)(absoluteCurrentWorkingDirectory, command);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: stdout,
+                        },
+                        {
+                            type: 'text',
+                            text: stderr,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: error instanceof Error ? error.message : `${error}`,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+}
+exports.CreateProjectTool = CreateProjectTool;

package/mcp-server/tools/project/DeployProject.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class DeployProject extends Tool {
+    private static mcpServer;
+    static register(mcpServer: McpServer): RegisteredTool;
+}

package/mcp-server/tools/project/DeployProject.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeployProject = void 0;
+const types_1 = require("../../types");
+const zod_1 = require("zod");
+const command_1 = require("../../utils/command");
+const constants_1 = require("./constants");
+const project_1 = require("../../utils/project");
+class DeployProject extends types_1.Tool {
+    static mcpServer;
+    static register(mcpServer) {
+        this.mcpServer = mcpServer;
+        return this.mcpServer.registerTool('deploy-hubspot-project', {
+            title: 'Deploy a build of HubSpot Project',
+            description: 'Takes a build number and a project name and deploys that build of the project',
+            inputSchema: {
+                absoluteProjectPath: constants_1.absoluteProjectPath,
+                buildNumber: zod_1.z
+                    .optional(zod_1.z.number())
+                    .describe('The build number to be deployed.  This can be found in the project details page using `hs project open`.  If no build number is specified, the most recent build is deployed'),
+            },
+        }, async ({ absoluteProjectPath, buildNumber }) => {
+            let command = `hs project deploy`;
+            const content = [];
+            if (!buildNumber) {
+                const { stdout } = await (0, project_1.runCommandInDir)(absoluteProjectPath, `hs project list-builds --limit 100`);
+                content.push({
+                    type: 'text',
+                    text: `Ask the user which build number they would like to deploy?  Build information: ${stdout}`,
+                });
+            }
+            else {
+                command = (0, command_1.addFlag)(command, 'build', buildNumber);
+            }
+            if (content.length) {
+                return {
+                    content,
+                };
+            }
+            const { stdout, stderr } = await (0, project_1.runCommandInDir)(absoluteProjectPath, command);
+            return {
+                content: [
+                    { type: 'text', text: stdout },
+                    { type: 'text', text: stderr },
+                ],
+            };
+        });
+    }
+}
+exports.DeployProject = DeployProject;

package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class GuidedWalkthroughTool extends Tool {
+    private static mcpServer;
+    static register(mcpServer: McpServer): RegisteredTool;
+}

package/mcp-server/tools/project/GuidedWalkthroughTool.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuidedWalkthroughTool = void 0;
+const types_1 = require("../../types");
+const zod_1 = require("zod");
+const command_1 = require("../../utils/command");
+const nextCommands = {
+    'hs init': 'hs auth',
+    'hs auth': 'hs project create',
+    'hs project create': 'hs project upload',
+    'hs project upload': 'hs project dev',
+};
+class GuidedWalkthroughTool extends types_1.Tool {
+    static mcpServer;
+    static register(mcpServer) {
+        this.mcpServer = mcpServer;
+        return this.mcpServer.registerTool('guided-walkthrough-hubspot-cli', {
+            title: 'Guided walkthrough of the CLI',
+            description: 'Give the user a guided walkthrough of the HubSpot CLI.',
+            inputSchema: {
+                command: zod_1.z
+                    .union([
+                    zod_1.z.literal('hs init'),
+                    zod_1.z.literal('hs auth'),
+                    zod_1.z.literal('hs project create'),
+                    zod_1.z.literal('hs project upload'),
+                ])
+                    .describe('The command to learn more about.  Start with `hs init`')
+                    .optional(),
+            },
+        }, async ({ command }) => {
+            if (command) {
+                const { stdout } = await (0, command_1.execAsync)(`${command} --help`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Display this help output for the user amd wait for them to acknowledge: ${stdout}. ${nextCommands[command] ? `Once they are ready, A good command to look at next is ${nextCommands[command]}` : ''}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Is there another command you would like to learn more about?',
+                    },
+                ],
+            };
+        });
+    }
+}
+exports.GuidedWalkthroughTool = GuidedWalkthroughTool;

package/mcp-server/tools/project/UploadProjectTools.d.ts

@@ -0,0 +1,5 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class UploadProjectTools extends Tool {
+    static register(mcpServer: McpServer): RegisteredTool;
+}

package/mcp-server/tools/project/UploadProjectTools.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadProjectTools = void 0;
+const types_1 = require("../../types");
+const project_1 = require("../../utils/project");
+const constants_1 = require("./constants");
+class UploadProjectTools extends types_1.Tool {
+    static register(mcpServer) {
+        return mcpServer.registerTool('upload-hubspot-project', {
+            title: 'Upload HubSpot Project',
+            description: 'Uploads the HubSpot project in current working directory.  If the project does not exist, it will be created. MUST be ran from within the project directory.',
+            inputSchema: {
+                absoluteProjectPath: constants_1.absoluteProjectPath,
+            },
+        }, async ({ absoluteProjectPath }) => {
+            const { stdout, stderr } = await (0, project_1.runCommandInDir)(absoluteProjectPath, `hs project upload --force-create`);
+            return {
+                content: [
+                    { type: 'text', text: stdout },
+                    { type: 'text', text: stderr },
+                ],
+            };
+        });
+    }
+}
+exports.UploadProjectTools = UploadProjectTools;

package/mcp-server/tools/project/constants.d.ts

@@ -0,0 +1,3 @@
+import z from 'zod';
+export declare const absoluteProjectPath: z.ZodString;
+export declare const absoluteCurrentWorkingDirectory: z.ZodString;

package/mcp-server/tools/project/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.absoluteCurrentWorkingDirectory = exports.absoluteProjectPath = void 0;
+const zod_1 = __importDefault(require("zod"));
+exports.absoluteProjectPath = zod_1.default
+    .string()
+    .describe('The absolute path to the project directory.');
+exports.absoluteCurrentWorkingDirectory = zod_1.default
+    .string()
+    .describe('The absolute path to the current working directory.');

package/mcp-server/types.d.ts

@@ -0,0 +1,8 @@
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class Tool {
+    static register: (McpServer: McpServer) => RegisteredTool;
+}
+export type Content = {
+    type: 'text';
+    text: string;
+};

package/mcp-server/types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tool = void 0;
+class Tool {
+    static register;
+}
+exports.Tool = Tool;

package/mcp-server/utils/command.d.ts

@@ -0,0 +1,3 @@
+import { exec } from 'child_process';
+export declare const execAsync: typeof exec.__promisify__;
+export declare function addFlag(command: string, flagName: string, value: string | number | boolean | string[]): string;

package/mcp-server/utils/command.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execAsync = void 0;
+exports.addFlag = addFlag;
+const util_1 = __importDefault(require("util"));
+const child_process_1 = require("child_process");
+exports.execAsync = util_1.default.promisify(child_process_1.exec);
+function addFlag(command, flagName, value) {
+    if (Array.isArray(value)) {
+        return `${command} --${flagName} ${value.map(item => `"${item}"`).join(' ')}`;
+    }
+    return `${command} --${flagName} "${value}"`;
+}

package/mcp-server/utils/project.d.ts

@@ -0,0 +1,5 @@
+export interface CommandResults {
+    stderr: string;
+    stdout: string;
+}
+export declare function runCommandInDir(directory: string, command: string): Promise<CommandResults>;

package/mcp-server/utils/project.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCommandInDir = runCommandInDir;
+const command_1 = require("./command");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+async function runCommandInDir(directory, command) {
+    if (!fs_1.default.existsSync(directory)) {
+        fs_1.default.mkdirSync(directory);
+    }
+    return (0, command_1.execAsync)(command, {
+        cwd: path_1.default.resolve(directory),
+    });
+}

package/package.json

@@ -1,15 +1,16 @@
 {
     "name": "@hubspot/cli",
-    "version": "7.7.4-experimental.0",
+    "version": "7.7.5-experimental.0",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",
     "dependencies": {
         "@hubspot/local-dev-lib": "3.7.1",
-        "@hubspot/project-parsing-lib": "0.3.2-beta.0",
+        "@hubspot/project-parsing-lib": "0.3.0",
         "@hubspot/serverless-dev-runtime": "7.0.6",
         "@hubspot/theme-preview-dev-server": "0.0.10",
         "@hubspot/ui-extensions-dev-server": "0.9.2",
+        "@modelcontextprotocol/sdk": "1.13.3",
         "archiver": "7.0.1",
         "boxen": "8.0.1",
         "chalk": "4.1.2",
@@ -65,6 +66,7 @@
     },
     "scripts": {
         "build": "ts-node ./scripts/build.ts",
+        "debug-mcp": "yarn build && npx @modelcontextprotocol/inspector node dist/mcp-server/server.js",
         "lint": "echo 'Linting is disabled for Blazar'",
         "lint:local": "eslint . && prettier --list-different './**/*.{ts,js,json}'",
         "list-all-commands": "yarn ts-node ./scripts/get-all-commands.ts",