@lhremote/mcp 0.1.0 → 0.2.0

package/README.md

@@ -2,12 +2,70 @@
 
 MCP server for [lhremote](https://github.com/alexey-pelykh/lhremote) — LinkedHelper automation toolkit.
 
+This package exposes the full LinkedHelper automation surface as a [Model Context Protocol](https://modelcontextprotocol.io) server. AI assistants (Claude, etc.) connect over stdio and use the 32 registered tools to control LinkedHelper.
+
+Built on [`@lhremote/core`](../core).
+
 ## Installation
 
 ```bash
 npm install @lhremote/mcp
 ```
 
+## Usage with Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "lhremote": {
+      "command": "npx",
+      "args": ["lhremote", "mcp"]
+    }
+  }
+}
+```
+
+## Programmatic Usage
+
+```typescript
+import { createServer } from "@lhremote/mcp";
+
+const server = createServer();
+// server is a fully configured McpServer with all tools registered
+```
+
+Or start the stdio transport directly:
+
+```typescript
+import { runStdioServer } from "@lhremote/mcp/stdio";
+
+await runStdioServer();
+```
+
+## Registered Tools
+
+| Category | Tools |
+|----------|-------|
+| App Management | `find-app`, `launch-app`, `quit-app` |
+| Account & Instance | `list-accounts`, `start-instance`, `stop-instance`, `check-status` |
+| Campaigns | `campaign-list`, `campaign-create`, `campaign-get`, `campaign-export`, `campaign-update`, `campaign-delete`, `campaign-start`, `campaign-stop` |
+| Campaign Status | `campaign-status`, `campaign-statistics`, `campaign-retry` |
+| Campaign Actions | `campaign-add-action`, `campaign-remove-action`, `campaign-reorder-actions`, `campaign-move-next` |
+| Campaign Targeting | `campaign-exclude-list`, `campaign-exclude-add`, `campaign-exclude-remove`, `import-people-from-urls` |
+| Profiles & Messaging | `query-profile`, `query-profiles`, `query-messages`, `check-replies`, `scrape-messaging-history` |
+| Utilities | `describe-actions` |
+
+See the [root README](https://github.com/alexey-pelykh/lhremote#mcp-tools) for parameter details on each tool.
+
+## Exports
+
+| Export | Description |
+|--------|-------------|
+| `createServer()` | Create a configured `McpServer` with all tools registered |
+| `runStdioServer()` | Start the MCP server on stdio (from `@lhremote/mcp/stdio`) |
+
 ## License
 
 [AGPL-3.0-only](https://github.com/alexey-pelykh/lhremote/blob/main/LICENSE)

package/dist/helpers.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+type TextContent = {
+    type: "text";
+    text: string;
+};
+type McpResult = {
+    isError?: boolean;
+    content: TextContent[];
+};
+/**
+ * Shared Zod schema fields for CDP connection parameters.
+ *
+ * Spread into every tool that connects to a LinkedHelper instance:
+ * ```ts
+ * { campaignId: z.number(), ...cdpConnectionSchema }
+ * ```
+ */
+export declare const cdpConnectionSchema: {
+    cdpPort: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cdpHost: z.ZodOptional<z.ZodString>;
+    allowRemote: z.ZodOptional<z.ZodBoolean>;
+};
+/**
+ * Build the CDP connection options object from parsed tool arguments.
+ *
+ * Replaces the inline conditional-spread pattern used by tools that
+ * call `resolveAccount` or construct a `LauncherService`.
+ */
+export declare function buildCdpOptions(args: {
+    cdpHost?: string | undefined;
+    allowRemote?: boolean | undefined;
+}): {
+    host?: string;
+    allowRemote?: boolean;
+};
+/**
+ * Build an MCP error response from a plain message string.
+ */
+export declare function mcpError(text: string): McpResult;
+/**
+ * Build an MCP success response from a plain text or JSON payload.
+ */
+export declare function mcpSuccess(text: string): McpResult;
+/**
+ * Map common infrastructure errors (launcher not running, account
+ * resolution failures) and domain errors (campaign not found) to an
+ * MCP error response.
+ *
+ * Returns `undefined` if the error is not a recognised error so the
+ * caller can fall through to domain-specific handling.
+ */
+export declare function mapErrorToMcpResponse(error: unknown): McpResult | undefined;
+/**
+ * Map an arbitrary caught error to an MCP error response with a
+ * contextual prefix (e.g. "Failed to create campaign").
+ */
+export declare function mcpCatchAll(error: unknown, prefix: string): McpResult;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAClD,KAAK,SAAS,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;CAgB/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,CAK3C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAKhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAIlD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAa3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAMrE"}

package/dist/helpers.js

@@ -0,0 +1,90 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { AccountResolutionError, CampaignNotFoundError, DEFAULT_CDP_PORT, errorMessage, LinkedHelperNotRunningError, } from "@lhremote/core";
+import { z } from "zod";
+/**
+ * Shared Zod schema fields for CDP connection parameters.
+ *
+ * Spread into every tool that connects to a LinkedHelper instance:
+ * ```ts
+ * { campaignId: z.number(), ...cdpConnectionSchema }
+ * ```
+ */
+export const cdpConnectionSchema = {
+    cdpPort: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(DEFAULT_CDP_PORT)
+        .describe("CDP port"),
+    cdpHost: z
+        .string()
+        .optional()
+        .describe("CDP host (default: 127.0.0.1)"),
+    allowRemote: z
+        .boolean()
+        .optional()
+        .describe("SECURITY: Allow non-loopback CDP connections. Enables remote code execution on target host. Only use if network path is secured."),
+};
+/**
+ * Build the CDP connection options object from parsed tool arguments.
+ *
+ * Replaces the inline conditional-spread pattern used by tools that
+ * call `resolveAccount` or construct a `LauncherService`.
+ */
+export function buildCdpOptions(args) {
+    return {
+        ...(args.cdpHost !== undefined && { host: args.cdpHost }),
+        ...(args.allowRemote !== undefined && { allowRemote: args.allowRemote }),
+    };
+}
+/**
+ * Build an MCP error response from a plain message string.
+ */
+export function mcpError(text) {
+    return {
+        isError: true,
+        content: [{ type: "text", text }],
+    };
+}
+/**
+ * Build an MCP success response from a plain text or JSON payload.
+ */
+export function mcpSuccess(text) {
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+/**
+ * Map common infrastructure errors (launcher not running, account
+ * resolution failures) and domain errors (campaign not found) to an
+ * MCP error response.
+ *
+ * Returns `undefined` if the error is not a recognised error so the
+ * caller can fall through to domain-specific handling.
+ */
+export function mapErrorToMcpResponse(error) {
+    if (error instanceof LinkedHelperNotRunningError) {
+        return mcpError("LinkedHelper is not running. Use launch-app first.");
+    }
+    if (error instanceof AccountResolutionError) {
+        return mcpError(error.message);
+    }
+    if (error instanceof CampaignNotFoundError) {
+        return mcpError(`Campaign ${String(error.campaignId)} not found.`);
+    }
+    return undefined;
+}
+/**
+ * Map an arbitrary caught error to an MCP error response with a
+ * contextual prefix (e.g. "Failed to create campaign").
+ */
+export function mcpCatchAll(error, prefix) {
+    const mapped = mapErrorToMcpResponse(error);
+    if (mapped)
+        return mapped;
+    const message = errorMessage(error);
+    return mcpError(`${prefix}: ${message}`);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,gBAAgB,CAAC;SACzB,QAAQ,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+BAA+B,CAAC;IAC5C,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kIAAkI,CAAC;CAChJ,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAG/B;IACC,OAAO;QACL,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,YAAY,2BAA2B,EAAE,CAAC;QACjD,OAAO,QAAQ,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;QAC3C,OAAO,QAAQ,CACb,YAAY,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,CAClD,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,MAAc;IACxD,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/index.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
 import { runStdioServer } from "./stdio.js";
 await runStdioServer();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,cAAc,EAAE,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAIxC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAIxC"}

package/dist/server.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
 import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerAllTools } from "./tools/index.js";

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAsC,CAAC;AAE1F;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAsC,CAAC;AAE1F;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server.test.js

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
 import { createRequire } from "node:module";
 import { afterEach, describe, expect, it } from "vitest";
 import { createServer } from "./server.js";
@@ -45,14 +47,39 @@ describe("createServer", () => {
         const { client: c } = await connectPair();
         const { tools } = await c.listTools();
         const names = tools.map((t) => t.name);
+        expect(names).toContain("find-app");
         expect(names).toContain("launch-app");
         expect(names).toContain("quit-app");
         expect(names).toContain("list-accounts");
         expect(names).toContain("start-instance");
         expect(names).toContain("stop-instance");
-        expect(names).toContain("visit-and-extract");
+        expect(names).toContain("query-profile");
+        expect(names).toContain("query-profiles");
+        expect(names).toContain("query-messages");
+        expect(names).toContain("scrape-messaging-history");
+        expect(names).toContain("campaign-create");
+        expect(names).toContain("campaign-delete");
+        expect(names).toContain("campaign-export");
+        expect(names).toContain("campaign-get");
+        expect(names).toContain("campaign-list");
+        expect(names).toContain("campaign-retry");
+        expect(names).toContain("campaign-start");
+        expect(names).toContain("campaign-statistics");
+        expect(names).toContain("campaign-status");
+        expect(names).toContain("campaign-stop");
+        expect(names).toContain("campaign-update");
+        expect(names).toContain("check-replies");
         expect(names).toContain("check-status");
-        expect(names).toHaveLength(7);
+        expect(names).toContain("describe-actions");
+        expect(names).toContain("import-people-from-urls");
+        expect(names).toContain("campaign-move-next");
+        expect(names).toContain("campaign-add-action");
+        expect(names).toContain("campaign-remove-action");
+        expect(names).toContain("campaign-reorder-actions");
+        expect(names).toContain("campaign-exclude-list");
+        expect(names).toContain("campaign-exclude-add");
+        expect(names).toContain("campaign-exclude-remove");
+        expect(names).toHaveLength(32);
     });
 });
 //# sourceMappingURL=server.test.js.map

package/dist/server.test.js.map

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

package/dist/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BpD"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BpD"}

package/dist/stdio.js

@@ -1,4 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { errorMessage } from "@lhremote/core";
 import { createServer } from "./server.js";
 /**
  * Start the MCP server on stdio and register signal handlers for
@@ -12,7 +15,7 @@ export async function runStdioServer() {
         await server.connect(transport);
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
+        const message = errorMessage(error);
         process.stderr.write(`Failed to start MCP server: ${message}\n`);
         process.exit(1);
     }
@@ -21,7 +24,7 @@ export async function runStdioServer() {
         server
             .close()
             .catch((error) => {
-            const message = error instanceof Error ? error.message : String(error);
+            const message = errorMessage(error);
             process.stderr.write(`Error during shutdown: ${message}\n`);
         })
             .finally(() => {

package/dist/stdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,OAAO,IAAI,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAE/D,SAAS,QAAQ;QACf,MAAM;aACH,KAAK,EAAE;aACP,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,OAAO,IAAI,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAE/D,SAAS,QAAQ;QACf,MAAM;aACH,KAAK,EAAE;aACP,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/campaign-add-action.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#campaign-add-action | campaign-add-action} MCP tool. */
+export declare function registerCampaignAddAction(server: McpServer): void;
+//# sourceMappingURL=campaign-add-action.d.ts.map

package/dist/tools/campaign-add-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-add-action.d.ts","sourceRoot":"","sources":["../../src/tools/campaign-add-action.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,yHAAyH;AACzH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsEjE"}

package/dist/tools/campaign-add-action.js

@@ -0,0 +1,63 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { campaignAddAction, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#campaign-add-action | campaign-add-action} MCP tool. */
+export function registerCampaignAddAction(server) {
+    server.tool("campaign-add-action", "Add a new action to an existing campaign's action chain", {
+        campaignId: z
+            .number()
+            .int()
+            .positive()
+            .describe("Campaign ID"),
+        name: z
+            .string()
+            .describe("Display name for the action"),
+        actionType: z
+            .string()
+            .describe("Action type identifier (e.g., 'VisitAndExtract', 'MessageToPerson')"),
+        description: z
+            .string()
+            .optional()
+            .describe("Optional action description"),
+        coolDown: z
+            .number()
+            .int()
+            .optional()
+            .describe("Milliseconds between action executions (default: 60000)"),
+        maxActionResultsPerIteration: z
+            .number()
+            .int()
+            .optional()
+            .describe("Maximum results per iteration (default: 10, -1 for unlimited)"),
+        actionSettings: z
+            .string()
+            .optional()
+            .describe("Action-specific settings as a JSON string"),
+        ...cdpConnectionSchema,
+    }, async ({ campaignId, name, actionType, description, coolDown, maxActionResultsPerIteration, actionSettings, cdpPort, cdpHost, allowRemote, }) => {
+        // Parse action settings JSON if provided
+        let parsedSettings = {};
+        if (actionSettings !== undefined) {
+            try {
+                parsedSettings = JSON.parse(actionSettings);
+            }
+            catch {
+                return mcpError("Invalid JSON in actionSettings.");
+            }
+        }
+        try {
+            const result = await campaignAddAction({
+                campaignId, name, actionType, description, coolDown,
+                maxActionResultsPerIteration, actionSettings: parsedSettings,
+                cdpPort, cdpHost, allowRemote,
+            });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to add action to campaign");
+        }
+    });
+}
+//# sourceMappingURL=campaign-add-action.js.map

package/dist/tools/campaign-add-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-add-action.js","sourceRoot":"","sources":["../../src/tools/campaign-add-action.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvF,yHAAyH;AACzH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,yDAAyD,EACzD;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,aAAa,CAAC;QAC1B,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CAAC,6BAA6B,CAAC;QAC1C,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,CAAC,qEAAqE,CAAC;QAClF,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,6BAA6B,CAAC;QAC1C,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,4BAA4B,EAAE,CAAC;aAC5B,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,+DAA+D,CAAC;QAC5E,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2CAA2C,CAAC;QACxD,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EACL,UAAU,EACV,IAAI,EACJ,UAAU,EACV,WAAW,EACX,QAAQ,EACR,4BAA4B,EAC5B,cAAc,EACd,OAAO,EACP,OAAO,EACP,WAAW,GACZ,EAAE,EAAE;QACH,yCAAyC;QACzC,IAAI,cAAc,GAA4B,EAAE,CAAC;QACjD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAA4B,CAAC;YACzE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,QAAQ,CAAC,iCAAiC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;gBACrC,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ;gBACnD,4BAA4B,EAAE,cAAc,EAAE,cAAc;gBAC5D,OAAO,EAAE,OAAO,EAAE,WAAW;aAC9B,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/campaign-add-action.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=campaign-add-action.test.d.ts.map

package/dist/tools/campaign-add-action.test.d.ts.map

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

package/dist/tools/campaign-add-action.test.js

@@ -0,0 +1,107 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("@lhremote/core", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        campaignAddAction: vi.fn(),
+    };
+});
+import { CampaignNotFoundError, campaignAddAction, } from "@lhremote/core";
+import { registerCampaignAddAction } from "./campaign-add-action.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const MOCK_ACTION = {
+    id: 50,
+    campaignId: 15,
+    name: "Visit & Extract",
+    description: null,
+    config: {
+        id: 500,
+        actionType: "VisitAndExtract",
+        actionSettings: {},
+        coolDown: 60000,
+        maxActionResultsPerIteration: 10,
+        isDraft: false,
+    },
+    versionId: 5000,
+};
+describe("registerCampaignAddAction", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named campaign-add-action", () => {
+        const { server } = createMockServer();
+        registerCampaignAddAction(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("campaign-add-action", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("successfully adds action with required params", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignAddAction(server);
+        vi.mocked(campaignAddAction).mockResolvedValue(MOCK_ACTION);
+        const handler = getHandler("campaign-add-action");
+        const result = await handler({
+            campaignId: 15,
+            name: "Visit & Extract",
+            actionType: "VisitAndExtract",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_ACTION, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns error for invalid actionSettings JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignAddAction(server);
+        const handler = getHandler("campaign-add-action");
+        const result = await handler({
+            campaignId: 15,
+            name: "Visit & Extract",
+            actionType: "VisitAndExtract",
+            actionSettings: "{not-valid-json",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Invalid JSON in actionSettings.",
+                },
+            ],
+        });
+    });
+    it("returns error for non-existent campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignAddAction(server);
+        vi.mocked(campaignAddAction).mockRejectedValue(new CampaignNotFoundError(999));
+        const handler = getHandler("campaign-add-action");
+        const result = await handler({
+            campaignId: 999,
+            name: "Visit",
+            actionType: "VisitAndExtract",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Campaign 999 not found.",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerCampaignAddAction, "campaign-add-action", () => ({ campaignId: 15, name: "Visit", actionType: "VisitAndExtract", cdpPort: 9222 }), (error) => vi.mocked(campaignAddAction).mockRejectedValue(error));
+});
+//# sourceMappingURL=campaign-add-action.test.js.map

package/dist/tools/campaign-add-action.test.js.map

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

package/dist/tools/campaign-create.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#campaign-create | campaign-create} MCP tool. */
+export declare function registerCampaignCreate(server: McpServer): void;
+//# sourceMappingURL=campaign-create.d.ts.map

package/dist/tools/campaign-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-create.d.ts","sourceRoot":"","sources":["../../src/tools/campaign-create.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBzE,iHAAiH;AACjH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwC9D"}

package/dist/tools/campaign-create.js

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { CampaignExecutionError, CampaignFormatError, campaignCreate, errorMessage, parseCampaignJson, parseCampaignYaml, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess, } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#campaign-create | campaign-create} MCP tool. */
+export function registerCampaignCreate(server) {
+    server.tool("campaign-create", "Create a new LinkedHelper campaign from YAML or JSON configuration", {
+        config: z.string().describe("Campaign configuration in YAML or JSON format"),
+        format: z
+            .enum(["yaml", "json"])
+            .optional()
+            .default("yaml")
+            .describe("Configuration format"),
+        ...cdpConnectionSchema,
+    }, async ({ config, format, cdpPort, cdpHost, allowRemote }) => {
+        // Parse campaign config
+        let parsedConfig;
+        try {
+            parsedConfig =
+                format === "json"
+                    ? parseCampaignJson(config)
+                    : parseCampaignYaml(config);
+        }
+        catch (error) {
+            if (error instanceof CampaignFormatError) {
+                return mcpError(`Invalid campaign configuration: ${error.message}`);
+            }
+            const message = errorMessage(error);
+            return mcpError(`Failed to parse campaign configuration: ${message}`);
+        }
+        try {
+            const result = await campaignCreate({ config: parsedConfig, cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            if (error instanceof CampaignExecutionError) {
+                return mcpError(`Failed to create campaign: ${error.message}`);
+            }
+            return mcpCatchAll(error, "Failed to create campaign");
+        }
+    });
+}
+//# sourceMappingURL=campaign-create.js.map

package/dist/tools/campaign-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-create.js","sourceRoot":"","sources":["../../src/tools/campaign-create.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,iHAAiH;AACjH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,oEAAoE,EACpE;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC5E,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aACtB,QAAQ,EAAE;aACV,OAAO,CAAC,MAAM,CAAC;aACf,QAAQ,CAAC,sBAAsB,CAAC;QACnC,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC1D,wBAAwB;QACxB,IAAI,YAAY,CAAC;QACjB,IAAI,CAAC;YACH,YAAY;gBACV,MAAM,KAAK,MAAM;oBACf,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC;oBAC3B,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAC,mCAAmC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,QAAQ,CAAC,2CAA2C,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC7F,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBAC5C,OAAO,QAAQ,CAAC,8BAA8B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/campaign-create.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=campaign-create.test.d.ts.map

package/dist/tools/campaign-create.test.d.ts.map

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