@lhremote/mcp 0.1.0 → 0.2.0

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

@@ -0,0 +1,163 @@
+// 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,
+        campaignCreate: vi.fn(),
+        parseCampaignYaml: vi.fn(),
+        parseCampaignJson: vi.fn(),
+    };
+});
+import { CampaignExecutionError, CampaignFormatError, campaignCreate, parseCampaignJson, parseCampaignYaml, } from "@lhremote/core";
+import { registerCampaignCreate } from "./campaign-create.js";
+import { createMockServer } from "./testing/mock-server.js";
+const YAML_CONFIG = `
+version: "1"
+name: Test Campaign
+actions:
+  - type: VisitAndExtract
+`;
+const JSON_CONFIG = JSON.stringify({
+    version: "1",
+    name: "Test Campaign",
+    actions: [{ type: "VisitAndExtract" }],
+});
+const PARSED_CONFIG = {
+    name: "Test Campaign",
+    actions: [{ name: "VisitAndExtract", actionType: "VisitAndExtract" }],
+};
+const MOCK_CAMPAIGN = {
+    id: 42,
+    name: "Test Campaign",
+    description: null,
+    state: "active",
+    liAccountId: 1,
+    isPaused: true,
+    isArchived: false,
+    isValid: true,
+    createdAt: "2025-01-01T00:00:00.000Z",
+};
+describe("registerCampaignCreate", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named campaign-create", () => {
+        const { server } = createMockServer();
+        registerCampaignCreate(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("campaign-create", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("successfully creates campaign from YAML config", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignCreate(server);
+        vi.mocked(parseCampaignYaml).mockReturnValue(PARSED_CONFIG);
+        vi.mocked(campaignCreate).mockResolvedValue(MOCK_CAMPAIGN);
+        const handler = getHandler("campaign-create");
+        const result = await handler({
+            config: YAML_CONFIG,
+            format: "yaml",
+            cdpPort: 9222,
+        });
+        expect(parseCampaignYaml).toHaveBeenCalledWith(YAML_CONFIG);
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_CAMPAIGN, null, 2),
+                },
+            ],
+        });
+    });
+    it("successfully creates campaign from JSON config", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignCreate(server);
+        vi.mocked(parseCampaignJson).mockReturnValue(PARSED_CONFIG);
+        vi.mocked(campaignCreate).mockResolvedValue(MOCK_CAMPAIGN);
+        const handler = getHandler("campaign-create");
+        const result = await handler({
+            config: JSON_CONFIG,
+            format: "json",
+            cdpPort: 9222,
+        });
+        expect(parseCampaignJson).toHaveBeenCalledWith(JSON_CONFIG);
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(MOCK_CAMPAIGN, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns error for invalid YAML", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignCreate(server);
+        vi.mocked(parseCampaignYaml).mockImplementation(() => {
+            throw new CampaignFormatError("Invalid YAML: unexpected token");
+        });
+        const handler = getHandler("campaign-create");
+        const result = await handler({
+            config: "%%%invalid",
+            format: "yaml",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Invalid campaign configuration: Invalid YAML: unexpected token",
+                },
+            ],
+        });
+    });
+    it("returns error for invalid JSON", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignCreate(server);
+        vi.mocked(parseCampaignJson).mockImplementation(() => {
+            throw new CampaignFormatError("Invalid JSON: unexpected token");
+        });
+        const handler = getHandler("campaign-create");
+        const result = await handler({
+            config: "{not-json",
+            format: "json",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Invalid campaign configuration: Invalid JSON: unexpected token",
+                },
+            ],
+        });
+    });
+    it("returns error when campaign creation fails", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignCreate(server);
+        vi.mocked(parseCampaignYaml).mockReturnValue(PARSED_CONFIG);
+        vi.mocked(campaignCreate).mockRejectedValue(new CampaignExecutionError("Failed to create campaign: UI error"));
+        const handler = getHandler("campaign-create");
+        const result = await handler({
+            config: YAML_CONFIG,
+            format: "yaml",
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to create campaign: Failed to create campaign: UI error",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=campaign-create.test.js.map

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

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

package/dist/tools/campaign-delete.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-delete | campaign-delete} MCP tool. */
+export declare function registerCampaignDelete(server: McpServer): void;
+//# sourceMappingURL=campaign-delete.d.ts.map

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

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

package/dist/tools/campaign-delete.js

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { CampaignExecutionError, campaignDelete, } 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-delete | campaign-delete} MCP tool. */
+export function registerCampaignDelete(server) {
+    server.tool("campaign-delete", "Delete (archive) a campaign. The campaign is hidden but retained in database.", {
+        campaignId: z
+            .number()
+            .int()
+            .positive()
+            .describe("Campaign ID"),
+        ...cdpConnectionSchema,
+    }, async ({ campaignId, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await campaignDelete({ campaignId, cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            if (error instanceof CampaignExecutionError) {
+                return mcpError(`Failed to delete campaign: ${error.message}`);
+            }
+            return mcpCatchAll(error, "Failed to delete campaign");
+        }
+    });
+}
+//# sourceMappingURL=campaign-delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-delete.js","sourceRoot":"","sources":["../../src/tools/campaign-delete.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,EACtB,cAAc,GACf,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,iHAAiH;AACjH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,+EAA+E,EAC/E;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,aAAa,CAAC;QAC1B,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACnF,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-delete.test.d.ts

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

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

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

package/dist/tools/campaign-delete.test.js

@@ -0,0 +1,87 @@
+// 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,
+        campaignDelete: vi.fn(),
+    };
+});
+import { CampaignExecutionError, CampaignNotFoundError, campaignDelete, } from "@lhremote/core";
+import { registerCampaignDelete } from "./campaign-delete.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+const DELETE_RESULT = { success: true, campaignId: 15, action: "archived" };
+describe("registerCampaignDelete", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named campaign-delete", () => {
+        const { server } = createMockServer();
+        registerCampaignDelete(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("campaign-delete", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("successfully deletes a campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignDelete(server);
+        vi.mocked(campaignDelete).mockResolvedValue(DELETE_RESULT);
+        const handler = getHandler("campaign-delete");
+        const result = await handler({
+            campaignId: 15,
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(DELETE_RESULT, null, 2),
+                },
+            ],
+        });
+    });
+    it("returns error for non-existent campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignDelete(server);
+        vi.mocked(campaignDelete).mockRejectedValue(new CampaignNotFoundError(999));
+        const handler = getHandler("campaign-delete");
+        const result = await handler({
+            campaignId: 999,
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Campaign 999 not found.",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerCampaignDelete, "campaign-delete", () => ({ campaignId: 15, cdpPort: 9222 }), (error) => vi.mocked(campaignDelete).mockRejectedValue(error), "Failed to delete campaign");
+    it("returns error when campaign execution fails", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignDelete(server);
+        vi.mocked(campaignDelete).mockRejectedValue(new CampaignExecutionError("Failed to delete campaign 15: UI error", 15));
+        const handler = getHandler("campaign-delete");
+        const result = await handler({
+            campaignId: 15,
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to delete campaign: Failed to delete campaign 15: UI error",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=campaign-delete.test.js.map

package/dist/tools/campaign-delete.test.js.map

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

package/dist/tools/campaign-exclude-add.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-exclude-add | campaign-exclude-add} MCP tool. */
+export declare function registerCampaignExcludeAdd(server: McpServer): void;
+//# sourceMappingURL=campaign-exclude-add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-exclude-add.d.ts","sourceRoot":"","sources":["../../src/tools/campaign-exclude-add.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,2HAA2H;AAC3H,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0ClE"}

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

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ActionNotFoundError, ExcludeListNotFoundError, campaignExcludeAdd, } 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-exclude-add | campaign-exclude-add} MCP tool. */
+export function registerCampaignExcludeAdd(server) {
+    server.tool("campaign-exclude-add", "Add people to a campaign or action exclude list", {
+        campaignId: z
+            .number()
+            .int()
+            .positive()
+            .describe("Campaign ID"),
+        personIds: z
+            .array(z.number().int().positive())
+            .nonempty()
+            .describe("Person IDs to add to the exclude list"),
+        actionId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Action ID (optional). If provided, adds to the action-level exclude list. Otherwise, adds to the campaign-level exclude list."),
+        ...cdpConnectionSchema,
+    }, async ({ campaignId, personIds, actionId, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await campaignExcludeAdd({ campaignId, personIds, actionId, cdpPort, cdpHost, allowRemote });
+            const targetLabel = actionId !== undefined
+                ? `action ${String(actionId)} in campaign ${String(campaignId)}`
+                : `campaign ${String(campaignId)}`;
+            return mcpSuccess(JSON.stringify({ ...result, message: `Added ${String(result.added)} person(s) to exclude list for ${targetLabel}.` }, null, 2));
+        }
+        catch (error) {
+            if (error instanceof ActionNotFoundError) {
+                return mcpError(`Action ${String(actionId)} not found in campaign ${String(campaignId)}.`);
+            }
+            if (error instanceof ExcludeListNotFoundError) {
+                return mcpError(error.message);
+            }
+            return mcpCatchAll(error, "Failed to add to exclude list");
+        }
+    });
+}
+//# sourceMappingURL=campaign-exclude-add.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-exclude-add.js","sourceRoot":"","sources":["../../src/tools/campaign-exclude-add.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,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,2HAA2H;AAC3H,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,iDAAiD,EACjD;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,aAAa,CAAC;QAC1B,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;aAClC,QAAQ,EAAE;aACV,QAAQ,CAAC,uCAAuC,CAAC;QACpD,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,+HAA+H,CAChI;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC5G,MAAM,WAAW,GAAG,QAAQ,KAAK,SAAS;gBACxC,CAAC,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,gBAAgB,MAAM,CAAC,UAAU,CAAC,EAAE;gBAChE,CAAC,CAAC,YAAY,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,WAAW,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,0BAA0B,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;gBAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,+BAA+B,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,161 @@
+// 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,
+        campaignExcludeAdd: vi.fn(),
+    };
+});
+import { ActionNotFoundError, CampaignNotFoundError, ExcludeListNotFoundError, campaignExcludeAdd, } from "@lhremote/core";
+import { registerCampaignExcludeAdd } from "./campaign-exclude-add.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+describe("registerCampaignExcludeAdd", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named campaign-exclude-add", () => {
+        const { server } = createMockServer();
+        registerCampaignExcludeAdd(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("campaign-exclude-add", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("successfully adds people to campaign-level exclude list", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignExcludeAdd(server);
+        vi.mocked(campaignExcludeAdd).mockResolvedValue({
+            success: true,
+            campaignId: 10,
+            level: "campaign",
+            added: 2,
+            alreadyExcluded: 0,
+        });
+        const handler = getHandler("campaign-exclude-add");
+        const result = await handler({
+            campaignId: 10,
+            personIds: [100, 200],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        campaignId: 10,
+                        level: "campaign",
+                        added: 2,
+                        alreadyExcluded: 0,
+                        message: "Added 2 person(s) to exclude list for campaign 10.",
+                    }, null, 2),
+                },
+            ],
+        });
+    });
+    it("passes correct arguments to operation for campaign-level", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignExcludeAdd(server);
+        vi.mocked(campaignExcludeAdd).mockResolvedValue({
+            success: true,
+            campaignId: 10,
+            level: "campaign",
+            added: 2,
+            alreadyExcluded: 0,
+        });
+        const handler = getHandler("campaign-exclude-add");
+        await handler({
+            campaignId: 10,
+            personIds: [100, 200],
+            cdpPort: 9222,
+        });
+        expect(campaignExcludeAdd).toHaveBeenCalledWith(expect.objectContaining({ campaignId: 10, personIds: [100, 200], cdpPort: 9222 }));
+    });
+    it("passes correct arguments to operation for action-level", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignExcludeAdd(server);
+        vi.mocked(campaignExcludeAdd).mockResolvedValue({
+            success: true,
+            campaignId: 10,
+            actionId: 5,
+            level: "action",
+            added: 2,
+            alreadyExcluded: 0,
+        });
+        const handler = getHandler("campaign-exclude-add");
+        await handler({
+            campaignId: 10,
+            personIds: [100, 200],
+            actionId: 5,
+            cdpPort: 9222,
+        });
+        expect(campaignExcludeAdd).toHaveBeenCalledWith(expect.objectContaining({ campaignId: 10, personIds: [100, 200], actionId: 5, cdpPort: 9222 }));
+    });
+    it("returns error for non-existent campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignExcludeAdd(server);
+        vi.mocked(campaignExcludeAdd).mockRejectedValue(new CampaignNotFoundError(999));
+        const handler = getHandler("campaign-exclude-add");
+        const result = await handler({
+            campaignId: 999,
+            personIds: [100, 200],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Campaign 999 not found.",
+                },
+            ],
+        });
+    });
+    it("returns error for non-existent action", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignExcludeAdd(server);
+        vi.mocked(campaignExcludeAdd).mockRejectedValue(new ActionNotFoundError(5, 10));
+        const handler = getHandler("campaign-exclude-add");
+        const result = await handler({
+            campaignId: 10,
+            personIds: [100, 200],
+            actionId: 5,
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Action 5 not found in campaign 10.",
+                },
+            ],
+        });
+    });
+    it("returns error for non-existent exclude list", async () => {
+        const { server, getHandler } = createMockServer();
+        registerCampaignExcludeAdd(server);
+        vi.mocked(campaignExcludeAdd).mockRejectedValue(new ExcludeListNotFoundError("campaign", 10));
+        const handler = getHandler("campaign-exclude-add");
+        const result = await handler({
+            campaignId: 10,
+            personIds: [100, 200],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Exclude list not found for campaign 10",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerCampaignExcludeAdd, "campaign-exclude-add", () => ({ campaignId: 10, personIds: [100, 200], cdpPort: 9222 }), (error) => vi.mocked(campaignExcludeAdd).mockRejectedValue(error), "Failed to add to exclude list");
+});
+//# sourceMappingURL=campaign-exclude-add.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-exclude-add.test.js","sourceRoot":"","sources":["../../src/tools/campaign-exclude-add.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IACjD,MAAM,MAAM,GAAG,MAAM,cAAc,EAAmC,CAAC;IACvE,OAAO;QACL,GAAG,MAAM;QACT,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE;KAC5B,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QACtC,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAEnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,sBAAsB,EACtB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAClB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CACrB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAEnC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAAC;YAC9C,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,CAAC;YACR,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACrB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,IAAI;wBACb,UAAU,EAAE,EAAE;wBACd,KAAK,EAAE,UAAU;wBACjB,KAAK,EAAE,CAAC;wBACR,eAAe,EAAE,CAAC;wBAClB,OAAO,EACL,oDAAoD;qBACvD,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAEnC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAAC;YAC9C,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,CAAC;YACR,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;QACnD,MAAM,OAAO,CAAC;YACZ,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACrB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAC7C,MAAM,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAClF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAEnC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAAC;YAC9C,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,CAAC;YACR,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;QACnD,MAAM,OAAO,CAAC;YACZ,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACrB,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,kBAAkB,CAAC,CAAC,oBAAoB,CAC7C,MAAM,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAC/F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAEnC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAC7C,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAC/B,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACrB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yBAAyB;iBAChC;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAEnC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAC7C,IAAI,mBAAmB,CAAC,CAAC,EAAE,EAAE,CAAC,CAC/B,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACrB,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oCAAoC;iBAC3C;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAEnC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAC7C,IAAI,wBAAwB,CAAC,UAAU,EAAE,EAAE,CAAC,CAC7C,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACrB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wCAAwC;iBAC/C;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,4BAA4B,CAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAChE,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,EACjE,+BAA+B,CAChC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/tools/campaign-exclude-list.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-exclude-list | campaign-exclude-list} MCP tool. */
+export declare function registerCampaignExcludeList(server: McpServer): void;
+//# sourceMappingURL=campaign-exclude-list.d.ts.map

package/dist/tools/campaign-exclude-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-exclude-list.d.ts","sourceRoot":"","sources":["../../src/tools/campaign-exclude-list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,6HAA6H;AAC7H,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsCnE"}

package/dist/tools/campaign-exclude-list.js

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ActionNotFoundError, ExcludeListNotFoundError, campaignExcludeList, } 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-exclude-list | campaign-exclude-list} MCP tool. */
+export function registerCampaignExcludeList(server) {
+    server.tool("campaign-exclude-list", "View the exclude list for a campaign or a specific action within a campaign", {
+        campaignId: z
+            .number()
+            .int()
+            .positive()
+            .describe("Campaign ID"),
+        actionId: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Action ID (optional). If provided, shows the action-level exclude list. Otherwise, shows the campaign-level exclude list."),
+        ...cdpConnectionSchema,
+    }, async ({ campaignId, actionId, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await campaignExcludeList({ campaignId, actionId, cdpPort, cdpHost, allowRemote });
+            const targetLabel = actionId !== undefined
+                ? `action ${String(actionId)} in campaign ${String(campaignId)}`
+                : `campaign ${String(campaignId)}`;
+            return mcpSuccess(JSON.stringify({ ...result, message: `Exclude list for ${targetLabel}: ${String(result.count)} person(s).` }, null, 2));
+        }
+        catch (error) {
+            if (error instanceof ActionNotFoundError) {
+                return mcpError(`Action ${String(actionId)} not found in campaign ${String(campaignId)}.`);
+            }
+            if (error instanceof ExcludeListNotFoundError) {
+                return mcpError(error.message);
+            }
+            return mcpCatchAll(error, "Failed to get exclude list");
+        }
+    });
+}
+//# sourceMappingURL=campaign-exclude-list.js.map

package/dist/tools/campaign-exclude-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-exclude-list.js","sourceRoot":"","sources":["../../src/tools/campaign-exclude-list.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,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,6HAA6H;AAC7H,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,6EAA6E,EAC7E;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,aAAa,CAAC;QAC1B,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,2HAA2H,CAC5H;QACH,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAChE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAClG,MAAM,WAAW,GAAG,QAAQ,KAAK,SAAS;gBACxC,CAAC,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,gBAAgB,MAAM,CAAC,UAAU,CAAC,EAAE;gBAChE,CAAC,CAAC,YAAY,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,oBAAoB,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5I,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,0BAA0B,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;gBAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/campaign-exclude-list.test.d.ts

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

package/dist/tools/campaign-exclude-list.test.d.ts.map

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