@monnet/mcp 0.1.0

package/dist/tools/update-motion.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { apiFetch, resolveWorkspaceId } from "../client.js";
+const PlanStepSchema = z.object({
+    content: z.string(),
+    status: z.enum(["pending", "in_progress", "done"]),
+    assignees: z.array(z.string()).optional().default([]),
+    approval: z.boolean().optional().default(false),
+    approved_by: z.array(z.string()).optional().default([]),
+});
+const UpdateMotionArgs = z.object({
+    workspace_slug: z.string().min(1),
+    motion_short_id: z.string().min(1),
+    summary: z.string().min(1).max(500).optional(),
+    body: z.string().min(1).max(50000).optional(),
+    priority: z.enum(["critical", "normal", "low"]).optional(),
+    plan: z.array(PlanStepSchema).optional(),
+});
+export async function handleUpdateMotion(args) {
+    const parsed = UpdateMotionArgs.parse(args);
+    const wsId = await resolveWorkspaceId(parsed.workspace_slug);
+    const motionPath = `/workspaces/${wsId}/motions/${encodeURIComponent(parsed.motion_short_id)}`;
+    const results = [];
+    // Update metadata (summary/body/priority) if any provided
+    const metaFields = {};
+    if (parsed.summary !== undefined)
+        metaFields.summary = parsed.summary;
+    if (parsed.body !== undefined)
+        metaFields.body = parsed.body;
+    if (parsed.priority !== undefined)
+        metaFields.priority = parsed.priority;
+    if (Object.keys(metaFields).length > 0) {
+        await apiFetch(motionPath, {
+            method: "PATCH",
+            body: JSON.stringify(metaFields),
+        });
+        results.push(`Updated ${Object.keys(metaFields).join(", ")}.`);
+    }
+    // Update plan if provided
+    if (parsed.plan) {
+        await apiFetch(`${motionPath}/plan`, {
+            method: "PATCH",
+            body: JSON.stringify({ steps: parsed.plan }),
+        });
+        results.push(`Updated plan (${parsed.plan.length} step(s)).`);
+    }
+    if (results.length === 0) {
+        return "Nothing to update — provide at least one of: summary, body, priority, or plan.";
+    }
+    return results.join(" ");
+}
+export const UPDATE_MOTION_TOOL_DEFINITION = {
+    name: "update_motion",
+    description: "Update a motion's summary, body, priority, or plan. All fields are optional — " +
+        "only include the ones you want to change. For plan updates, provide the full list " +
+        "of steps (use get_motion first to see the current plan, then modify and send it back).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            workspace_slug: {
+                type: "string",
+                description: "The workspace slug.",
+            },
+            motion_short_id: {
+                type: "string",
+                description: "The first 8 characters of the motion UUID.",
+            },
+            summary: {
+                type: "string",
+                description: "New summary (1-500 chars). Optional.",
+            },
+            body: {
+                type: "string",
+                description: "New body in markdown (1-50,000 chars). Optional.",
+            },
+            priority: {
+                type: "string",
+                description: "New priority. Optional.",
+                enum: ["critical", "normal", "low"],
+            },
+            plan: {
+                type: "array",
+                description: "Full replacement plan — array of step objects. Each step: {content, status, assignees?, approval?, approved_by?}. Optional.",
+                items: {
+                    type: "object",
+                    properties: {
+                        content: { type: "string" },
+                        status: { type: "string", enum: ["pending", "in_progress", "done"] },
+                        assignees: { type: "array", items: { type: "string" } },
+                        approval: { type: "boolean" },
+                        approved_by: { type: "array", items: { type: "string" } },
+                    },
+                    required: ["content", "status"],
+                },
+            },
+        },
+        required: ["workspace_slug", "motion_short_id"],
+    },
+};
+//# sourceMappingURL=update-motion.js.map

package/dist/tools/update-motion.js.map

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

package/dist/tools/whoami.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Validation tool — calls GET /users/me/api-keys with the user's API key and
+ * reports back. Useful for confirming the MCP is correctly authenticated and
+ * can reach the backend.
+ */
+export declare function handleWhoami(): Promise<string>;
+export declare const WHOAMI_TOOL_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+};

package/dist/tools/whoami.js

@@ -0,0 +1,26 @@
+import { apiFetch } from "../client.js";
+/**
+ * Validation tool — calls GET /users/me/api-keys with the user's API key and
+ * reports back. Useful for confirming the MCP is correctly authenticated and
+ * can reach the backend.
+ */
+export async function handleWhoami() {
+    const keys = await apiFetch("/users/me/api-keys");
+    if (keys.length === 0) {
+        return ("Connected to Monnet. No active API keys on this account " +
+            "(unexpected — the one you're using should be listed).");
+    }
+    const lines = keys.map((k) => `  - ${k.name} (${k.key_prefix}…)`);
+    return `Connected to Monnet with ${keys.length} active API key(s):\n${lines.join("\n")}`;
+}
+export const WHOAMI_TOOL_DEFINITION = {
+    name: "monnet_whoami",
+    description: "Verify your Monnet MCP connection and list the API keys on your account. " +
+        "Useful for debugging setup issues.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+};
+//# sourceMappingURL=whoami.js.map

package/dist/tools/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/tools/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAUxC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAW,oBAAoB,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CACL,0DAA0D;YAC1D,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;IAClE,OAAO,4BAA4B,IAAI,CAAC,MAAM,wBAAwB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,2EAA2E;QAC3E,oCAAoC;IACtC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@monnet/mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Monnet — exposes motions, plans, and approvals to MCP-compatible clients like Claude Desktop and Cursor.",
+  "type": "module",
+  "bin": {
+    "monnet-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p .",
+    "dev": "tsc -p . --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}