@poolzin/pool-bot 2026.4.34 → 2026.4.36

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.4.34",
-  "commit": "b8effc9024bae6e44840b2e4f8f46cc63126bd61",
-  "builtAt": "2026-04-07T11:05:36.639Z"
+  "version": "2026.4.36",
+  "commit": "713ea950b901906b93c4bd9d8a313731671f40e5",
+  "builtAt": "2026-04-07T11:46:07.534Z"
 }

package/dist/cli/mcp-cli.d.ts

@@ -6,5 +6,6 @@
  *   poolbot mcp serve --http       # Start MCP server on HTTP (port 3000)
  *   poolbot mcp serve --http --port 3001
  */
-export declare function runMCPCLI(args: string[]): Promise<void>;
+import type { Command } from "commander";
+export declare function registerMCPCli(program: Command): void;
 //# sourceMappingURL=mcp-cli.d.ts.map

package/dist/cli/mcp-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-cli.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC7D"}
+{"version":3,"file":"mcp-cli.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,QAqD9C"}

package/dist/cli/mcp-cli.js

@@ -9,36 +9,53 @@
 import { runMCPServer } from "../mcp/server.js";
 import { loadConfig } from "../config/config.js";
 import { resolveDefaultAgentId } from "../agents/agent-scope.js";
-export async function runMCPCLI(args) {
-    const config = loadConfig();
-    const agentId = resolveDefaultAgentId(config);
-    const isHTTP = args.includes("--http");
-    const portArg = args.find((arg) => arg.startsWith("--port="));
-    const port = portArg ? parseInt(portArg.split("=")[1], 10) : undefined;
-    const readOnly = args.includes("--read-only");
-    console.error("Starting PoolBot MCP Server...");
-    console.error(`  Agent: ${agentId}`);
-    console.error(`  Mode: ${isHTTP ? "HTTP" : "stdio"}`);
-    if (isHTTP) {
-        console.error(`  Port: ${port || 3000}`);
-    }
-    if (readOnly) {
-        console.error("  Read-only mode: enabled");
-    }
-    console.error("");
-    console.error("For Claude Desktop, add to claude_desktop_config.json:");
-    console.error(JSON.stringify({
-        mcpServers: {
-            poolbot: {
-                command: "poolbot",
-                args: ["mcp", "serve"],
+import { runCommandWithRuntime } from "./cli-utils.js";
+import { defaultRuntime } from "../runtime.js";
+import { theme } from "../terminal/theme.js";
+import { formatDocsLink } from "../terminal/links.js";
+export function registerMCPCli(program) {
+    const mcp = program
+        .command("mcp")
+        .description("Model Context Protocol server for PoolBot")
+        .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/mcp-server", "docs.molt.bot/mcp-server")}\n`);
+    mcp
+        .command("serve")
+        .description("Start MCP server")
+        .option("--http", "Use HTTP transport instead of stdio")
+        .option("--port <number>", "HTTP port (default: 3000)")
+        .option("--read-only", "Disable send_message tool")
+        .action(async (opts) => {
+        const config = loadConfig();
+        const agentId = resolveDefaultAgentId(config);
+        const isHTTP = opts.http === true;
+        const port = opts.port ? parseInt(opts.port, 10) : undefined;
+        const readOnly = opts.readOnly === true;
+        defaultRuntime.log("Starting PoolBot MCP Server...");
+        defaultRuntime.log(`  Agent: ${agentId}`);
+        defaultRuntime.log(`  Mode: ${isHTTP ? "HTTP" : "stdio"}`);
+        if (isHTTP) {
+            defaultRuntime.log(`  Port: ${port || 3000}`);
+        }
+        if (readOnly) {
+            defaultRuntime.log("  Read-only mode: enabled");
+        }
+        defaultRuntime.log("");
+        defaultRuntime.log("For Claude Desktop, add to claude_desktop_config.json:");
+        defaultRuntime.log(JSON.stringify({
+            mcpServers: {
+                poolbot: {
+                    command: "poolbot",
+                    args: ["mcp", "serve"],
+                },
             },
-        },
-    }, null, 2));
-    console.error("");
-    await runMCPServer({
-        agentId,
-        httpPort: port,
-        readOnly,
+        }, null, 2));
+        defaultRuntime.log("");
+        await runCommandWithRuntime(defaultRuntime, async () => {
+            await runMCPServer({
+                agentId,
+                httpPort: port,
+                readOnly,
+            });
+        });
     });
 }

package/dist/cli/program/register.subclis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.subclis.d.ts","sourceRoot":"","sources":["../../../src/cli/program/register.subclis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAElE,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AA8RF,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED,wBAAgB,gCAAgC,IAAI,MAAM,EAAE,CAE3D;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ3F;AAaD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,MAAM,EAAiB,QAkBrF"}
+{"version":3,"file":"register.subclis.d.ts","sourceRoot":"","sources":["../../../src/cli/program/register.subclis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAElE,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAuSF,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED,wBAAgB,gCAAgC,IAAI,MAAM,EAAE,CAE3D;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ3F;AAaD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,MAAM,EAAiB,QAkBrF"}

package/dist/cli/program/register.subclis.js

@@ -263,6 +263,15 @@ const entries = [
             mod.registerUpdateCli(program);
         },
     },
+    {
+        name: "mcp",
+        description: "Model Context Protocol server",
+        hasSubcommands: true,
+        register: async (program) => {
+            const mod = await import("../mcp-cli.js");
+            mod.registerMCPCli(program);
+        },
+    },
     {
         name: "completion",
         description: "Generate shell completion script",

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA0HD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,gBAAqB;IA2B1C,OAAO,CAAC,aAAa;IAiSrB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACG,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAID,wBAAsB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+HD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,gBAAqB;IA2B1C,OAAO,CAAC,aAAa;IAySrB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACG,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAID,wBAAsB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhF"}

package/dist/mcp/server.js

@@ -81,7 +81,8 @@ function searchSessions(workspaceDir, agentId, query, limit = 10) {
     const sessions = loadSessions(workspaceDir, agentId);
     const results = [];
     const queryLower = query.toLowerCase();
-    for (const session of sessions.slice(0, 50)) { // Limit search to recent 50 sessions
+    for (const session of sessions.slice(0, 50)) {
+        // Limit search to recent 50 sessions
         const messages = loadSessionMessages(workspaceDir, agentId, session.sessionKey);
         const matches = [];
         for (const msg of messages) {
@@ -344,7 +345,9 @@ export class PoolBotMCPServer {
                             totalMessages,
                             sessionsLast24h: last24h,
                             sessionsLast7d: last7d,
-                            oldestSession: sessions.length > 0 ? new Date(sessions[sessions.length - 1].createdAt).toISOString() : null,
+                            oldestSession: sessions.length > 0
+                                ? new Date(sessions[sessions.length - 1].createdAt).toISOString()
+                                : null,
                             newestSession: sessions.length > 0 ? new Date(sessions[0].updatedAt).toISOString() : null,
                         };
                         return {

package/docs/mcp-server.md

@@ -169,3 +169,22 @@ The MCP server:
 - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
 - [Claude Desktop MCP Setup](https://claude.ai/mcp)
 - [PoolBot Documentation](/docs/)
+
+## Direct Usage (without CLI integration)
+
+If the `poolbot mcp serve` command is not available in your version, you can run the MCP server directly with Node.js:
+
+```bash
+# stdio mode
+node -e "import('@poolzin/pool-bot/dist/mcp/server.js').then(m => m.runMCPServer())"
+
+# HTTP mode
+node -e "import('@poolzin/pool-bot/dist/mcp/server.js').then(m => m.runMCPServer(['--http', '--port=3000']))"
+```
+
+Or create a wrapper script:
+
+```bash
+#!/bin/bash
+node -e "import('@poolzin/pool-bot/dist/mcp/server.js').then(m => m.runMCPServer(process.argv.slice(2)))" "$@"
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolzin/pool-bot",
-  "version": "2026.4.34",
+  "version": "2026.4.36",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "keywords": [],
   "license": "MIT",
@@ -321,14 +321,14 @@
     "undici": "^7.21.0",
     "ws": "^8.19.0",
     "yaml": "^2.8.2",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "@modelcontextprotocol/sdk": "^1.27.1"
   },
   "devDependencies": {
     "@discordjs/voice": "^0.19.0",
     "@grammyjs/types": "^3.24.0",
     "@lit-labs/signals": "^0.2.0",
     "@lit/context": "^1.1.6",
-    "@modelcontextprotocol/sdk": "^1.27.1",
     "@types/express": "^5.0.6",
     "@types/markdown-it": "^14.1.2",
     "@types/node": "^25.2.2",