@hubspot/cli 7.10.0 → 7.10.1-experimental.0

package/mcp-server/tools/index.js

@@ -9,6 +9,8 @@ import { DocsSearchTool } from './project/DocsSearchTool.js';
 import { DocFetchTool } from './project/DocFetchTool.js';
 import { GetApiUsagePatternsByAppIdTool } from './project/GetApiUsagePatternsByAppIdTool.js';
 import { GetApplicationInfoTool } from './project/GetApplicationInfoTool.js';
+import { GetBuildLogsTool } from './project/GetBuildLogsTool.js';
+import { GetBuildStatusTool } from './project/GetBuildStatusTool.js';
 import { HsListTool } from './cms/HsListTool.js';
 import { HsCreateModuleTool } from './cms/HsCreateModuleTool.js';
 import { HsCreateTemplateTool } from './cms/HsCreateTemplateTool.js';
@@ -30,6 +32,8 @@ export function registerProjectTools(mcpServer) {
         new DocFetchTool(mcpServer).register(),
         new GetApiUsagePatternsByAppIdTool(mcpServer).register(),
         new GetApplicationInfoTool(mcpServer).register(),
+        new GetBuildLogsTool(mcpServer).register(),
+        new GetBuildStatusTool(mcpServer).register(),
     ];
 }
 export function registerCmsTools(mcpServer) {

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

@@ -6,6 +6,7 @@ import { absoluteCurrentWorkingDirectory, absoluteProjectPath, features, } from
 import { runCommandInDir } from '../../utils/project.js';
 import { formatTextContents, formatTextContent } from '../../utils/content.js';
 import { trackToolUsage } from '../../utils/toolUsageTracking.js';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = {
     absoluteProjectPath,
     absoluteCurrentWorkingDirectory,
@@ -36,6 +37,7 @@ export class AddFeatureToProjectTool extends Tool {
         super(mcpServer);
     }
     async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, distribution, auth, features, addApp, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         try {
             await trackToolUsage(toolName);
             let command = `hs project add`;
@@ -60,10 +62,10 @@ export class AddFeatureToProjectTool extends Tool {
             // If features isn't provided, pass an empty array to bypass the prompt
             command = addFlag(command, 'features', features || []);
             const { stdout, stderr } = await runCommandInDir(absoluteProjectPath, command);
-            return formatTextContents(absoluteCurrentWorkingDirectory, stdout, stderr);
+            return formatTextContents(stdout, stderr);
         }
         catch (error) {
-            return formatTextContents(absoluteCurrentWorkingDirectory, error instanceof Error ? error.message : `${error}`);
+            return formatTextContents(error instanceof Error ? error.message : `${error}`);
         }
     }
     register() {

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

@@ -6,6 +6,7 @@ import { absoluteCurrentWorkingDirectory, features } from './constants.js';
 import { runCommandInDir } from '../../utils/project.js';
 import { formatTextContents, formatTextContent } from '../../utils/content.js';
 import { trackToolUsage } from '../../utils/toolUsageTracking.js';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = {
     absoluteCurrentWorkingDirectory,
     name: z
@@ -41,6 +42,7 @@ export class CreateProjectTool extends Tool {
         super(mcpServer);
     }
     async handler({ name, destination, projectBase, distribution, auth, features, absoluteCurrentWorkingDirectory, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         await trackToolUsage(toolName);
         let command = addFlag('hs project create', 'platform-version', '2025.2');
         const content = [];
@@ -77,10 +79,10 @@ export class CreateProjectTool extends Tool {
         command = addFlag(command, 'features', features || []);
         try {
             const { stdout, stderr } = await runCommandInDir(absoluteCurrentWorkingDirectory, command);
-            return formatTextContents(absoluteCurrentWorkingDirectory, stdout, stderr);
+            return formatTextContents(stdout, stderr);
         }
         catch (error) {
-            return formatTextContents(absoluteCurrentWorkingDirectory, error instanceof Error ? error.message : `${error}`);
+            return formatTextContents(error instanceof Error ? error.message : `${error}`);
         }
     }
     register() {

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

@@ -6,8 +6,9 @@ import { formatTextContents, formatTextContent } from '../../utils/content.js';
 import { addFlag } from '../../utils/command.js';
 import { runCommandInDir } from '../../utils/project.js';
 import { ACCOUNT_LEVEL_CHOICES } from '../../../lib/constants.js';
-import { getAccountIdFromCliConfig } from '../../utils/cliConfig.js';
 import fs from 'fs';
+import { getConfigAccountByName } from '@hubspot/local-dev-lib/config';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = {
     absoluteCurrentWorkingDirectory,
     configPath: z
@@ -61,6 +62,7 @@ export class CreateTestAccountTool extends Tool {
         super(mcpServer);
     }
     async handler({ absoluteCurrentWorkingDirectory, name, description, marketingLevel, opsLevel, serviceLevel, salesLevel, contentLevel, configPath, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         await trackToolUsage(toolName);
         let command = 'hs test-account create';
         const content = [];
@@ -80,18 +82,26 @@ export class CreateTestAccountTool extends Tool {
                 };
             }
             if (configJson.accountName) {
-                const nameInConfig = getAccountIdFromCliConfig(absoluteCurrentWorkingDirectory, configJson.accountName);
-                if (nameInConfig) {
-                    content.push(formatTextContent(`The account name "${configJson.accountName}" already exists in the CLI config. Please use a different name.`));
+                try {
+                    if (getConfigAccountByName(configJson.accountName)) {
+                        content.push(formatTextContent(`The account name "${configJson.accountName}" already exists in the CLI config. Please use a different name.`));
+                    }
+                }
+                catch (error) {
+                    // nothing to do here
                 }
             }
             command = addFlag(command, 'config-path', configPath);
         }
         // Use flags if name is provided (when no config used)
         else if (name) {
-            const nameInConfig = getAccountIdFromCliConfig(absoluteCurrentWorkingDirectory, name);
-            if (nameInConfig) {
-                content.push(formatTextContent(`The account name "${name}" already exists in the CLI config. Please use a different name.`));
+            try {
+                if (getConfigAccountByName(name)) {
+                    content.push(formatTextContent(`The account name "${name}" already exists in the CLI config. Please use a different name.`));
+                }
+            }
+            catch (e) {
+                // nothing to do here
             }
             command = addFlag(command, 'name', name);
             command = addFlag(command, 'description', description || name);

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

@@ -5,6 +5,7 @@ import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constan
 import { runCommandInDir } from '../../utils/project.js';
 import { formatTextContents, formatTextContent } from '../../utils/content.js';
 import { trackToolUsage } from '../../utils/toolUsageTracking.js';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = {
     absoluteProjectPath,
     absoluteCurrentWorkingDirectory,
@@ -22,6 +23,7 @@ export class DeployProjectTool extends Tool {
         super(mcpServer);
     }
     async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, buildNumber, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         await trackToolUsage(toolName);
         let command = `hs project deploy`;
         const content = [];
@@ -38,7 +40,7 @@ export class DeployProjectTool extends Tool {
             };
         }
         const { stdout, stderr } = await runCommandInDir(absoluteProjectPath, command);
-        return formatTextContents(absoluteCurrentWorkingDirectory, stdout, stderr);
+        return formatTextContents(stdout, stderr);
     }
     register() {
         return this.mcpServer.registerTool(toolName, {

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

@@ -5,6 +5,7 @@ import { trackToolUsage } from '../../utils/toolUsageTracking.js';
 import { absoluteCurrentWorkingDirectory, docUrl } from './constants.js';
 import { http } from '@hubspot/local-dev-lib/http/unauthed';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = {
     docUrl,
     absoluteCurrentWorkingDirectory,
@@ -19,6 +20,7 @@ export class DocFetchTool extends Tool {
         super(mcpServer);
     }
     async handler({ docUrl, absoluteCurrentWorkingDirectory, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         await trackToolUsage(toolName);
         try {
             // Append .md extension to the URL
@@ -28,16 +30,16 @@ export class DocFetchTool extends Tool {
             });
             const content = response.data;
             if (!content || content.trim().length === 0) {
-                return formatTextContents(absoluteCurrentWorkingDirectory, 'Document is empty or contains no content.');
+                return formatTextContents('Document is empty or contains no content.');
             }
-            return formatTextContents(absoluteCurrentWorkingDirectory, content);
+            return formatTextContents(content);
         }
         catch (error) {
             if (isHubSpotHttpError(error)) {
-                return formatTextContents(absoluteCurrentWorkingDirectory, error.toString());
+                return formatTextContents(error.toString());
             }
             const errorMessage = `Error fetching documentation: ${error instanceof Error ? error.message : String(error)}`;
-            return formatTextContents(absoluteCurrentWorkingDirectory, errorMessage);
+            return formatTextContents(errorMessage);
         }
     }
     register() {

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

@@ -23,7 +23,7 @@ export interface DocsSearchResponse {
 type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
 export declare class DocsSearchTool extends Tool<InputSchemaType> {
     constructor(mcpServer: McpServer);
-    handler({ absoluteCurrentWorkingDirectory, docsSearchQuery, }: InputSchemaType): Promise<TextContentResponse>;
+    handler({ docsSearchQuery, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<TextContentResponse>;
     register(): RegisteredTool;
 }
 export {};

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

@@ -5,7 +5,8 @@ import { formatTextContents } from '../../utils/content.js';
 import { trackToolUsage } from '../../utils/toolUsageTracking.js';
 import { absoluteCurrentWorkingDirectory, docsSearchQuery, } from './constants.js';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
-import { getAccountIdFromCliConfig } from '../../utils/cliConfig.js';
+import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = {
     absoluteCurrentWorkingDirectory,
     docsSearchQuery,
@@ -19,12 +20,13 @@ export class DocsSearchTool extends Tool {
     constructor(mcpServer) {
         super(mcpServer);
     }
-    async handler({ absoluteCurrentWorkingDirectory, docsSearchQuery, }) {
+    async handler({ docsSearchQuery, absoluteCurrentWorkingDirectory, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         await trackToolUsage(toolName, { mode: docsSearchQuery });
-        const accountId = getAccountIdFromCliConfig(absoluteCurrentWorkingDirectory);
+        const accountId = getConfigDefaultAccountIfExists()?.accountId;
         if (!accountId) {
             const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
-            return formatTextContents(absoluteCurrentWorkingDirectory, authErrorMessage);
+            return formatTextContents(authErrorMessage);
         }
         try {
             const response = await http.post(accountId, {
@@ -35,21 +37,21 @@ export class DocsSearchTool extends Tool {
             });
             const results = response.data.results;
             if (!results || results.length === 0) {
-                return formatTextContents(absoluteCurrentWorkingDirectory, 'No documentation found for your query.');
+                return formatTextContents('No documentation found for your query.');
             }
             const formattedResults = results
                 .map(result => `**${result.title}**\n${result.description}\nURL: ${result.url}\nScore: ${result.score}\n\n${result.content}\n---\n`)
                 .join('\n');
             const successMessage = `Found ${results.length} documentation results:\n\n${formattedResults}`;
-            return formatTextContents(absoluteCurrentWorkingDirectory, successMessage);
+            return formatTextContents(successMessage);
         }
         catch (error) {
             if (isHubSpotHttpError(error)) {
                 // Handle different status codes
-                return formatTextContents(absoluteCurrentWorkingDirectory, error.toString());
+                return formatTextContents(error.toString());
             }
             const errorMessage = `Error searching documentation: ${error instanceof Error ? error.message : String(error)}`;
-            return formatTextContents(absoluteCurrentWorkingDirectory, errorMessage);
+            return formatTextContents(errorMessage);
         }
     }
     register() {

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

@@ -20,7 +20,7 @@ declare const inputSchemaZodObject: z.ZodObject<{
 export type GetApiUsagePatternsByAppIdInputSchema = z.infer<typeof inputSchemaZodObject>;
 export declare class GetApiUsagePatternsByAppIdTool extends Tool<GetApiUsagePatternsByAppIdInputSchema> {
     constructor(mcpServer: McpServer);
-    handler({ absoluteCurrentWorkingDirectory, appId, startDate, endDate, }: GetApiUsagePatternsByAppIdInputSchema): Promise<TextContentResponse>;
+    handler({ appId, startDate, endDate, absoluteCurrentWorkingDirectory, }: GetApiUsagePatternsByAppIdInputSchema): Promise<TextContentResponse>;
     register(): RegisteredTool;
 }
 export {};

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

@@ -4,8 +4,9 @@ import { trackToolUsage } from '../../utils/toolUsageTracking.js';
 import { http } from '@hubspot/local-dev-lib/http';
 import { formatTextContents } from '../../utils/content.js';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
-import { getAccountId } from '@hubspot/local-dev-lib/config';
+import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { absoluteCurrentWorkingDirectory } from './constants.js';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = {
     absoluteCurrentWorkingDirectory,
     appId: z
@@ -30,14 +31,15 @@ export class GetApiUsagePatternsByAppIdTool extends Tool {
     constructor(mcpServer) {
         super(mcpServer);
     }
-    async handler({ absoluteCurrentWorkingDirectory, appId, startDate, endDate, }) {
+    async handler({ appId, startDate, endDate, absoluteCurrentWorkingDirectory, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         await trackToolUsage(toolName);
         try {
             // Get account ID from CLI config
-            const accountId = getAccountId();
+            const accountId = getConfigDefaultAccountIfExists()?.accountId;
             if (!accountId) {
                 const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
-                return formatTextContents(absoluteCurrentWorkingDirectory, authErrorMessage);
+                return formatTextContents(authErrorMessage);
             }
             const response = await http.get(accountId, {
                 url: `app/feature/utilization/public/v3/insights/app/${appId}/usage-patterns`,
@@ -49,15 +51,15 @@ export class GetApiUsagePatternsByAppIdTool extends Tool {
             // Format the response for display
             const { data } = response;
             const formattedResult = JSON.stringify(data, null, 2);
-            return formatTextContents(absoluteCurrentWorkingDirectory, formattedResult);
+            return formatTextContents(formattedResult);
         }
         catch (error) {
             if (isHubSpotHttpError(error)) {
                 // Handle HubSpot-specific HTTP errors
-                return formatTextContents(absoluteCurrentWorkingDirectory, error.toString());
+                return formatTextContents(error.toString());
             }
             const errorMessage = `${error instanceof Error ? error.message : String(error)}`;
-            return formatTextContents(absoluteCurrentWorkingDirectory, errorMessage);
+            return formatTextContents(errorMessage);
         }
     }
     register() {

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

@@ -4,8 +4,9 @@ import { trackToolUsage } from '../../utils/toolUsageTracking.js';
 import { http } from '@hubspot/local-dev-lib/http';
 import { formatTextContents } from '../../utils/content.js';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
-import { getAccountId } from '@hubspot/local-dev-lib/config';
+import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
 import { absoluteCurrentWorkingDirectory } from './constants.js';
+import { setupHubSpotConfig } from '../../utils/config.js';
 const inputSchema = { absoluteCurrentWorkingDirectory };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
@@ -15,13 +16,14 @@ export class GetApplicationInfoTool extends Tool {
         super(mcpServer);
     }
     async handler({ absoluteCurrentWorkingDirectory, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
         await trackToolUsage(toolName);
         try {
             // Get account ID from CLI config
-            const accountId = getAccountId();
+            const accountId = getConfigDefaultAccountIfExists()?.accountId;
             if (!accountId) {
                 const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
-                return formatTextContents(absoluteCurrentWorkingDirectory, authErrorMessage);
+                return formatTextContents(authErrorMessage);
             }
             const response = await http.get(accountId, {
                 url: `app/feature/utilization/public/v3/insights/apps`,
@@ -29,15 +31,15 @@ export class GetApplicationInfoTool extends Tool {
             // Format the response for display
             const { data } = response;
             const formattedResult = JSON.stringify(data, null, 2);
-            return formatTextContents(absoluteCurrentWorkingDirectory, formattedResult);
+            return formatTextContents(formattedResult);
         }
         catch (error) {
             if (isHubSpotHttpError(error)) {
                 // Handle HubSpot-specific HTTP errors
-                return formatTextContents(absoluteCurrentWorkingDirectory, error.toString());
+                return formatTextContents(error.toString());
             }
             const errorMessage = `${error instanceof Error ? error.message : String(error)}`;
-            return formatTextContents(absoluteCurrentWorkingDirectory, errorMessage);
+            return formatTextContents(errorMessage);
         }
     }
     register() {

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

@@ -0,0 +1,26 @@
+import { TextContentResponse, Tool } from '../../types.js';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+declare const inputSchemaZodObject: z.ZodObject<{
+    absoluteProjectPath: z.ZodString;
+    absoluteCurrentWorkingDirectory: z.ZodString;
+    buildId: z.ZodNumber;
+    logLevel: z.ZodDefault<z.ZodOptional<z.ZodEnum<["ERROR", "WARN", "INFO", "ALL"]>>>;
+}, "strip", z.ZodTypeAny, {
+    buildId: number;
+    absoluteProjectPath: string;
+    absoluteCurrentWorkingDirectory: string;
+    logLevel: "ERROR" | "WARN" | "INFO" | "ALL";
+}, {
+    buildId: number;
+    absoluteProjectPath: string;
+    absoluteCurrentWorkingDirectory: string;
+    logLevel?: "ERROR" | "WARN" | "INFO" | "ALL" | undefined;
+}>;
+export type GetBuildLogsInputSchema = z.infer<typeof inputSchemaZodObject>;
+export declare class GetBuildLogsTool extends Tool<GetBuildLogsInputSchema> {
+    constructor(mcpServer: McpServer);
+    handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, buildId, logLevel, }: GetBuildLogsInputSchema): Promise<TextContentResponse>;
+    register(): RegisteredTool;
+}
+export {};

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

@@ -0,0 +1,125 @@
+import { Tool } from '../../types.js';
+import { z } from 'zod';
+import { trackToolUsage } from '../../utils/toolUsageTracking.js';
+import { formatTextContents } from '../../utils/content.js';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { http } from '@hubspot/local-dev-lib/http';
+import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
+import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constants.js';
+import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
+import { setupHubSpotConfig } from '../../utils/config.js';
+const TOOL_NAME = 'get-build-logs';
+const PROJECTS_LOGS_API_PATH = 'dfs/logging/v1';
+const inputSchema = {
+    absoluteProjectPath,
+    absoluteCurrentWorkingDirectory,
+    buildId: z
+        .number()
+        .describe('Build ID to fetch logs for. Use get-build-status to find recent build IDs.'),
+    logLevel: z
+        .enum(['ERROR', 'WARN', 'INFO', 'ALL'])
+        .optional()
+        .default('ALL')
+        .describe('Filter logs by level. ERROR: Show only errors, WARN: Show only warnings, INFO: Show only info, ALL: Show all logs.'),
+};
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const inputSchemaZodObject = z.object({ ...inputSchema });
+function flattenLogs(response) {
+    const allLogs = [];
+    response.logs.forEach(substep => {
+        substep.logs.forEach(log => {
+            allLogs.push(log);
+        });
+    });
+    return allLogs.sort((a, b) => a.timestamp - b.timestamp);
+}
+function filterLogsByLevel(logs, logLevel) {
+    if (logLevel === 'ALL') {
+        return logs;
+    }
+    return logs.filter(log => log.logLevel === logLevel);
+}
+function formatLogs(logs) {
+    if (logs.length === 0) {
+        return 'No logs found.';
+    }
+    return logs
+        .map(log => {
+        const timestamp = new Date(log.timestamp).toLocaleString('en-US', {
+            month: 'short',
+            day: 'numeric',
+            year: 'numeric',
+            hour: 'numeric',
+            minute: 'numeric',
+            second: 'numeric',
+            timeZoneName: 'short',
+        });
+        const component = log.pipelineSubstepName || `Step ${log.pipelineStepId}`;
+        return `[${log.logLevel}][${component}] ${timestamp} ${log.message}`;
+    })
+        .join('\n');
+}
+export class GetBuildLogsTool extends Tool {
+    constructor(mcpServer) {
+        super(mcpServer);
+    }
+    async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, buildId, logLevel, }) {
+        setupHubSpotConfig(absoluteCurrentWorkingDirectory);
+        await trackToolUsage(TOOL_NAME);
+        try {
+            const accountId = getConfigDefaultAccountIfExists()?.accountId;
+            if (!accountId) {
+                return formatTextContents(absoluteCurrentWorkingDirectory, 'No account ID found. Please run `hs account auth` to configure an account, or set a default account with `hs account use <account>`');
+            }
+            const { projectConfig, projectDir } = await getProjectConfig(absoluteProjectPath);
+            validateProjectConfig(projectConfig, projectDir);
+            const projectName = projectConfig.name;
+            const response = await http.get(accountId, {
+                url: `${PROJECTS_LOGS_API_PATH}/logs/projects/${encodeURIComponent(projectName)}/builds/${buildId}`,
+            });
+            const buildLogsResponse = response.data;
+            if (!buildLogsResponse.logs || buildLogsResponse.logs.length === 0) {
+                return formatTextContents(absoluteCurrentWorkingDirectory, `No logs found for build #${buildId} in project '${projectName}'.`);
+            }
+            const allLogs = flattenLogs(buildLogsResponse);
+            if (allLogs.length === 0) {
+                return formatTextContents(absoluteCurrentWorkingDirectory, `No logs found for build #${buildId} in project '${projectName}'.`);
+            }
+            const filteredLogs = filterLogsByLevel(allLogs, logLevel);
+            let output;
+            if (filteredLogs.length === 0) {
+                // No logs match filter, show all logs instead
+                output = `No ${logLevel} level logs found for build #${buildId} in '${projectName}'.\nShowing all logs instead:\n\n${formatLogs(allLogs)}`;
+            }
+            else {
+                output = `Logs for build #${buildId} in '${projectName}' (${logLevel} level):\n\n${formatLogs(filteredLogs)}`;
+            }
+            return formatTextContents(absoluteCurrentWorkingDirectory, output);
+        }
+        catch (error) {
+            let errorMessage;
+            if (isHubSpotHttpError(error)) {
+                errorMessage = error.toString();
+            }
+            else if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else {
+                errorMessage = String(error);
+            }
+            return formatTextContents(absoluteCurrentWorkingDirectory, errorMessage);
+        }
+    }
+    register() {
+        return this.mcpServer.registerTool(TOOL_NAME, {
+            title: 'Get HubSpot Project Build Logs',
+            description: 'Retrieves build logs for a specific HubSpot project build. Use this to debug build failures by viewing the full build pipeline output. This tool is for more comprehensive troubleshootings or addressing build WARNINGs, build errors should be troubleshooted with get-build-status tool first. Logs can be filtered by level (ERROR, WARN, INFO, or ALL). Use `hs project list-builds`  first to identify the build ID and error messages.',
+            inputSchema,
+            annotations: {
+                readOnlyHint: true,
+                openWorldHint: true,
+                idempotentHint: true,
+            },
+        }, this.handler);
+    }
+}

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

@@ -0,0 +1,26 @@
+import { TextContentResponse, Tool } from '../../types.js';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+declare const inputSchemaZodObject: z.ZodObject<{
+    absoluteProjectPath: z.ZodString;
+    absoluteCurrentWorkingDirectory: z.ZodString;
+    buildId: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    absoluteProjectPath: string;
+    absoluteCurrentWorkingDirectory: string;
+    buildId?: number | undefined;
+}, {
+    absoluteProjectPath: string;
+    absoluteCurrentWorkingDirectory: string;
+    limit?: number | undefined;
+    buildId?: number | undefined;
+}>;
+export type GetBuildStatusInputSchema = z.infer<typeof inputSchemaZodObject>;
+export declare class GetBuildStatusTool extends Tool<GetBuildStatusInputSchema> {
+    constructor(mcpServer: McpServer);
+    handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, buildId, limit, }: GetBuildStatusInputSchema): Promise<TextContentResponse>;
+    register(): RegisteredTool;
+}
+export {};