@hanzo/platform-mcp 1.4.0

package/build/mcp/tools/application/applicationUpdate.js

@@ -0,0 +1,319 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+import { createTool } from "../toolFactory.js";
+export const applicationUpdate = createTool({
+    name: "application-update",
+    description: "Updates an existing application in Platform.",
+    schema: z.object({
+        applicationId: z.string().describe("The ID of the application to update."),
+        name: z
+            .string()
+            .min(1)
+            .optional()
+            .describe("The new name of the application."),
+        appName: z
+            .string()
+            .optional()
+            .describe("The new app name of the application."),
+        description: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("The new description for the application."),
+        env: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Environment variables for the application."),
+        previewEnv: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Preview environment variables."),
+        watchPaths: z
+            .array(z.string())
+            .nullable()
+            .optional()
+            .describe("Paths to watch for changes."),
+        previewBuildArgs: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Preview build arguments."),
+        previewWildcard: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Preview wildcard configuration."),
+        previewPort: z
+            .number()
+            .nullable()
+            .optional()
+            .describe("Preview port number."),
+        previewHttps: z.boolean().optional().describe("Enable HTTPS for preview."),
+        previewPath: z.string().nullable().optional().describe("Preview path."),
+        previewCertificateType: z
+            .enum(["letsencrypt", "none", "custom"])
+            .optional()
+            .describe("Preview certificate type."),
+        previewCustomCertResolver: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Custom certificate resolver for preview."),
+        previewLimit: z
+            .number()
+            .nullable()
+            .optional()
+            .describe("Preview deployment limit."),
+        isPreviewDeploymentsActive: z
+            .boolean()
+            .nullable()
+            .optional()
+            .describe("Whether preview deployments are active."),
+        buildArgs: z.string().nullable().optional().describe("Build arguments."),
+        memoryReservation: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Memory reservation for the application."),
+        memoryLimit: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Memory limit for the application."),
+        cpuReservation: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("CPU reservation for the application."),
+        cpuLimit: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("CPU limit for the application."),
+        title: z.string().nullable().optional().describe("Application title."),
+        enabled: z
+            .boolean()
+            .nullable()
+            .optional()
+            .describe("Whether the application is enabled."),
+        subtitle: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Application subtitle."),
+        command: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Command to run the application."),
+        refreshToken: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Refresh token for the application."),
+        sourceType: z
+            .enum(["github", "docker", "git", "gitlab", "bitbucket", "gitea", "drop"])
+            .optional()
+            .describe("Source type for the application."),
+        cleanCache: z
+            .boolean()
+            .nullable()
+            .optional()
+            .describe("Whether to clean cache on build."),
+        repository: z.string().nullable().optional().describe("Repository URL."),
+        owner: z.string().nullable().optional().describe("Repository owner."),
+        branch: z.string().nullable().optional().describe("Repository branch."),
+        buildPath: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Build path within repository."),
+        triggerType: z
+            .enum(["push", "tag"])
+            .nullable()
+            .optional()
+            .describe("Trigger type for deployments."),
+        autoDeploy: z
+            .boolean()
+            .nullable()
+            .optional()
+            .describe("Whether to auto-deploy."),
+        gitlabProjectId: z
+            .number()
+            .nullable()
+            .optional()
+            .describe("GitLab project ID."),
+        gitlabRepository: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("GitLab repository."),
+        gitlabOwner: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("GitLab repository owner."),
+        gitlabBranch: z.string().nullable().optional().describe("GitLab branch."),
+        gitlabBuildPath: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("GitLab build path."),
+        gitlabPathNamespace: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("GitLab path namespace."),
+        giteaRepository: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Gitea repository."),
+        giteaOwner: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Gitea repository owner."),
+        giteaBranch: z.string().nullable().optional().describe("Gitea branch."),
+        giteaBuildPath: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Gitea build path."),
+        bitbucketRepository: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Bitbucket repository."),
+        bitbucketOwner: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Bitbucket repository owner."),
+        bitbucketBranch: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Bitbucket branch."),
+        bitbucketBuildPath: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Bitbucket build path."),
+        username: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Username for authentication."),
+        password: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Password for authentication."),
+        dockerImage: z.string().nullable().optional().describe("Docker image."),
+        registryUrl: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Docker registry URL."),
+        customGitUrl: z.string().nullable().optional().describe("Custom Git URL."),
+        customGitBranch: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Custom Git branch."),
+        customGitBuildPath: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Custom Git build path."),
+        customGitSSHKeyId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Custom Git SSH key ID."),
+        enableSubmodules: z
+            .boolean()
+            .optional()
+            .describe("Whether to enable Git submodules."),
+        dockerfile: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Dockerfile content or path."),
+        dockerContextPath: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Docker context path."),
+        dockerBuildStage: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Docker build stage."),
+        dropBuildPath: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Drop build path."),
+        replicas: z.number().optional().describe("Number of replicas."),
+        applicationStatus: z
+            .enum(["idle", "running", "done", "error"])
+            .optional()
+            .describe("Application status."),
+        buildType: z
+            .enum([
+            "dockerfile",
+            "heroku_buildpacks",
+            "paketo_buildpacks",
+            "nixpacks",
+            "static",
+            "railpack",
+        ])
+            .optional()
+            .describe("Build type."),
+        herokuVersion: z.string().nullable().optional().describe("Heroku version."),
+        publishDirectory: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Publish directory."),
+        createdAt: z.string().optional().describe("Creation date."),
+        registryId: z.string().nullable().optional().describe("Registry ID."),
+        projectId: z.string().optional().describe("Project ID."),
+        githubId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("GitHub integration ID."),
+        gitlabId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("GitLab integration ID."),
+        giteaId: z.string().nullable().optional().describe("Gitea integration ID."),
+        bitbucketId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Bitbucket integration ID."),
+        serverId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("The ID of the server where the application is deployed."),
+    }),
+    annotations: {
+        title: "Update Application",
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    handler: async (input) => {
+        const response = await apiClient.post("/application.update", input);
+        return ResponseFormatter.success(`Application "${input.applicationId}" updated successfully`, response.data);
+    },
+});

package/build/mcp/tools/application/applicationUpdateTraefikConfig.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+import { createTool } from "../toolFactory.js";
+export const applicationUpdateTraefikConfig = createTool({
+    name: "application-updateTraefikConfig",
+    description: "Updates Traefik configuration for an application in Platform.",
+    schema: z.object({
+        applicationId: z
+            .string()
+            .describe("The ID of the application to update Traefik config for."),
+        traefikConfig: z
+            .string()
+            .describe("The new Traefik configuration content."),
+    }),
+    annotations: {
+        title: "Update Application Traefik Config",
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    handler: async (input) => {
+        const response = await apiClient.post("/application.updateTraefikConfig", input);
+        return ResponseFormatter.success(`Traefik configuration for application "${input.applicationId}" updated successfully`, response.data);
+    },
+});

package/build/mcp/tools/application/index.js

@@ -0,0 +1,24 @@
+export { applicationCleanQueues } from "./applicationCleanQueues.js";
+export { applicationCreate } from "./applicationCreate.js";
+export { applicationDelete } from "./applicationDelete.js";
+export { applicationDeploy } from "./applicationDeploy.js";
+export { applicationMarkRunning } from "./applicationMarkRunning.js";
+export { applicationMove } from "./applicationMove.js";
+export { applicationOne } from "./applicationOne.js";
+export { applicationReadAppMonitoring } from "./applicationReadAppMonitoring.js";
+export { applicationReadTraefikConfig } from "./applicationReadTraefikConfig.js";
+export { applicationRedeploy } from "./applicationRedeploy.js";
+export { applicationRefreshToken } from "./applicationRefreshToken.js";
+export { applicationReload } from "./applicationReload.js";
+export { applicationSaveBitbucketProvider } from "./applicationSaveBitbucketProvider.js";
+export { applicationSaveBuildType } from "./applicationSaveBuildType.js";
+export { applicationSaveDockerProvider } from "./applicationSaveDockerProvider.js";
+export { applicationSaveEnvironment } from "./applicationSaveEnvironment.js";
+export { applicationSaveGiteaProvider } from "./applicationSaveGiteaProvider.js";
+export { applicationSaveGithubProvider } from "./applicationSaveGithubProvider.js";
+export { applicationSaveGitlabProvider } from "./applicationSaveGitlabProvider.js";
+export { applicationSaveGitProvider } from "./applicationSaveGitProvider.js";
+export { applicationStart } from "./applicationStart.js";
+export { applicationStop } from "./applicationStop.js";
+export { applicationUpdate } from "./applicationUpdate.js";
+export { applicationUpdateTraefikConfig } from "./applicationUpdateTraefikConfig.js";

package/build/mcp/tools/compose/composeCreate.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeCreate = createTool({
+    name: "compose-create",
+    description: "Creates a new compose service in Platform",
+    schema: z.object({
+        name: z.string().describe("The name of the compose service"),
+        appName: z.string().optional().describe("Optional application name"),
+        description: z.string().nullable().describe("Description of the compose service"),
+        projectId: z.string().describe("The ID of the project"),
+        serverId: z.string().nullable().describe("The ID of the server"),
+        composeFile: z.string().optional().describe("Docker Compose file content"),
+        env: z.string().nullable().describe("Environment variables"),
+        composeType: z.enum(["docker-compose", "stack"]).default("docker-compose").describe("Type of compose service"),
+    }),
+    annotations: {
+        title: "Create Compose Service",
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const compose = await apiClient.post("/compose.create", input);
+        if (!compose?.data) {
+            return ResponseFormatter.error("Failed to create compose service", "Could not create the compose service");
+        }
+        return ResponseFormatter.success(`Successfully created compose service "${input.name}"`, compose.data);
+    },
+});

package/build/mcp/tools/compose/composeDeploy.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeDeploy = createTool({
+    name: "compose-deploy",
+    description: "Deploys a compose service in Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service to deploy"),
+    }),
+    annotations: {
+        title: "Deploy Compose Service",
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const result = await apiClient.post("/compose.deploy", {
+            composeId: input.composeId
+        });
+        if (!result?.data) {
+            return ResponseFormatter.error("Failed to deploy compose service", `Could not deploy compose service with ID "${input.composeId}"`);
+        }
+        return ResponseFormatter.success(`Successfully deployed compose service "${input.composeId}"`, result.data);
+    },
+});

package/build/mcp/tools/compose/composeOne.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeOne = createTool({
+    name: "compose-one",
+    description: "Gets a specific compose service by its ID in Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service to retrieve"),
+    }),
+    annotations: {
+        title: "Get Compose Service Details",
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+    handler: async (input) => {
+        const compose = await apiClient.get(`/compose.one?composeId=${input.composeId}`);
+        if (!compose?.data) {
+            return ResponseFormatter.error("Failed to fetch compose service", `Compose service with ID "${input.composeId}" not found`);
+        }
+        return ResponseFormatter.success(`Successfully fetched compose service "${input.composeId}"`, compose.data);
+    },
+});

package/build/mcp/tools/compose/composeReload.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeReload = createTool({
+    name: "compose-reload",
+    description: "Reloads a compose service in Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service to reload"),
+        appName: z.string().describe("The application name"),
+    }),
+    annotations: {
+        title: "Reload Compose Service",
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const result = await apiClient.post("/compose.reload", {
+            composeId: input.composeId,
+            appName: input.appName
+        });
+        if (!result?.data) {
+            return ResponseFormatter.error("Failed to reload compose service", `Could not reload compose service with ID "${input.composeId}"`);
+        }
+        return ResponseFormatter.success(`Successfully reloaded compose service "${input.composeId}"`, result.data);
+    },
+});

package/build/mcp/tools/compose/composeRemove.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeRemove = createTool({
+    name: "compose-remove",
+    description: "Removes/deletes a compose service from Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service to remove"),
+    }),
+    annotations: {
+        title: "Remove Compose Service",
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const result = await apiClient.post("/compose.remove", {
+            composeId: input.composeId
+        });
+        if (!result?.data) {
+            return ResponseFormatter.error("Failed to remove compose service", `Could not remove compose service with ID "${input.composeId}"`);
+        }
+        return ResponseFormatter.success(`Successfully removed compose service "${input.composeId}"`, result.data);
+    },
+});

package/build/mcp/tools/compose/composeSaveEnvironment.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeSaveEnvironment = createTool({
+    name: "compose-saveEnvironment",
+    description: "Saves environment variables for a compose service in Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service"),
+        env: z.string().nullable().describe("Environment variables to save"),
+    }),
+    annotations: {
+        title: "Save Compose Environment Variables",
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const result = await apiClient.post("/compose.saveEnvironment", {
+            composeId: input.composeId,
+            env: input.env
+        });
+        if (!result?.data) {
+            return ResponseFormatter.error("Failed to save environment variables", `Could not save environment variables for compose service "${input.composeId}"`);
+        }
+        return ResponseFormatter.success(`Successfully saved environment variables for compose service "${input.composeId}"`, result.data);
+    },
+});

package/build/mcp/tools/compose/composeStart.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeStart = createTool({
+    name: "compose-start",
+    description: "Starts a compose service in Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service to start"),
+    }),
+    annotations: {
+        title: "Start Compose Service",
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const result = await apiClient.post("/compose.start", {
+            composeId: input.composeId
+        });
+        if (!result?.data) {
+            return ResponseFormatter.error("Failed to start compose service", `Could not start compose service with ID "${input.composeId}"`);
+        }
+        return ResponseFormatter.success(`Successfully started compose service "${input.composeId}"`, result.data);
+    },
+});

package/build/mcp/tools/compose/composeStop.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeStop = createTool({
+    name: "compose-stop",
+    description: "Stops a compose service in Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service to stop"),
+    }),
+    annotations: {
+        title: "Stop Compose Service",
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const result = await apiClient.post("/compose.stop", {
+            composeId: input.composeId
+        });
+        if (!result?.data) {
+            return ResponseFormatter.error("Failed to stop compose service", `Could not stop compose service with ID "${input.composeId}"`);
+        }
+        return ResponseFormatter.success(`Successfully stopped compose service "${input.composeId}"`, result.data);
+    },
+});

package/build/mcp/tools/compose/composeUpdate.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import apiClient from "../../../utils/apiClient.js";
+import { createTool } from "../toolFactory.js";
+import { ResponseFormatter } from "../../../utils/responseFormatter.js";
+export const composeUpdate = createTool({
+    name: "compose-update",
+    description: "Updates an existing compose service in Platform",
+    schema: z.object({
+        composeId: z.string().describe("The ID of the compose service"),
+        name: z.string().optional().describe("New name for the compose service"),
+        appName: z.string().optional().describe("New application name"),
+        description: z.string().nullable().optional().describe("New description"),
+        env: z.string().nullable().optional().describe("New environment variables"),
+        composeFile: z.string().optional().describe("New Docker Compose file content"),
+        sourceType: z.enum(["git", "github", "gitlab", "bitbucket", "raw"]).optional().describe("Source type"),
+        composeType: z.enum(["docker-compose", "stack"]).optional().describe("Compose type"),
+        serverId: z.string().nullable().optional().describe("New server ID"),
+        composeStatus: z.enum(["idle", "running", "done", "error"]).optional().describe("Compose status"),
+        projectId: z.string().optional().describe("New project ID"),
+    }),
+    annotations: {
+        title: "Update Compose Service",
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (input) => {
+        const compose = await apiClient.post("/compose.update", input);
+        if (!compose?.data) {
+            return ResponseFormatter.error("Failed to update compose service", `Could not update compose service with ID "${input.composeId}"`);
+        }
+        return ResponseFormatter.success(`Successfully updated compose service "${input.composeId}"`, compose.data);
+    },
+});

package/build/mcp/tools/compose/index.js

@@ -0,0 +1,9 @@
+export { composeOne } from "./composeOne.js";
+export { composeCreate } from "./composeCreate.js";
+export { composeUpdate } from "./composeUpdate.js";
+export { composeDeploy } from "./composeDeploy.js";
+export { composeStart } from "./composeStart.js";
+export { composeStop } from "./composeStop.js";
+export { composeReload } from "./composeReload.js";
+export { composeRemove } from "./composeRemove.js";
+export { composeSaveEnvironment } from "./composeSaveEnvironment.js";

package/build/mcp/tools/index.js

@@ -0,0 +1,12 @@
+import * as applicationTools from "./application/index.js";
+import * as composeTools from "./compose/index.js";
+import * as mysqlTools from "./mysql/index.js";
+import * as postgresTools from "./postgres/index.js";
+import * as projectTools from "./project/index.js";
+export const allTools = [
+    ...Object.values(projectTools),
+    ...Object.values(applicationTools),
+    ...Object.values(mysqlTools),
+    ...Object.values(postgresTools),
+    ...Object.values(composeTools),
+];

package/build/mcp/tools/mysql/index.js

@@ -0,0 +1,13 @@
+export { mysqlChangeStatus } from "./mysqlChangeStatus.js";
+export { mysqlCreate } from "./mysqlCreate.js";
+export { mysqlDeploy } from "./mysqlDeploy.js";
+export { mysqlMove } from "./mysqlMove.js";
+export { mysqlOne } from "./mysqlOne.js";
+export { mysqlRebuild } from "./mysqlRebuild.js";
+export { mysqlReload } from "./mysqlReload.js";
+export { mysqlRemove } from "./mysqlRemove.js";
+export { mysqlSaveEnvironment } from "./mysqlSaveEnvironment.js";
+export { mysqlSaveExternalPort } from "./mysqlSaveExternalPort.js";
+export { mysqlStart } from "./mysqlStart.js";
+export { mysqlStop } from "./mysqlStop.js";
+export { mysqlUpdate } from "./mysqlUpdate.js";