jetty-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,113 @@
+# jetty-mcp-server
+
+MCP server for the [Jetty](https://jetty.io) AI/ML workflow platform. Works with Claude Code, Cursor, Gemini CLI, Codex, and any MCP-compatible tool.
+
+## Quick Start
+
+```bash
+npx -y jetty-mcp-server
+```
+
+Set your API token:
+
+```bash
+export JETTY_API_TOKEN="mlc_your_token_here"
+```
+
+Get a token at [flows.jetty.io](https://flows.jetty.io) → Settings → API Tokens.
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `JETTY_API_TOKEN` | Yes | — | Your Jetty API token (`mlc_...`) |
+| `JETTY_DOCK_URL` | No | `https://dock.jetty.io` | Dock API base URL |
+| `JETTY_FLOWS_URL` | No | `https://flows-api.jetty.io` | Flows API base URL |
+
+## Configuration
+
+### Claude Code
+
+```bash
+claude mcp add jetty -- npx -y jetty-mcp-server
+```
+
+Or add to `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "jetty": {
+      "command": "npx",
+      "args": ["-y", "jetty-mcp-server"],
+      "env": { "JETTY_API_TOKEN": "mlc_your_token" }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "jetty": {
+      "command": "npx",
+      "args": ["-y", "jetty-mcp-server"],
+      "env": { "JETTY_API_TOKEN": "mlc_your_token" }
+    }
+  }
+}
+```
+
+### Gemini CLI
+
+```bash
+gemini extensions install jetty-extension.json
+```
+
+### Generic MCP Client
+
+```bash
+JETTY_API_TOKEN=mlc_your_token npx -y jetty-mcp-server
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list-collections` | List all collections |
+| `get-collection` | Get collection details + env var keys |
+| `list-tasks` | List tasks in a collection |
+| `get-task` | Get task details + workflow definition |
+| `create-task` | Create a task with a workflow |
+| `update-task` | Update a task's workflow or description |
+| `run-workflow` | Run a workflow asynchronously |
+| `run-workflow-sync` | Run a workflow synchronously (blocks until done) |
+| `list-trajectories` | List recent workflow runs |
+| `get-trajectory` | Get full run details |
+| `get-stats` | Get execution statistics |
+| `add-label` | Label a trajectory (e.g., quality=high) |
+| `list-step-templates` | List available step templates |
+| `get-step-template` | Get template details and schema |
+
+## Development
+
+```bash
+cd mcp-server
+npm install
+npm run build
+JETTY_API_TOKEN=mlc_... node dist/index.js
+```
+
+Test with [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
+
+```bash
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+export declare class JettyClient {
+    private token;
+    private dockUrl;
+    private flowsUrl;
+    constructor();
+    private request;
+    private dock;
+    private flows;
+    listCollections(): Promise<unknown>;
+    getCollection(collection: string): Promise<unknown>;
+    listTasks(collection: string): Promise<unknown>;
+    getTask(collection: string, task: string): Promise<unknown>;
+    createTask(collection: string, name: string, workflow: unknown, description?: string): Promise<unknown>;
+    updateTask(collection: string, task: string, updates: {
+        workflow?: unknown;
+        description?: string;
+    }): Promise<unknown>;
+    deleteTask(collection: string, task: string): Promise<unknown>;
+    runWorkflow(collection: string, task: string, initParams?: Record<string, unknown>): Promise<unknown>;
+    runWorkflowSync(collection: string, task: string, initParams?: Record<string, unknown>): Promise<unknown>;
+    listTrajectories(collection: string, task: string, limit?: number, page?: number): Promise<unknown>;
+    getTrajectory(collection: string, task: string, trajectoryId: string): Promise<unknown>;
+    getStats(collection: string, task: string): Promise<unknown>;
+    addLabel(collection: string, task: string, trajectoryId: string, key: string, value: string, author: string): Promise<unknown>;
+    getWorkflowLogs(workflowId: string): Promise<unknown>;
+    listStepTemplates(): Promise<unknown>;
+    getStepTemplate(name: string): Promise<unknown>;
+    setEnvironmentVars(collection: string, vars: Record<string, string>): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;;YAeX,OAAO;IAyBrB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,KAAK;IAKP,eAAe;IAIf,aAAa,CAAC,UAAU,EAAE,MAAM;IAKhC,SAAS,CAAC,UAAU,EAAE,MAAM;IAI5B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIxC,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,WAAW,CAAC,EAAE,MAAM;IAShB,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IASjD,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAO3C,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYhC,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAahC,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAK,EACV,IAAI,SAAI;IAOJ,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM;IAQhB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAKzC,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;IAaV,eAAe,CAAC,UAAU,EAAE,MAAM;IAKlC,iBAAiB;IAIjB,eAAe,CAAC,IAAI,EAAE,MAAM;IAK5B,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAQ/B"}

package/dist/client.js

@@ -0,0 +1,131 @@
+const DOCK_URL = process.env.JETTY_DOCK_URL || "https://dock.jetty.io";
+const FLOWS_URL = process.env.JETTY_FLOWS_URL || "https://flows-api.jetty.io";
+export class JettyClient {
+    token;
+    dockUrl;
+    flowsUrl;
+    constructor() {
+        const token = process.env.JETTY_API_TOKEN;
+        if (!token) {
+            throw new Error("JETTY_API_TOKEN environment variable is required. " +
+                "Get your token at https://flows.jetty.io → Settings → API Tokens");
+        }
+        this.token = token;
+        this.dockUrl = DOCK_URL;
+        this.flowsUrl = FLOWS_URL;
+    }
+    async request(baseUrl, path, options = {}) {
+        const url = `${baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            ...(options.headers || {}),
+        };
+        const res = await fetch(url, { ...options, headers });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`Jetty API error ${res.status}: ${body}`);
+        }
+        const contentType = res.headers.get("content-type") || "";
+        if (contentType.includes("application/json")) {
+            return res.json();
+        }
+        return res.text();
+    }
+    dock(path, options) {
+        return this.request(this.dockUrl, path, options);
+    }
+    flows(path, options) {
+        return this.request(this.flowsUrl, path, options);
+    }
+    // Collections
+    async listCollections() {
+        return this.dock("/api/v1/collections/");
+    }
+    async getCollection(collection) {
+        return this.dock(`/api/v1/collections/${collection}`);
+    }
+    // Tasks
+    async listTasks(collection) {
+        return this.dock(`/api/v1/tasks/${collection}/`);
+    }
+    async getTask(collection, task) {
+        return this.dock(`/api/v1/tasks/${collection}/${task}`);
+    }
+    async createTask(collection, name, workflow, description) {
+        return this.dock(`/api/v1/tasks/${collection}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ name, description: description || "", workflow }),
+        });
+    }
+    async updateTask(collection, task, updates) {
+        return this.dock(`/api/v1/tasks/${collection}/${task}`, {
+            method: "PUT",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(updates),
+        });
+    }
+    async deleteTask(collection, task) {
+        return this.dock(`/api/v1/tasks/${collection}/${task}`, {
+            method: "DELETE",
+        });
+    }
+    // Run workflows
+    async runWorkflow(collection, task, initParams) {
+        const formData = new FormData();
+        formData.append("bakery_host", this.dockUrl);
+        formData.append("init_params", JSON.stringify(initParams || {}));
+        return this.flows(`/api/v1/run/${collection}/${task}`, {
+            method: "POST",
+            body: formData,
+        });
+    }
+    async runWorkflowSync(collection, task, initParams) {
+        const formData = new FormData();
+        formData.append("bakery_host", this.dockUrl);
+        formData.append("init_params", JSON.stringify(initParams || {}));
+        return this.flows(`/api/v1/run-sync/${collection}/${task}`, {
+            method: "POST",
+            body: formData,
+        });
+    }
+    // Trajectories
+    async listTrajectories(collection, task, limit = 10, page = 1) {
+        return this.flows(`/api/v1/db/trajectories/${collection}/${task}?limit=${limit}&page=${page}`);
+    }
+    async getTrajectory(collection, task, trajectoryId) {
+        return this.flows(`/api/v1/db/trajectory/${collection}/${task}/${trajectoryId}`);
+    }
+    // Stats
+    async getStats(collection, task) {
+        return this.flows(`/api/v1/db/stats/${collection}/${task}`);
+    }
+    // Labels
+    async addLabel(collection, task, trajectoryId, key, value, author) {
+        return this.flows(`/api/v1/trajectory/${collection}/${task}/${trajectoryId}/labels`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ key, value, author }),
+        });
+    }
+    // Workflow logs
+    async getWorkflowLogs(workflowId) {
+        return this.flows(`/api/v1/workflows-logs/${workflowId}`);
+    }
+    // Step templates
+    async listStepTemplates() {
+        return this.request(this.flowsUrl, "/api/v1/step-templates");
+    }
+    async getStepTemplate(name) {
+        return this.request(this.flowsUrl, `/api/v1/step-templates/${name}`);
+    }
+    // Environment variables
+    async setEnvironmentVars(collection, vars) {
+        return this.dock(`/api/v1/collections/${collection}/environment`, {
+            method: "PATCH",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ environment_variables: vars }),
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { JettyClient } from "./client.js";
+import { registerTools } from "./tools.js";
+const server = new McpServer({
+    name: "jetty",
+    version: "1.0.0",
+});
+const client = new JettyClient();
+registerTools(server, client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;AACjC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { JettyClient } from "./client.js";
+export declare function registerTools(server: McpServer, client: JettyClient): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ1C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAmNnE"}

package/dist/tools.js

@@ -0,0 +1,114 @@
+import { z } from "zod";
+function jsonResult(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+export function registerTools(server, client) {
+    // ── Collections ──────────────────────────────────────────────
+    server.tool("list-collections", "List all collections", {}, async () => {
+        return jsonResult(await client.listCollections());
+    });
+    server.tool("get-collection", "Get collection details including environment variable keys", { collection: z.string().describe("Collection name") }, async ({ collection }) => {
+        return jsonResult(await client.getCollection(collection));
+    });
+    // ── Tasks ────────────────────────────────────────────────────
+    server.tool("list-tasks", "List tasks in a collection", { collection: z.string().describe("Collection name") }, async ({ collection }) => {
+        return jsonResult(await client.listTasks(collection));
+    });
+    server.tool("get-task", "Get task details including workflow definition", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+    }, async ({ collection, task }) => {
+        return jsonResult(await client.getTask(collection, task));
+    });
+    server.tool("create-task", "Create a new task with a workflow definition", {
+        collection: z.string().describe("Collection name"),
+        name: z.string().describe("Task name"),
+        description: z.string().optional().describe("Task description"),
+        workflow: z
+            .record(z.unknown())
+            .describe("Workflow JSON with init_params, step_configs, and steps"),
+    }, async ({ collection, name, description, workflow }) => {
+        return jsonResult(await client.createTask(collection, name, workflow, description));
+    });
+    server.tool("update-task", "Update a task's workflow or description", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+        workflow: z
+            .record(z.unknown())
+            .optional()
+            .describe("Updated workflow JSON"),
+        description: z.string().optional().describe("Updated description"),
+    }, async ({ collection, task, workflow, description }) => {
+        const updates = {};
+        if (workflow)
+            updates.workflow = workflow;
+        if (description)
+            updates.description = description;
+        return jsonResult(await client.updateTask(collection, task, updates));
+    });
+    // ── Run Workflows ────────────────────────────────────────────
+    server.tool("run-workflow", "Run a workflow asynchronously (returns immediately with workflow_id)", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+        init_params: z
+            .record(z.unknown())
+            .optional()
+            .describe("Input parameters for the workflow"),
+    }, async ({ collection, task, init_params }) => {
+        return jsonResult(await client.runWorkflow(collection, task, init_params));
+    });
+    server.tool("run-workflow-sync", "Run a workflow synchronously (blocks until completion, may take 30-60s)", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+        init_params: z
+            .record(z.unknown())
+            .optional()
+            .describe("Input parameters for the workflow"),
+    }, async ({ collection, task, init_params }) => {
+        return jsonResult(await client.runWorkflowSync(collection, task, init_params));
+    });
+    // ── Trajectories ─────────────────────────────────────────────
+    server.tool("list-trajectories", "List recent workflow runs (trajectories) for a task", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+        limit: z.number().optional().default(10).describe("Max results"),
+        page: z.number().optional().default(1).describe("Page number"),
+    }, async ({ collection, task, limit, page }) => {
+        return jsonResult(await client.listTrajectories(collection, task, limit, page));
+    });
+    server.tool("get-trajectory", "Get full details of a specific workflow run", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+        trajectory_id: z.string().describe("Trajectory ID"),
+    }, async ({ collection, task, trajectory_id }) => {
+        return jsonResult(await client.getTrajectory(collection, task, trajectory_id));
+    });
+    // ── Stats ────────────────────────────────────────────────────
+    server.tool("get-stats", "Get execution statistics for a task", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+    }, async ({ collection, task }) => {
+        return jsonResult(await client.getStats(collection, task));
+    });
+    // ── Labels ───────────────────────────────────────────────────
+    server.tool("add-label", "Add a label to a trajectory (e.g., quality=high)", {
+        collection: z.string().describe("Collection name"),
+        task: z.string().describe("Task name"),
+        trajectory_id: z.string().describe("Trajectory ID"),
+        key: z.string().describe("Label key (e.g., 'quality', 'status')"),
+        value: z.string().describe("Label value (e.g., 'high', 'approved')"),
+        author: z.string().describe("Author email"),
+    }, async ({ collection, task, trajectory_id, key, value, author }) => {
+        return jsonResult(await client.addLabel(collection, task, trajectory_id, key, value, author));
+    });
+    // ── Step Templates ───────────────────────────────────────────
+    server.tool("list-step-templates", "List all available workflow step templates", {}, async () => {
+        return jsonResult(await client.listStepTemplates());
+    });
+    server.tool("get-step-template", "Get details and schema for a step template", { name: z.string().describe("Step template activity name") }, async ({ name }) => {
+        return jsonResult(await client.getStepTemplate(name));
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "jetty-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Jetty AI/ML workflow platform",
+  "type": "module",
+  "bin": {
+    "jetty-mcp-server": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["mcp", "jetty", "ai", "ml", "workflows"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/client.ts

@@ -0,0 +1,206 @@
+const DOCK_URL = process.env.JETTY_DOCK_URL || "https://dock.jetty.io";
+const FLOWS_URL = process.env.JETTY_FLOWS_URL || "https://flows-api.jetty.io";
+
+export class JettyClient {
+  private token: string;
+  private dockUrl: string;
+  private flowsUrl: string;
+
+  constructor() {
+    const token = process.env.JETTY_API_TOKEN;
+    if (!token) {
+      throw new Error(
+        "JETTY_API_TOKEN environment variable is required. " +
+          "Get your token at https://flows.jetty.io → Settings → API Tokens"
+      );
+    }
+    this.token = token;
+    this.dockUrl = DOCK_URL;
+    this.flowsUrl = FLOWS_URL;
+  }
+
+  private async request(
+    baseUrl: string,
+    path: string,
+    options: RequestInit = {}
+  ): Promise<unknown> {
+    const url = `${baseUrl}${path}`;
+    const headers: Record<string, string> = {
+      Authorization: `Bearer ${this.token}`,
+      ...((options.headers as Record<string, string>) || {}),
+    };
+
+    const res = await fetch(url, { ...options, headers });
+
+    if (!res.ok) {
+      const body = await res.text();
+      throw new Error(`Jetty API error ${res.status}: ${body}`);
+    }
+
+    const contentType = res.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      return res.json();
+    }
+    return res.text();
+  }
+
+  private dock(path: string, options?: RequestInit) {
+    return this.request(this.dockUrl, path, options);
+  }
+
+  private flows(path: string, options?: RequestInit) {
+    return this.request(this.flowsUrl, path, options);
+  }
+
+  // Collections
+  async listCollections() {
+    return this.dock("/api/v1/collections/");
+  }
+
+  async getCollection(collection: string) {
+    return this.dock(`/api/v1/collections/${collection}`);
+  }
+
+  // Tasks
+  async listTasks(collection: string) {
+    return this.dock(`/api/v1/tasks/${collection}/`);
+  }
+
+  async getTask(collection: string, task: string) {
+    return this.dock(`/api/v1/tasks/${collection}/${task}`);
+  }
+
+  async createTask(
+    collection: string,
+    name: string,
+    workflow: unknown,
+    description?: string
+  ) {
+    return this.dock(`/api/v1/tasks/${collection}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ name, description: description || "", workflow }),
+    });
+  }
+
+  async updateTask(
+    collection: string,
+    task: string,
+    updates: { workflow?: unknown; description?: string }
+  ) {
+    return this.dock(`/api/v1/tasks/${collection}/${task}`, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(updates),
+    });
+  }
+
+  async deleteTask(collection: string, task: string) {
+    return this.dock(`/api/v1/tasks/${collection}/${task}`, {
+      method: "DELETE",
+    });
+  }
+
+  // Run workflows
+  async runWorkflow(
+    collection: string,
+    task: string,
+    initParams?: Record<string, unknown>
+  ) {
+    const formData = new FormData();
+    formData.append("bakery_host", this.dockUrl);
+    formData.append("init_params", JSON.stringify(initParams || {}));
+
+    return this.flows(`/api/v1/run/${collection}/${task}`, {
+      method: "POST",
+      body: formData,
+    });
+  }
+
+  async runWorkflowSync(
+    collection: string,
+    task: string,
+    initParams?: Record<string, unknown>
+  ) {
+    const formData = new FormData();
+    formData.append("bakery_host", this.dockUrl);
+    formData.append("init_params", JSON.stringify(initParams || {}));
+
+    return this.flows(`/api/v1/run-sync/${collection}/${task}`, {
+      method: "POST",
+      body: formData,
+    });
+  }
+
+  // Trajectories
+  async listTrajectories(
+    collection: string,
+    task: string,
+    limit = 10,
+    page = 1
+  ) {
+    return this.flows(
+      `/api/v1/db/trajectories/${collection}/${task}?limit=${limit}&page=${page}`
+    );
+  }
+
+  async getTrajectory(
+    collection: string,
+    task: string,
+    trajectoryId: string
+  ) {
+    return this.flows(
+      `/api/v1/db/trajectory/${collection}/${task}/${trajectoryId}`
+    );
+  }
+
+  // Stats
+  async getStats(collection: string, task: string) {
+    return this.flows(`/api/v1/db/stats/${collection}/${task}`);
+  }
+
+  // Labels
+  async addLabel(
+    collection: string,
+    task: string,
+    trajectoryId: string,
+    key: string,
+    value: string,
+    author: string
+  ) {
+    return this.flows(
+      `/api/v1/trajectory/${collection}/${task}/${trajectoryId}/labels`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ key, value, author }),
+      }
+    );
+  }
+
+  // Workflow logs
+  async getWorkflowLogs(workflowId: string) {
+    return this.flows(`/api/v1/workflows-logs/${workflowId}`);
+  }
+
+  // Step templates
+  async listStepTemplates() {
+    return this.request(this.flowsUrl, "/api/v1/step-templates");
+  }
+
+  async getStepTemplate(name: string) {
+    return this.request(this.flowsUrl, `/api/v1/step-templates/${name}`);
+  }
+
+  // Environment variables
+  async setEnvironmentVars(
+    collection: string,
+    vars: Record<string, string>
+  ) {
+    return this.dock(`/api/v1/collections/${collection}/environment`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ environment_variables: vars }),
+    });
+  }
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { JettyClient } from "./client.js";
+import { registerTools } from "./tools.js";
+
+const server = new McpServer({
+  name: "jetty",
+  version: "1.0.0",
+});
+
+const client = new JettyClient();
+registerTools(server, client);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools.ts

@@ -0,0 +1,222 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { JettyClient } from "./client.js";
+
+function jsonResult(data: unknown) {
+  return {
+    content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }],
+  };
+}
+
+export function registerTools(server: McpServer, client: JettyClient) {
+  // ── Collections ──────────────────────────────────────────────
+
+  server.tool("list-collections", "List all collections", {}, async () => {
+    return jsonResult(await client.listCollections());
+  });
+
+  server.tool(
+    "get-collection",
+    "Get collection details including environment variable keys",
+    { collection: z.string().describe("Collection name") },
+    async ({ collection }) => {
+      return jsonResult(await client.getCollection(collection));
+    }
+  );
+
+  // ── Tasks ────────────────────────────────────────────────────
+
+  server.tool(
+    "list-tasks",
+    "List tasks in a collection",
+    { collection: z.string().describe("Collection name") },
+    async ({ collection }) => {
+      return jsonResult(await client.listTasks(collection));
+    }
+  );
+
+  server.tool(
+    "get-task",
+    "Get task details including workflow definition",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+    },
+    async ({ collection, task }) => {
+      return jsonResult(await client.getTask(collection, task));
+    }
+  );
+
+  server.tool(
+    "create-task",
+    "Create a new task with a workflow definition",
+    {
+      collection: z.string().describe("Collection name"),
+      name: z.string().describe("Task name"),
+      description: z.string().optional().describe("Task description"),
+      workflow: z
+        .record(z.unknown())
+        .describe(
+          "Workflow JSON with init_params, step_configs, and steps"
+        ),
+    },
+    async ({ collection, name, description, workflow }) => {
+      return jsonResult(
+        await client.createTask(collection, name, workflow, description)
+      );
+    }
+  );
+
+  server.tool(
+    "update-task",
+    "Update a task's workflow or description",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+      workflow: z
+        .record(z.unknown())
+        .optional()
+        .describe("Updated workflow JSON"),
+      description: z.string().optional().describe("Updated description"),
+    },
+    async ({ collection, task, workflow, description }) => {
+      const updates: { workflow?: unknown; description?: string } = {};
+      if (workflow) updates.workflow = workflow;
+      if (description) updates.description = description;
+      return jsonResult(await client.updateTask(collection, task, updates));
+    }
+  );
+
+  // ── Run Workflows ────────────────────────────────────────────
+
+  server.tool(
+    "run-workflow",
+    "Run a workflow asynchronously (returns immediately with workflow_id)",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+      init_params: z
+        .record(z.unknown())
+        .optional()
+        .describe("Input parameters for the workflow"),
+    },
+    async ({ collection, task, init_params }) => {
+      return jsonResult(
+        await client.runWorkflow(
+          collection,
+          task,
+          init_params as Record<string, unknown>
+        )
+      );
+    }
+  );
+
+  server.tool(
+    "run-workflow-sync",
+    "Run a workflow synchronously (blocks until completion, may take 30-60s)",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+      init_params: z
+        .record(z.unknown())
+        .optional()
+        .describe("Input parameters for the workflow"),
+    },
+    async ({ collection, task, init_params }) => {
+      return jsonResult(
+        await client.runWorkflowSync(
+          collection,
+          task,
+          init_params as Record<string, unknown>
+        )
+      );
+    }
+  );
+
+  // ── Trajectories ─────────────────────────────────────────────
+
+  server.tool(
+    "list-trajectories",
+    "List recent workflow runs (trajectories) for a task",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+      limit: z.number().optional().default(10).describe("Max results"),
+      page: z.number().optional().default(1).describe("Page number"),
+    },
+    async ({ collection, task, limit, page }) => {
+      return jsonResult(
+        await client.listTrajectories(collection, task, limit, page)
+      );
+    }
+  );
+
+  server.tool(
+    "get-trajectory",
+    "Get full details of a specific workflow run",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+      trajectory_id: z.string().describe("Trajectory ID"),
+    },
+    async ({ collection, task, trajectory_id }) => {
+      return jsonResult(
+        await client.getTrajectory(collection, task, trajectory_id)
+      );
+    }
+  );
+
+  // ── Stats ────────────────────────────────────────────────────
+
+  server.tool(
+    "get-stats",
+    "Get execution statistics for a task",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+    },
+    async ({ collection, task }) => {
+      return jsonResult(await client.getStats(collection, task));
+    }
+  );
+
+  // ── Labels ───────────────────────────────────────────────────
+
+  server.tool(
+    "add-label",
+    "Add a label to a trajectory (e.g., quality=high)",
+    {
+      collection: z.string().describe("Collection name"),
+      task: z.string().describe("Task name"),
+      trajectory_id: z.string().describe("Trajectory ID"),
+      key: z.string().describe("Label key (e.g., 'quality', 'status')"),
+      value: z.string().describe("Label value (e.g., 'high', 'approved')"),
+      author: z.string().describe("Author email"),
+    },
+    async ({ collection, task, trajectory_id, key, value, author }) => {
+      return jsonResult(
+        await client.addLabel(collection, task, trajectory_id, key, value, author)
+      );
+    }
+  );
+
+  // ── Step Templates ───────────────────────────────────────────
+
+  server.tool(
+    "list-step-templates",
+    "List all available workflow step templates",
+    {},
+    async () => {
+      return jsonResult(await client.listStepTemplates());
+    }
+  );
+
+  server.tool(
+    "get-step-template",
+    "Get details and schema for a step template",
+    { name: z.string().describe("Step template activity name") },
+    async ({ name }) => {
+      return jsonResult(await client.getStepTemplate(name));
+    }
+  );
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}