@getthesis/mcp-server 0.1.0

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@getthesis/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Thesis — gives AI agents direct access to strategic context",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "thesis-mcp": "src/index.js"
+  },
+  "files": [
+    "src/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.25.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// ─── Config ──────────────────────────────────────────────────────────
+
+const API_URL = process.env.THESIS_API_URL || "https://www.getthesis.io";
+const API_KEY = process.env.THESIS_API_KEY;
+
+async function api(path, options = {}) {
+  if (!API_KEY) throw new Error("THESIS_API_KEY not set");
+
+  const res = await fetch(`${API_URL}${path}`, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+      ...options.headers,
+    },
+  });
+
+  const contentType = res.headers.get("content-type") || "";
+  if (contentType.includes("application/json")) {
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error || `HTTP ${res.status}`);
+    return data;
+  }
+  const text = await res.text();
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  return text;
+}
+
+// ─── Server ──────────────────────────────────────────────────────────
+
+const server = new McpServer({ name: "thesis", version: "0.1.0" });
+
+// ─── Tools ───────────────────────────────────────────────────────────
+
+server.tool(
+  "thesis_get_brief",
+  "Get the full strategic brief for a workbench item. Returns the item's context including linked beliefs, theme, success criteria, constraints, and design principles. Use this before starting work on an item.",
+  { itemId: z.string().describe("The item ID") },
+  async ({ itemId }) => {
+    try {
+      const brief = await api(`/api/v1/items/${itemId}/brief`);
+      return { content: [{ type: "text", text: typeof brief === "string" ? brief : JSON.stringify(brief, null, 2) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  "thesis_list_items",
+  "List items in the Thesis workbench. Shows items ready for agent execution, dispatched, or awaiting review.",
+  {
+    status: z.enum(["ready", "dispatched", "in_progress", "review", "completed"]).optional().describe("Filter by agent status"),
+  },
+  async ({ status }) => {
+    try {
+      const query = status ? `?agentStatus=${status}` : "";
+      const data = await api(`/api/v1/items${query}`);
+      if (!data.items?.length) return { content: [{ type: "text", text: "No items found." }] };
+      const lines = data.items.map((i) => `- [${i.agentStatus || i.status}] ${i.title} (ID: ${i.id})`);
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  "thesis_dispatch",
+  "Dispatch an item for agent execution. Assembles the strategic brief, marks the item as dispatched, and returns the full brief. Call this when starting work on an item.",
+  { itemId: z.string().describe("The item ID to dispatch") },
+  async ({ itemId }) => {
+    try {
+      const data = await api(`/api/v1/items/${itemId}/dispatch`, {
+        method: "POST",
+        body: JSON.stringify({ provider: "claude_code" }),
+      });
+      return { content: [{ type: "text", text: data.brief || JSON.stringify(data, null, 2) }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  "thesis_report_outcome",
+  "Report the outcome of completed work back to Thesis. This triggers AI analysis against the workspace's strategic beliefs to generate evidence.",
+  {
+    itemId: z.string().describe("The item ID"),
+    summary: z.string().describe("What was built"),
+    decisions: z.string().optional().describe("Key decisions made and why"),
+    unexpected: z.string().optional().describe("Anything unexpected encountered"),
+    successCriteriaMet: z.boolean().nullable().optional().describe("true = met, false = not met, null = partially"),
+  },
+  async ({ itemId, summary, decisions, unexpected, successCriteriaMet }) => {
+    try {
+      const data = await api(`/api/v1/items/${itemId}/outcome`, {
+        method: "POST",
+        body: JSON.stringify({ summary, decisions, unexpected, successCriteriaMet }),
+      });
+      return { content: [{ type: "text", text: `Outcome recorded. Status: ${data.status || "review"}. Evidence analysis running.` }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  "thesis_get_beliefs",
+  "Get all active strategic beliefs in the workspace with confidence levels. Use this to understand the strategic context.",
+  {},
+  async () => {
+    try {
+      const data = await api("/api/v1/beliefs");
+      if (!data.beliefs?.length) return { content: [{ type: "text", text: "No active beliefs." }] };
+      const lines = data.beliefs.map((b) => `- [${b.confidence}] ${b.statement}`);
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+server.tool(
+  "thesis_check_shifts",
+  "Check if any beliefs have shifted since items were dispatched. Use this to verify the strategic ground hasn't moved during execution.",
+  {},
+  async () => {
+    try {
+      const data = await api("/api/v1/check");
+      if (!data.hasShifts) return { content: [{ type: "text", text: "All clear — no belief shifts." }] };
+      const lines = [];
+      if (data.changedBeliefs?.length) {
+        lines.push("Changed beliefs:");
+        data.changedBeliefs.forEach((b) => lines.push(`  - [${b.confidence}] ${b.statement}`));
+      }
+      if (data.shiftedItems?.length) {
+        lines.push("Affected items:");
+        data.shiftedItems.forEach((i) => lines.push(`  - ${i.title} (${i.agentStatus})`));
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    } catch (err) {
+      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
+// ─── Start ───────────────────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("Thesis MCP server running");