@lhremote/mcp 0.1.0 → 0.2.0

package/dist/tools/describe-actions.d.ts

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

package/dist/tools/describe-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-actions.d.ts","sourceRoot":"","sources":["../../src/tools/describe-actions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,mHAAmH;AACnH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+B/D"}

package/dist/tools/describe-actions.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { getActionTypeCatalog, getActionTypeInfo } from "@lhremote/core";
+import { z } from "zod";
+import { mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#describe-actions | describe-actions} MCP tool. */
+export function registerDescribeActions(server) {
+    server.tool("describe-actions", "List available LinkedHelper action types with descriptions and configuration schemas. Use this to discover what actions can be included in campaigns.", {
+        category: z
+            .enum(["people", "messaging", "engagement", "crm", "workflow", "all"])
+            .optional()
+            .default("all")
+            .describe("Filter by action category"),
+        actionType: z
+            .string()
+            .optional()
+            .describe("Get detailed info for a specific action type"),
+    }, async ({ category, actionType }) => {
+        if (actionType !== undefined) {
+            const info = getActionTypeInfo(actionType);
+            if (info === undefined) {
+                return mcpError(`Unknown action type: ${actionType}`);
+            }
+            return mcpSuccess(JSON.stringify(info, null, 2));
+        }
+        const catalog = getActionTypeCatalog(category === "all" ? undefined : category);
+        return mcpSuccess(JSON.stringify(catalog, null, 2));
+    });
+}
+//# sourceMappingURL=describe-actions.js.map

package/dist/tools/describe-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-actions.js","sourceRoot":"","sources":["../../src/tools/describe-actions.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAErD,mHAAmH;AACnH,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,uJAAuJ,EACvJ;QACE,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;aACrE,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,2BAA2B,CAAC;QACxC,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QACjC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,QAAQ,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,CAClC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAC1C,CAAC;QAEF,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/describe-actions.test.d.ts

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

package/dist/tools/describe-actions.test.d.ts.map

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

package/dist/tools/describe-actions.test.js

@@ -0,0 +1,120 @@
+// 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,
+        getActionTypeCatalog: vi.fn(),
+        getActionTypeInfo: vi.fn(),
+    };
+});
+import { getActionTypeCatalog, getActionTypeInfo, } from "@lhremote/core";
+import { registerDescribeActions } from "./describe-actions.js";
+import { createMockServer } from "./testing/mock-server.js";
+const mockedGetActionTypeCatalog = vi.mocked(getActionTypeCatalog);
+const mockedGetActionTypeInfo = vi.mocked(getActionTypeInfo);
+describe("registerDescribeActions", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named describe-actions", () => {
+        const { server } = createMockServer();
+        registerDescribeActions(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("describe-actions", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns full catalog when no params", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        const catalog = {
+            actionTypes: [
+                {
+                    name: "VisitAndExtract",
+                    description: "Visit a LinkedIn profile and extract data.",
+                    category: "people",
+                    configSchema: {},
+                },
+                {
+                    name: "Follow",
+                    description: "Follow a LinkedIn profile.",
+                    category: "engagement",
+                    configSchema: {},
+                },
+            ],
+        };
+        mockedGetActionTypeCatalog.mockReturnValue(catalog);
+        const handler = getHandler("describe-actions");
+        const result = (await handler({ category: "all" }));
+        expect(mockedGetActionTypeCatalog).toHaveBeenCalledWith(undefined);
+        expect(JSON.parse(result.content[0].text)).toEqual(catalog);
+    });
+    it("filters by category", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        const catalog = {
+            actionTypes: [
+                {
+                    name: "Follow",
+                    description: "Follow a LinkedIn profile.",
+                    category: "engagement",
+                    configSchema: {},
+                },
+            ],
+        };
+        mockedGetActionTypeCatalog.mockReturnValue(catalog);
+        const handler = getHandler("describe-actions");
+        const result = (await handler({ category: "engagement" }));
+        expect(mockedGetActionTypeCatalog).toHaveBeenCalledWith("engagement");
+        expect(JSON.parse(result.content[0].text)).toEqual(catalog);
+    });
+    it("returns specific action type info", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        const info = {
+            name: "VisitAndExtract",
+            description: "Visit a LinkedIn profile and extract data.",
+            category: "people",
+            configSchema: {
+                extractCurrentOrganizations: {
+                    type: "boolean",
+                    required: false,
+                    description: "Whether to extract full profile data.",
+                    default: true,
+                },
+            },
+            example: { extractCurrentOrganizations: true },
+        };
+        mockedGetActionTypeInfo.mockReturnValue(info);
+        const handler = getHandler("describe-actions");
+        const result = (await handler({
+            category: "all",
+            actionType: "VisitAndExtract",
+        }));
+        expect(mockedGetActionTypeInfo).toHaveBeenCalledWith("VisitAndExtract");
+        expect(JSON.parse(result.content[0].text)).toEqual(info);
+    });
+    it("returns error for unknown action type", async () => {
+        const { server, getHandler } = createMockServer();
+        registerDescribeActions(server);
+        mockedGetActionTypeInfo.mockReturnValue(undefined);
+        const handler = getHandler("describe-actions");
+        const result = await handler({
+            category: "all",
+            actionType: "NonExistent",
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Unknown action type: NonExistent",
+                },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=describe-actions.test.js.map

package/dist/tools/describe-actions.test.js.map

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

package/dist/tools/find-app.d.ts

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

package/dist/tools/find-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-app.d.ts","sourceRoot":"","sources":["../../src/tools/find-app.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBvD"}

package/dist/tools/find-app.js

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { findApp } from "@lhremote/core";
+import { mcpCatchAll, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#find-app | find-app} MCP tool. */
+export function registerFindApp(server) {
+    server.tool("find-app", "Detect running LinkedHelper application instances and their CDP connection details", {}, async () => {
+        try {
+            const apps = await findApp();
+            if (apps.length === 0) {
+                return mcpSuccess("No running LinkedHelper instances found");
+            }
+            return mcpSuccess(JSON.stringify(apps, null, 2));
+        }
+        catch (error) {
+            return mcpCatchAll(error, "Failed to find LinkedHelper");
+        }
+    });
+}
+//# sourceMappingURL=find-app.js.map

package/dist/tools/find-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-app.js","sourceRoot":"","sources":["../../src/tools/find-app.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExD,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,IAAI,CACT,UAAU,EACV,oFAAoF,EACpF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;YAE7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,UAAU,CAAC,yCAAyC,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/find-app.test.d.ts

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

package/dist/tools/find-app.test.d.ts.map

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

package/dist/tools/find-app.test.js

@@ -0,0 +1,65 @@
+// 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,
+        findApp: vi.fn(),
+    };
+});
+import { findApp } from "@lhremote/core";
+import { registerFindApp } from "./find-app.js";
+import { createMockServer } from "./testing/mock-server.js";
+const mockedFindApp = vi.mocked(findApp);
+describe("registerFindApp", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named find-app", () => {
+        const { server } = createMockServer();
+        registerFindApp(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("find-app", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("returns apps as JSON when found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerFindApp(server);
+        const apps = [
+            { pid: 1234, cdpPort: 9222, connectable: true },
+        ];
+        mockedFindApp.mockResolvedValue(apps);
+        const handler = getHandler("find-app");
+        const result = (await handler({}));
+        expect(JSON.parse(result.content[0].text)).toEqual(apps);
+    });
+    it("returns friendly message when no apps found", async () => {
+        const { server, getHandler } = createMockServer();
+        registerFindApp(server);
+        mockedFindApp.mockResolvedValue([]);
+        const handler = getHandler("find-app");
+        const result = await handler({});
+        expect(result).toEqual({
+            content: [
+                { type: "text", text: "No running LinkedHelper instances found" },
+            ],
+        });
+    });
+    it("returns error on unexpected failure", async () => {
+        const { server, getHandler } = createMockServer();
+        registerFindApp(server);
+        mockedFindApp.mockRejectedValue(new Error("scan failed"));
+        const handler = getHandler("find-app");
+        const result = await handler({});
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                { type: "text", text: "Failed to find LinkedHelper: scan failed" },
+            ],
+        });
+    });
+});
+//# sourceMappingURL=find-app.test.js.map

package/dist/tools/find-app.test.js.map

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

package/dist/tools/import-people-from-urls.d.ts

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

package/dist/tools/import-people-from-urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-people-from-urls.d.ts","sourceRoot":"","sources":["../../src/tools/import-people-from-urls.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,iIAAiI;AACjI,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4BpE"}

package/dist/tools/import-people-from-urls.js

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { CampaignExecutionError, importPeopleFromUrls, } from "@lhremote/core";
+import { z } from "zod";
+import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
+/** Register the {@link https://github.com/alexey-pelykh/lhremote#import-people-from-urls | import-people-from-urls} MCP tool. */
+export function registerImportPeopleFromUrls(server) {
+    server.tool("import-people-from-urls", "Import LinkedIn profile URLs into a campaign action's target list. Idempotent — re-importing an already-targeted person is a no-op.", {
+        campaignId: z
+            .number()
+            .int()
+            .positive()
+            .describe("Campaign ID to import people into"),
+        linkedInUrls: z
+            .array(z.string().url())
+            .nonempty()
+            .describe("LinkedIn profile URLs to import"),
+        ...cdpConnectionSchema,
+    }, async ({ campaignId, linkedInUrls, cdpPort, cdpHost, allowRemote }) => {
+        try {
+            const result = await importPeopleFromUrls({ campaignId, linkedInUrls, cdpPort, cdpHost, allowRemote });
+            return mcpSuccess(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            if (error instanceof CampaignExecutionError) {
+                return mcpError(`Failed to import people: ${error.message}`);
+            }
+            return mcpCatchAll(error, "Failed to import people");
+        }
+    });
+}
+//# sourceMappingURL=import-people-from-urls.js.map

package/dist/tools/import-people-from-urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-people-from-urls.js","sourceRoot":"","sources":["../../src/tools/import-people-from-urls.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,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,iIAAiI;AACjI,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,qIAAqI,EACrI;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,mCAAmC,CAAC;QAChD,YAAY,EAAE,CAAC;aACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;aACvB,QAAQ,EAAE;aACV,QAAQ,CAAC,iCAAiC,CAAC;QAC9C,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACvG,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,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/import-people-from-urls.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=import-people-from-urls.test.d.ts.map

package/dist/tools/import-people-from-urls.test.d.ts.map

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

package/dist/tools/import-people-from-urls.test.js

@@ -0,0 +1,136 @@
+// 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,
+        importPeopleFromUrls: vi.fn(),
+    };
+});
+import { CampaignExecutionError, CampaignNotFoundError, importPeopleFromUrls, } from "@lhremote/core";
+import { registerImportPeopleFromUrls } from "./import-people-from-urls.js";
+import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
+import { createMockServer } from "./testing/mock-server.js";
+describe("registerImportPeopleFromUrls", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("registers a tool named import-people-from-urls", () => {
+        const { server } = createMockServer();
+        registerImportPeopleFromUrls(server);
+        expect(server.tool).toHaveBeenCalledOnce();
+        expect(server.tool).toHaveBeenCalledWith("import-people-from-urls", expect.any(String), expect.any(Object), expect.any(Function));
+    });
+    it("successfully imports people from URLs", async () => {
+        const { server, getHandler } = createMockServer();
+        registerImportPeopleFromUrls(server);
+        vi.mocked(importPeopleFromUrls).mockResolvedValue({
+            success: true,
+            campaignId: 14,
+            actionId: 85,
+            imported: 2,
+            alreadyInQueue: 0,
+            alreadyProcessed: 0,
+            failed: 0,
+        });
+        const handler = getHandler("import-people-from-urls");
+        const result = await handler({
+            campaignId: 14,
+            linkedInUrls: [
+                "https://www.linkedin.com/in/alice",
+                "https://www.linkedin.com/in/bob",
+            ],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        campaignId: 14,
+                        actionId: 85,
+                        imported: 2,
+                        alreadyInQueue: 0,
+                        alreadyProcessed: 0,
+                        failed: 0,
+                    }, null, 2),
+                },
+            ],
+        });
+    });
+    it("passes correct arguments to operation", async () => {
+        const { server, getHandler } = createMockServer();
+        registerImportPeopleFromUrls(server);
+        vi.mocked(importPeopleFromUrls).mockResolvedValue({
+            success: true,
+            campaignId: 14,
+            actionId: 85,
+            imported: 1,
+            alreadyInQueue: 0,
+            alreadyProcessed: 0,
+            failed: 0,
+        });
+        const handler = getHandler("import-people-from-urls");
+        await handler({
+            campaignId: 14,
+            linkedInUrls: ["https://www.linkedin.com/in/alice"],
+            cdpPort: 9222,
+        });
+        expect(importPeopleFromUrls).toHaveBeenCalledWith(expect.objectContaining({
+            campaignId: 14,
+            linkedInUrls: ["https://www.linkedin.com/in/alice"],
+            cdpPort: 9222,
+        }));
+    });
+    it("returns error for non-existent campaign", async () => {
+        const { server, getHandler } = createMockServer();
+        registerImportPeopleFromUrls(server);
+        vi.mocked(importPeopleFromUrls).mockRejectedValue(new CampaignNotFoundError(999));
+        const handler = getHandler("import-people-from-urls");
+        const result = await handler({
+            campaignId: 999,
+            linkedInUrls: ["https://www.linkedin.com/in/alice"],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Campaign 999 not found.",
+                },
+            ],
+        });
+    });
+    it("returns error when campaign has no actions", async () => {
+        const { server, getHandler } = createMockServer();
+        registerImportPeopleFromUrls(server);
+        vi.mocked(importPeopleFromUrls).mockRejectedValue(new CampaignExecutionError("Campaign 14 has no actions", 14));
+        const handler = getHandler("import-people-from-urls");
+        const result = await handler({
+            campaignId: 14,
+            linkedInUrls: ["https://www.linkedin.com/in/alice"],
+            cdpPort: 9222,
+        });
+        expect(result).toEqual({
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: "Failed to import people: Campaign 14 has no actions",
+                },
+            ],
+        });
+    });
+    describeInfrastructureErrors(registerImportPeopleFromUrls, "import-people-from-urls", () => ({
+        campaignId: 14,
+        linkedInUrls: ["https://www.linkedin.com/in/alice"],
+        cdpPort: 9222,
+    }), (error) => vi.mocked(importPeopleFromUrls).mockRejectedValue(error), "Failed to import people");
+});
+//# sourceMappingURL=import-people-from-urls.test.js.map

package/dist/tools/import-people-from-urls.test.js.map

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

package/dist/tools/index.d.ts

@@ -1,3 +1,36 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerCampaignAddAction } from "./campaign-add-action.js";
+import { registerCampaignCreate } from "./campaign-create.js";
+import { registerCampaignDelete } from "./campaign-delete.js";
+import { registerCampaignExcludeAdd } from "./campaign-exclude-add.js";
+import { registerCampaignExcludeList } from "./campaign-exclude-list.js";
+import { registerCampaignExcludeRemove } from "./campaign-exclude-remove.js";
+import { registerCampaignExport } from "./campaign-export.js";
+import { registerCampaignGet } from "./campaign-get.js";
+import { registerCampaignList } from "./campaign-list.js";
+import { registerCampaignMoveNext } from "./campaign-move-next.js";
+import { registerCampaignRemoveAction } from "./campaign-remove-action.js";
+import { registerCampaignReorderActions } from "./campaign-reorder-actions.js";
+import { registerCampaignRetry } from "./campaign-retry.js";
+import { registerImportPeopleFromUrls } from "./import-people-from-urls.js";
+import { registerCampaignStart } from "./campaign-start.js";
+import { registerCampaignStatistics } from "./campaign-statistics.js";
+import { registerCampaignStatus } from "./campaign-status.js";
+import { registerCampaignStop } from "./campaign-stop.js";
+import { registerCampaignUpdate } from "./campaign-update.js";
+import { registerCheckReplies } from "./check-replies.js";
+import { registerCheckStatus } from "./check-status.js";
+import { registerDescribeActions } from "./describe-actions.js";
+import { registerFindApp } from "./find-app.js";
+import { registerLaunchApp } from "./launch-app.js";
+import { registerListAccounts } from "./list-accounts.js";
+import { registerQuitApp } from "./quit-app.js";
+import { registerStartInstance } from "./start-instance.js";
+import { registerStopInstance } from "./stop-instance.js";
+import { registerQueryMessages } from "./query-messages.js";
+import { registerQueryProfile } from "./query-profile.js";
+import { registerQueryProfiles } from "./query-profiles.js";
+import { registerScrapeMessagingHistory } from "./scrape-messaging-history.js";
+export { registerCampaignAddAction, registerCampaignCreate, registerCampaignDelete, registerCampaignExcludeAdd, registerCampaignExcludeList, registerCampaignExcludeRemove, registerCampaignExport, registerCampaignGet, registerCampaignList, registerCampaignMoveNext, registerCampaignRemoveAction, registerCampaignReorderActions, registerCampaignRetry, registerCampaignStart, registerCampaignStatistics, registerCampaignStatus, registerCampaignStop, registerCampaignUpdate, registerCheckReplies, registerCheckStatus, registerDescribeActions, registerFindApp, registerImportPeopleFromUrls, registerLaunchApp, registerListAccounts, registerQueryMessages, registerQueryProfile, registerQueryProfiles, registerQuitApp, registerScrapeMessagingHistory, registerStartInstance, registerStopInstance, };
 export declare function registerAllTools(server: McpServer): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAQxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,8BAA8B,EAC9B,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,4BAA4B,EAC5B,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,GACrB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiCxD"}

package/dist/tools/index.js

@@ -1,17 +1,70 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { registerCampaignAddAction } from "./campaign-add-action.js";
+import { registerCampaignCreate } from "./campaign-create.js";
+import { registerCampaignDelete } from "./campaign-delete.js";
+import { registerCampaignExcludeAdd } from "./campaign-exclude-add.js";
+import { registerCampaignExcludeList } from "./campaign-exclude-list.js";
+import { registerCampaignExcludeRemove } from "./campaign-exclude-remove.js";
+import { registerCampaignExport } from "./campaign-export.js";
+import { registerCampaignGet } from "./campaign-get.js";
+import { registerCampaignList } from "./campaign-list.js";
+import { registerCampaignMoveNext } from "./campaign-move-next.js";
+import { registerCampaignRemoveAction } from "./campaign-remove-action.js";
+import { registerCampaignReorderActions } from "./campaign-reorder-actions.js";
+import { registerCampaignRetry } from "./campaign-retry.js";
+import { registerImportPeopleFromUrls } from "./import-people-from-urls.js";
+import { registerCampaignStart } from "./campaign-start.js";
+import { registerCampaignStatistics } from "./campaign-statistics.js";
+import { registerCampaignStatus } from "./campaign-status.js";
+import { registerCampaignStop } from "./campaign-stop.js";
+import { registerCampaignUpdate } from "./campaign-update.js";
+import { registerCheckReplies } from "./check-replies.js";
 import { registerCheckStatus } from "./check-status.js";
+import { registerDescribeActions } from "./describe-actions.js";
+import { registerFindApp } from "./find-app.js";
 import { registerLaunchApp } from "./launch-app.js";
 import { registerListAccounts } from "./list-accounts.js";
 import { registerQuitApp } from "./quit-app.js";
 import { registerStartInstance } from "./start-instance.js";
 import { registerStopInstance } from "./stop-instance.js";
-import { registerVisitAndExtract } from "./visit-and-extract.js";
+import { registerQueryMessages } from "./query-messages.js";
+import { registerQueryProfile } from "./query-profile.js";
+import { registerQueryProfiles } from "./query-profiles.js";
+import { registerScrapeMessagingHistory } from "./scrape-messaging-history.js";
+export { registerCampaignAddAction, registerCampaignCreate, registerCampaignDelete, registerCampaignExcludeAdd, registerCampaignExcludeList, registerCampaignExcludeRemove, registerCampaignExport, registerCampaignGet, registerCampaignList, registerCampaignMoveNext, registerCampaignRemoveAction, registerCampaignReorderActions, registerCampaignRetry, registerCampaignStart, registerCampaignStatistics, registerCampaignStatus, registerCampaignStop, registerCampaignUpdate, registerCheckReplies, registerCheckStatus, registerDescribeActions, registerFindApp, registerImportPeopleFromUrls, registerLaunchApp, registerListAccounts, registerQueryMessages, registerQueryProfile, registerQueryProfiles, registerQuitApp, registerScrapeMessagingHistory, registerStartInstance, registerStopInstance, };
 export function registerAllTools(server) {
+    registerCampaignAddAction(server);
+    registerCampaignCreate(server);
+    registerCampaignDelete(server);
+    registerCampaignExcludeAdd(server);
+    registerCampaignExcludeList(server);
+    registerCampaignExcludeRemove(server);
+    registerCampaignExport(server);
+    registerCampaignGet(server);
+    registerCampaignList(server);
+    registerCampaignMoveNext(server);
+    registerCampaignRemoveAction(server);
+    registerCampaignReorderActions(server);
+    registerCampaignRetry(server);
+    registerCampaignStart(server);
+    registerCampaignStatistics(server);
+    registerCampaignStatus(server);
+    registerCampaignStop(server);
+    registerCampaignUpdate(server);
+    registerFindApp(server);
     registerLaunchApp(server);
     registerQuitApp(server);
     registerListAccounts(server);
     registerStartInstance(server);
     registerStopInstance(server);
-    registerVisitAndExtract(server);
+    registerQueryMessages(server);
+    registerQueryProfile(server);
+    registerQueryProfiles(server);
+    registerScrapeMessagingHistory(server);
+    registerCheckReplies(server);
     registerCheckStatus(server);
+    registerDescribeActions(server);
+    registerImportPeopleFromUrls(server);
 }
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}