@kairos-sdk/core 0.2.0 → 0.3.0

package/dist/mcp-server.js

@@ -0,0 +1,376 @@
+#!/usr/bin/env node
+import {
+  FileLibrary,
+  N8nApiClient,
+  N8nFieldStripper,
+  N8nValidator,
+  PromptBuilder,
+  TelemetryReader,
+  nullLogger
+} from "./chunk-DDV7ZART.js";
+
+// src/mcp-server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+var library = new FileLibrary();
+var validator = new N8nValidator();
+var stripper = new N8nFieldStripper();
+var promptBuilder = new PromptBuilder();
+function getTelemetryReader() {
+  try {
+    return new TelemetryReader();
+  } catch {
+    return null;
+  }
+}
+function isAllowed(action) {
+  const key = `KAIROS_MCP_ALLOW_${action.toUpperCase()}`;
+  return process.env[key] === "true";
+}
+function getApiClient() {
+  const baseUrl = process.env["N8N_BASE_URL"];
+  const apiKey = process.env["N8N_API_KEY"];
+  if (!baseUrl || !apiKey) {
+    throw new Error("N8N_BASE_URL and N8N_API_KEY environment variables are required for n8n operations");
+  }
+  return new N8nApiClient(baseUrl, apiKey, nullLogger);
+}
+var server = new McpServer({
+  name: "kairos",
+  version: pkg.version
+});
+server.tool(
+  "kairos_prompt",
+  "Get the specialized n8n workflow generation context. Returns a system prompt with node catalog, connection rules, validation rules, plus library matches and failure patterns for the given description. Feed this to yourself as context, then generate the workflow JSON.",
+  {
+    description: z.string().describe("Plain-English description of the workflow to build"),
+    name: z.string().optional().describe("Optional workflow name override")
+  },
+  async ({ description, name }) => {
+    await library.initialize();
+    const matches = await library.search(description);
+    const telemetryReader = getTelemetryReader();
+    const failureRates = await telemetryReader?.getFailureRates() ?? [];
+    const request = { description, ...name ? { name } : {} };
+    const built = promptBuilder.build(request, matches, failureRates);
+    const systemText = built.system.map((block) => block.text).join("\n\n---\n\n");
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          mode: built.mode,
+          matchCount: matches.length,
+          topMatchScore: matches[0]?.score ?? null,
+          systemPrompt: systemText,
+          userMessage: built.userMessage,
+          outputFormat: {
+            description: "Generate a JSON object with this exact structure. The workflow field contains the n8n workflow. credentialsNeeded lists services requiring credentials.",
+            schema: {
+              workflow: {
+                name: "string \u2014 descriptive workflow name",
+                nodes: "array \u2014 n8n node objects with id (UUID v4), type, typeVersion, name, position, parameters",
+                connections: "object \u2014 keyed by source node NAME, maps to target nodes",
+                settings: 'object \u2014 include executionOrder: "v1"'
+              },
+              credentialsNeeded: [{
+                service: 'string \u2014 e.g. "Slack"',
+                credentialType: 'string \u2014 e.g. "slackOAuth2Api"',
+                description: "string \u2014 what the user needs to set up"
+              }]
+            }
+          }
+        }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_validate",
+  "Validate n8n workflow JSON against 23 structural rules. Returns pass/fail with specific issues. If validation fails, fix the issues and call this again. Errors block deployment; warnings are advisory.",
+  {
+    workflow: z.string().describe("The workflow JSON string to validate")
+  },
+  async ({ workflow: workflowStr }) => {
+    let parsed;
+    try {
+      parsed = JSON.parse(workflowStr);
+    } catch (e) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            valid: false,
+            error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`
+          }, null, 2)
+        }]
+      };
+    }
+    const result = validator.validate(parsed);
+    const errors = result.issues.filter((i) => i.severity === "error");
+    const warnings = result.issues.filter((i) => i.severity === "warn");
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          valid: result.valid,
+          errorCount: errors.length,
+          warningCount: warnings.length,
+          errors: errors.map((i) => ({
+            rule: i.rule,
+            message: i.message,
+            nodeId: i.nodeId ?? null
+          })),
+          warnings: warnings.map((i) => ({
+            rule: i.rule,
+            message: i.message,
+            nodeId: i.nodeId ?? null
+          })),
+          deployable: errors.length === 0
+        }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_deploy",
+  "Deploy a validated workflow to n8n. Pass the workflow JSON that passed kairos_validate. Strips server-assigned fields automatically. Requires N8N_BASE_URL and N8N_API_KEY.",
+  {
+    workflow: z.string().describe("The validated workflow JSON string to deploy"),
+    activate: z.boolean().default(false).describe("Activate the workflow immediately after deployment")
+  },
+  async ({ workflow: workflowStr, activate }) => {
+    if (!isAllowed("deploy")) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: "Deploy is disabled. Set KAIROS_MCP_ALLOW_DEPLOY=true to enable." })
+        }],
+        isError: true
+      };
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(workflowStr);
+    } catch (e) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` })
+        }]
+      };
+    }
+    const validation = validator.validate(parsed);
+    const errors = validation.issues.filter((i) => i.severity === "error");
+    if (errors.length > 0) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            error: "Workflow has validation errors \u2014 fix them before deploying",
+            errors: errors.map((i) => ({ rule: i.rule, message: i.message }))
+          }, null, 2)
+        }]
+      };
+    }
+    const client = getApiClient();
+    const stripped = stripper.stripForCreate(parsed);
+    const response = await client.createWorkflow(stripped);
+    if (activate) {
+      if (!isAllowed("activate")) {
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              workflowId: response.id,
+              name: response.name,
+              activated: false,
+              warning: "Workflow deployed but activation is disabled. Set KAIROS_MCP_ALLOW_ACTIVATE=true to enable.",
+              url: `${process.env["N8N_BASE_URL"]}/workflow/${response.id}`
+            }, null, 2)
+          }]
+        };
+      }
+      await client.activateWorkflow(response.id);
+    }
+    await library.initialize();
+    await library.save(parsed, {
+      description: parsed.name,
+      generationMode: "scratch",
+      generationAttempts: 1
+    });
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          workflowId: response.id,
+          name: response.name,
+          activated: activate,
+          url: `${process.env["N8N_BASE_URL"]}/workflow/${response.id}`
+        }, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_search",
+  "Search the local workflow library for similar past builds. Returns matching workflows with scores, useful for finding examples and reusing patterns.",
+  {
+    query: z.string().describe("Search query \u2014 a workflow description or keywords"),
+    limit: z.number().default(5).describe("Maximum number of results")
+  },
+  async ({ query, limit }) => {
+    await library.initialize();
+    const matches = await library.search(query);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(
+          matches.slice(0, limit).map((m) => ({
+            score: Number(m.score.toFixed(3)),
+            mode: m.mode,
+            description: m.workflow.description,
+            nodeCount: m.workflow.workflow.nodes.length,
+            nodes: m.workflow.workflow.nodes.map((n) => n.name),
+            failurePatterns: m.workflow.failurePatterns ?? []
+          })),
+          null,
+          2
+        )
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_list",
+  "List all workflows deployed on the connected n8n instance.",
+  {},
+  async () => {
+    const client = getApiClient();
+    const workflows = await client.listWorkflows();
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(workflows, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_get",
+  "Get the full JSON definition of a specific workflow by ID.",
+  {
+    workflow_id: z.string().describe("The n8n workflow ID")
+  },
+  async ({ workflow_id }) => {
+    const client = getApiClient();
+    const workflow = await client.getWorkflow(workflow_id);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(workflow, null, 2)
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_activate",
+  "Activate a deployed workflow so it starts running on triggers.",
+  {
+    workflow_id: z.string().describe("The n8n workflow ID to activate")
+  },
+  async ({ workflow_id }) => {
+    if (!isAllowed("activate")) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: "Activate is disabled. Set KAIROS_MCP_ALLOW_ACTIVATE=true to enable." })
+        }],
+        isError: true
+      };
+    }
+    const client = getApiClient();
+    await client.activateWorkflow(workflow_id);
+    return {
+      content: [{
+        type: "text",
+        text: `Activated workflow ${workflow_id}`
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_deactivate",
+  "Deactivate a running workflow.",
+  {
+    workflow_id: z.string().describe("The n8n workflow ID to deactivate")
+  },
+  async ({ workflow_id }) => {
+    const client = getApiClient();
+    await client.deactivateWorkflow(workflow_id);
+    return {
+      content: [{
+        type: "text",
+        text: `Deactivated workflow ${workflow_id}`
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_delete",
+  "Delete a workflow from n8n. This is irreversible.",
+  {
+    workflow_id: z.string().describe("The n8n workflow ID to delete")
+  },
+  async ({ workflow_id }) => {
+    if (!isAllowed("delete")) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: "Delete is disabled. Set KAIROS_MCP_ALLOW_DELETE=true to enable." })
+        }],
+        isError: true
+      };
+    }
+    const client = getApiClient();
+    await client.deleteWorkflow(workflow_id);
+    return {
+      content: [{
+        type: "text",
+        text: `Deleted workflow ${workflow_id}`
+      }]
+    };
+  }
+);
+server.tool(
+  "kairos_executions",
+  "List recent executions for a workflow, showing status and timing.",
+  {
+    workflow_id: z.string().optional().describe("Filter to a specific workflow ID (omit for all)"),
+    limit: z.number().default(20).describe("Maximum number of executions to return")
+  },
+  async ({ workflow_id, limit }) => {
+    const client = getApiClient();
+    const executions = await client.getExecutions(workflow_id, { limit });
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(executions, null, 2)
+      }]
+    };
+  }
+);
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((err) => {
+  console.error("Kairos MCP server failed to start:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp-server.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Kairos MCP Server — decomposed architecture.\n *\n * The host LLM (Claude, GPT, Gemini, whatever) generates the workflow.\n * Kairos provides the knowledge (system prompt, library, failure patterns)\n * and guardrails (validator, deployer). Zero Anthropic API key needed.\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { z } from 'zod'\nimport { FileLibrary } from './library/file-library.js'\nimport { N8nValidator } from './validation/validator.js'\nimport { N8nFieldStripper } from './providers/n8n/stripper.js'\nimport { N8nApiClient } from './providers/n8n/api-client.js'\nimport { PromptBuilder } from './generation/prompt-builder.js'\nimport { TelemetryReader } from './telemetry/reader.js'\nimport { nullLogger } from './utils/logger.js'\nimport type { N8nWorkflow } from './types/workflow.js'\nimport { readFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\nconst pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')) as { version: string }\n\nconst library = new FileLibrary()\nconst validator = new N8nValidator()\nconst stripper = new N8nFieldStripper()\nconst promptBuilder = new PromptBuilder()\n\nfunction getTelemetryReader(): TelemetryReader | null {\n  try {\n    return new TelemetryReader()\n  } catch {\n    return null\n  }\n}\n\nfunction isAllowed(action: 'deploy' | 'activate' | 'delete'): boolean {\n  const key = `KAIROS_MCP_ALLOW_${action.toUpperCase()}`\n  return process.env[key] === 'true'\n}\n\nfunction getApiClient(): N8nApiClient {\n  const baseUrl = process.env['N8N_BASE_URL']\n  const apiKey = process.env['N8N_API_KEY']\n  if (!baseUrl || !apiKey) {\n    throw new Error('N8N_BASE_URL and N8N_API_KEY environment variables are required for n8n operations')\n  }\n  return new N8nApiClient(baseUrl, apiKey, nullLogger)\n}\n\nconst server = new McpServer({\n  name: 'kairos',\n  version: pkg.version,\n})\n\n// ── Core generation tools (no API key needed) ──────────────────────────────\n\nserver.tool(\n  'kairos_prompt',\n  'Get the specialized n8n workflow generation context. Returns a system prompt with node catalog, connection rules, validation rules, plus library matches and failure patterns for the given description. Feed this to yourself as context, then generate the workflow JSON.',\n  {\n    description: z.string().describe('Plain-English description of the workflow to build'),\n    name: z.string().optional().describe('Optional workflow name override'),\n  },\n  async ({ description, name }) => {\n    await library.initialize()\n    const matches = await library.search(description)\n    const telemetryReader = getTelemetryReader()\n    const failureRates = await telemetryReader?.getFailureRates() ?? []\n\n    const request = { description, ...(name ? { name } : {}) }\n    const built = promptBuilder.build(request, matches, failureRates)\n\n    const systemText = built.system.map(block => block.text).join('\\n\\n---\\n\\n')\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: JSON.stringify({\n          mode: built.mode,\n          matchCount: matches.length,\n          topMatchScore: matches[0]?.score ?? null,\n          systemPrompt: systemText,\n          userMessage: built.userMessage,\n          outputFormat: {\n            description: 'Generate a JSON object with this exact structure. The workflow field contains the n8n workflow. credentialsNeeded lists services requiring credentials.',\n            schema: {\n              workflow: {\n                name: 'string — descriptive workflow name',\n                nodes: 'array — n8n node objects with id (UUID v4), type, typeVersion, name, position, parameters',\n                connections: 'object — keyed by source node NAME, maps to target nodes',\n                settings: 'object — include executionOrder: \"v1\"',\n              },\n              credentialsNeeded: [{\n                service: 'string — e.g. \"Slack\"',\n                credentialType: 'string — e.g. \"slackOAuth2Api\"',\n                description: 'string — what the user needs to set up',\n              }],\n            },\n          },\n        }, null, 2),\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_validate',\n  'Validate n8n workflow JSON against 23 structural rules. Returns pass/fail with specific issues. If validation fails, fix the issues and call this again. Errors block deployment; warnings are advisory.',\n  {\n    workflow: z.string().describe('The workflow JSON string to validate'),\n  },\n  async ({ workflow: workflowStr }) => {\n    let parsed: N8nWorkflow\n    try {\n      parsed = JSON.parse(workflowStr) as N8nWorkflow\n    } catch (e) {\n      return {\n        content: [{\n          type: 'text' as const,\n          text: JSON.stringify({\n            valid: false,\n            error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`,\n          }, null, 2),\n        }],\n      }\n    }\n\n    const result = validator.validate(parsed)\n    const errors = result.issues.filter(i => i.severity === 'error')\n    const warnings = result.issues.filter(i => i.severity === 'warn')\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: JSON.stringify({\n          valid: result.valid,\n          errorCount: errors.length,\n          warningCount: warnings.length,\n          errors: errors.map(i => ({\n            rule: i.rule,\n            message: i.message,\n            nodeId: i.nodeId ?? null,\n          })),\n          warnings: warnings.map(i => ({\n            rule: i.rule,\n            message: i.message,\n            nodeId: i.nodeId ?? null,\n          })),\n          deployable: errors.length === 0,\n        }, null, 2),\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_deploy',\n  'Deploy a validated workflow to n8n. Pass the workflow JSON that passed kairos_validate. Strips server-assigned fields automatically. Requires N8N_BASE_URL and N8N_API_KEY.',\n  {\n    workflow: z.string().describe('The validated workflow JSON string to deploy'),\n    activate: z.boolean().default(false).describe('Activate the workflow immediately after deployment'),\n  },\n  async ({ workflow: workflowStr, activate }) => {\n    if (!isAllowed('deploy')) {\n      return {\n        content: [{\n          type: 'text' as const,\n          text: JSON.stringify({ error: 'Deploy is disabled. Set KAIROS_MCP_ALLOW_DEPLOY=true to enable.' }),\n        }],\n        isError: true,\n      }\n    }\n\n    let parsed: N8nWorkflow\n    try {\n      parsed = JSON.parse(workflowStr) as N8nWorkflow\n    } catch (e) {\n      return {\n        content: [{\n          type: 'text' as const,\n          text: JSON.stringify({ error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` }),\n        }],\n      }\n    }\n\n    const validation = validator.validate(parsed)\n    const errors = validation.issues.filter(i => i.severity === 'error')\n    if (errors.length > 0) {\n      return {\n        content: [{\n          type: 'text' as const,\n          text: JSON.stringify({\n            error: 'Workflow has validation errors — fix them before deploying',\n            errors: errors.map(i => ({ rule: i.rule, message: i.message })),\n          }, null, 2),\n        }],\n      }\n    }\n\n    const client = getApiClient()\n    const stripped = stripper.stripForCreate(parsed)\n    const response = await client.createWorkflow(stripped)\n\n    if (activate) {\n      if (!isAllowed('activate')) {\n        return {\n          content: [{\n            type: 'text' as const,\n            text: JSON.stringify({\n              workflowId: response.id,\n              name: response.name,\n              activated: false,\n              warning: 'Workflow deployed but activation is disabled. Set KAIROS_MCP_ALLOW_ACTIVATE=true to enable.',\n              url: `${process.env['N8N_BASE_URL']}/workflow/${response.id}`,\n            }, null, 2),\n          }],\n        }\n      }\n      await client.activateWorkflow(response.id)\n    }\n\n    // Save to library for future retrieval\n    await library.initialize()\n    await library.save(parsed, {\n      description: parsed.name,\n      generationMode: 'scratch',\n      generationAttempts: 1,\n    })\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: JSON.stringify({\n          workflowId: response.id,\n          name: response.name,\n          activated: activate,\n          url: `${process.env['N8N_BASE_URL']}/workflow/${response.id}`,\n        }, null, 2),\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_search',\n  'Search the local workflow library for similar past builds. Returns matching workflows with scores, useful for finding examples and reusing patterns.',\n  {\n    query: z.string().describe('Search query — a workflow description or keywords'),\n    limit: z.number().default(5).describe('Maximum number of results'),\n  },\n  async ({ query, limit }) => {\n    await library.initialize()\n    const matches = await library.search(query)\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: JSON.stringify(\n          matches.slice(0, limit).map(m => ({\n            score: Number(m.score.toFixed(3)),\n            mode: m.mode,\n            description: m.workflow.description,\n            nodeCount: m.workflow.workflow.nodes.length,\n            nodes: m.workflow.workflow.nodes.map(n => n.name),\n            failurePatterns: m.workflow.failurePatterns ?? [],\n          })),\n          null,\n          2,\n        ),\n      }],\n    }\n  },\n)\n\n// ── n8n management tools (need N8N_BASE_URL + N8N_API_KEY) ─────────────────\n\nserver.tool(\n  'kairos_list',\n  'List all workflows deployed on the connected n8n instance.',\n  {},\n  async () => {\n    const client = getApiClient()\n    const workflows = await client.listWorkflows()\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: JSON.stringify(workflows, null, 2),\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_get',\n  'Get the full JSON definition of a specific workflow by ID.',\n  {\n    workflow_id: z.string().describe('The n8n workflow ID'),\n  },\n  async ({ workflow_id }) => {\n    const client = getApiClient()\n    const workflow = await client.getWorkflow(workflow_id)\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: JSON.stringify(workflow, null, 2),\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_activate',\n  'Activate a deployed workflow so it starts running on triggers.',\n  {\n    workflow_id: z.string().describe('The n8n workflow ID to activate'),\n  },\n  async ({ workflow_id }) => {\n    if (!isAllowed('activate')) {\n      return {\n        content: [{\n          type: 'text' as const,\n          text: JSON.stringify({ error: 'Activate is disabled. Set KAIROS_MCP_ALLOW_ACTIVATE=true to enable.' }),\n        }],\n        isError: true,\n      }\n    }\n\n    const client = getApiClient()\n    await client.activateWorkflow(workflow_id)\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: `Activated workflow ${workflow_id}`,\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_deactivate',\n  'Deactivate a running workflow.',\n  {\n    workflow_id: z.string().describe('The n8n workflow ID to deactivate'),\n  },\n  async ({ workflow_id }) => {\n    const client = getApiClient()\n    await client.deactivateWorkflow(workflow_id)\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: `Deactivated workflow ${workflow_id}`,\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_delete',\n  'Delete a workflow from n8n. This is irreversible.',\n  {\n    workflow_id: z.string().describe('The n8n workflow ID to delete'),\n  },\n  async ({ workflow_id }) => {\n    if (!isAllowed('delete')) {\n      return {\n        content: [{\n          type: 'text' as const,\n          text: JSON.stringify({ error: 'Delete is disabled. Set KAIROS_MCP_ALLOW_DELETE=true to enable.' }),\n        }],\n        isError: true,\n      }\n    }\n\n    const client = getApiClient()\n    await client.deleteWorkflow(workflow_id)\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: `Deleted workflow ${workflow_id}`,\n      }],\n    }\n  },\n)\n\nserver.tool(\n  'kairos_executions',\n  'List recent executions for a workflow, showing status and timing.',\n  {\n    workflow_id: z.string().optional().describe('Filter to a specific workflow ID (omit for all)'),\n    limit: z.number().default(20).describe('Maximum number of executions to return'),\n  },\n  async ({ workflow_id, limit }) => {\n    const client = getApiClient()\n    const executions = await client.getExecutions(workflow_id, { limit })\n\n    return {\n      content: [{\n        type: 'text' as const,\n        text: JSON.stringify(executions, null, 2),\n      }],\n    }\n  },\n)\n\nasync function main() {\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch((err: unknown) => {\n  console.error('Kairos MCP server failed to start:', err)\n  process.exit(1)\n})\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@kairos-sdk/core",
-  "version": "0.2.0",
-  "description": "LLM-powered n8n workflow generation and deployment SDK",
+  "version": "0.3.0",
+  "description": "LLM-powered n8n workflow generation — use as an SDK or MCP server",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "kairos": "dist/cli.js"
+    "kairos": "dist/cli.js",
+    "kairos-mcp": "dist/mcp-server.js"
   },
   "exports": {
     ".": {
@@ -42,14 +43,32 @@
     "llm",
     "workflow-generation",
     "kairos",
-    "no-code"
+    "no-code",
+    "mcp",
+    "model-context-protocol"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kruttz/kairos-sdk.git"
+  },
+  "homepage": "https://github.com/Kruttz/kairos-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/Kruttz/kairos-sdk/issues"
+  },
   "author": "Jordan Krutman",
   "license": "MIT",
   "peerDependencies": {
     "@anthropic-ai/sdk": ">=0.30.0"
   },
-  "dependencies": {},
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.36.0",
     "@types/node": "^20.0.0",