doubleoh-mcp 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# doubleoh-mcp
+
+**The DoubleOh fix loop as an MCP server.** Any MCP-capable agent — Claude Code, Claude
+Desktop, and the growing list of clients — gets the loop as three tools with zero
+integration code.
+
+```json
+{
+  "mcpServers": {
+    "doubleoh": {
+      "command": "bunx",
+      "args": ["doubleoh-mcp"],
+      "env": { "DOUBLEOH_API_KEY": "oo_live_…" }
+    }
+  }
+}
+```
+
+## The tools
+
+- **`doubleoh_skills_for`** — before attempting a task it has failed at before, the agent
+  asks what has been learned and receives step-by-step procedures from past human fixes,
+  with each one's track record.
+- **`doubleoh_request_fix`** — when stuck, the agent asks for a human. If the fleet
+  already knows the wall, the procedure comes back instantly instead and nobody is paged.
+  Duplicate walls are answered with "already being fixed, N runs blocked" — an agent in a
+  retry loop never spams a team.
+- **`doubleoh_report_skill`** — after following a skill, the agent reports whether it
+  worked. Skills that keep failing stop being served.
+
+Refusals (a private URL, a quota) come back as readable tool results, not protocol
+errors — the model is told what went wrong in a sentence it can act on.
+
+`DOUBLEOH_BASE_URL` points at a self-hosted deployment; it defaults to the hosted service.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+/** The binary: read the environment, speak stdio. Plain Node — no bun required. */
+export {};

package/dist/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/** The binary: read the environment, speak stdio. Plain Node — no bun required. */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { DoubleOh } from "@doubleoh/sdk";
+import { createServer } from "./index.js";
+const apiKey = process.env.DOUBLEOH_API_KEY;
+if (!apiKey) {
+    console.error("DOUBLEOH_API_KEY is required (it starts with oo_).");
+    process.exit(1);
+}
+const client = new DoubleOh({
+    apiKey,
+    ...(process.env.DOUBLEOH_BASE_URL
+        ? { baseUrl: process.env.DOUBLEOH_BASE_URL }
+        : {}),
+});
+await createServer(client).connect(new StdioServerTransport());

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * doubleoh-mcp — the fix loop as an MCP server.
+ *
+ * Any MCP-capable agent (Claude Code, Claude Desktop, and the growing list of clients) gets the
+ * three tools with zero integration code:
+ *
+ *   { "mcpServers": { "doubleoh": {
+ *       "command": "bunx", "args": ["doubleoh-mcp"],
+ *       "env": { "DOUBLEOH_API_KEY": "oo_live_…" } } } }
+ *
+ * The tools themselves come from @doubleoh/sdk's framework-agnostic definitions — this file is only
+ * the MCP shell around them, which is the point: one definition, every framework. The low-level
+ * Server API is used on purpose: the definitions already carry JSON Schema, which is what MCP puts
+ * on the wire, so translating them through zod would be a round trip to nowhere.
+ */
+import { DoubleOh } from "@doubleoh/sdk";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function createServer(client: DoubleOh): Server;

package/dist/index.js

@@ -0,0 +1,56 @@
+/**
+ * doubleoh-mcp — the fix loop as an MCP server.
+ *
+ * Any MCP-capable agent (Claude Code, Claude Desktop, and the growing list of clients) gets the
+ * three tools with zero integration code:
+ *
+ *   { "mcpServers": { "doubleoh": {
+ *       "command": "bunx", "args": ["doubleoh-mcp"],
+ *       "env": { "DOUBLEOH_API_KEY": "oo_live_…" } } } }
+ *
+ * The tools themselves come from @doubleoh/sdk's framework-agnostic definitions — this file is only
+ * the MCP shell around them, which is the point: one definition, every framework. The low-level
+ * Server API is used on purpose: the definitions already carry JSON Schema, which is what MCP puts
+ * on the wire, so translating them through zod would be a round trip to nowhere.
+ */
+import { DoubleOhError } from "@doubleoh/sdk";
+import { doubleohTools } from "@doubleoh/sdk/tools";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+export function createServer(client) {
+    const tools = doubleohTools(client);
+    const server = new Server({ name: "doubleoh", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.parameters,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = tools.find((candidate) => candidate.name === request.params.name);
+        if (!tool) {
+            return {
+                content: [
+                    { type: "text", text: `No tool named ${request.params.name}.` },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const text = await tool.execute(request.params.arguments ?? {});
+            return { content: [{ type: "text", text }] };
+        }
+        catch (error) {
+            /*
+             * A refusal is an answer the model should read, not a protocol failure: "that address is not
+             * reachable for a fix" tells the agent to stop aiming at intranet hosts.
+             */
+            const text = error instanceof DoubleOhError
+                ? `DoubleOh refused (${error.status}): ${error.message}`
+                : `DoubleOh was unreachable: ${String(error)}`;
+            return { content: [{ type: "text", text }], isError: true };
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "doubleoh-mcp",
+  "version": "0.1.0",
+  "description": "The DoubleOh fix loop as an MCP server: skills_for, request_fix, report_skill.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "doubleoh-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@doubleoh/sdk": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "bun-types": "^1.4.0"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}