@lhremote/mcp 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/README.md +6 -5
  2. package/dist/server.test.js +11 -1
  3. package/dist/server.test.js.map +1 -1
  4. package/dist/tools/add-people-to-collection.d.ts +4 -0
  5. package/dist/tools/add-people-to-collection.d.ts.map +1 -0
  6. package/dist/tools/add-people-to-collection.js +29 -0
  7. package/dist/tools/add-people-to-collection.js.map +1 -0
  8. package/dist/tools/build-linkedin-url.d.ts +4 -0
  9. package/dist/tools/build-linkedin-url.d.ts.map +1 -0
  10. package/dist/tools/build-linkedin-url.js +117 -0
  11. package/dist/tools/build-linkedin-url.js.map +1 -0
  12. package/dist/tools/build-linkedin-url.test.d.ts +2 -0
  13. package/dist/tools/build-linkedin-url.test.d.ts.map +1 -0
  14. package/dist/tools/build-linkedin-url.test.js +101 -0
  15. package/dist/tools/build-linkedin-url.test.js.map +1 -0
  16. package/dist/tools/collect-people.d.ts +4 -0
  17. package/dist/tools/collect-people.d.ts.map +1 -0
  18. package/dist/tools/collect-people.js +67 -0
  19. package/dist/tools/collect-people.js.map +1 -0
  20. package/dist/tools/collect-people.test.d.ts +2 -0
  21. package/dist/tools/collect-people.test.d.ts.map +1 -0
  22. package/dist/tools/collect-people.test.js +129 -0
  23. package/dist/tools/collect-people.test.js.map +1 -0
  24. package/dist/tools/create-collection.d.ts +4 -0
  25. package/dist/tools/create-collection.d.ts.map +1 -0
  26. package/dist/tools/create-collection.js +24 -0
  27. package/dist/tools/create-collection.js.map +1 -0
  28. package/dist/tools/delete-collection.d.ts +4 -0
  29. package/dist/tools/delete-collection.d.ts.map +1 -0
  30. package/dist/tools/delete-collection.js +25 -0
  31. package/dist/tools/delete-collection.js.map +1 -0
  32. package/dist/tools/import-people-from-collection.d.ts +4 -0
  33. package/dist/tools/import-people-from-collection.d.ts.map +1 -0
  34. package/dist/tools/import-people-from-collection.js +33 -0
  35. package/dist/tools/import-people-from-collection.js.map +1 -0
  36. package/dist/tools/index.d.ts +11 -1
  37. package/dist/tools/index.d.ts.map +1 -1
  38. package/dist/tools/index.js +21 -1
  39. package/dist/tools/index.js.map +1 -1
  40. package/dist/tools/list-collections.d.ts +4 -0
  41. package/dist/tools/list-collections.d.ts.map +1 -0
  42. package/dist/tools/list-collections.js +19 -0
  43. package/dist/tools/list-collections.js.map +1 -0
  44. package/dist/tools/list-linkedin-reference-data.d.ts +4 -0
  45. package/dist/tools/list-linkedin-reference-data.d.ts.map +1 -0
  46. package/dist/tools/list-linkedin-reference-data.js +24 -0
  47. package/dist/tools/list-linkedin-reference-data.js.map +1 -0
  48. package/dist/tools/list-linkedin-reference-data.test.d.ts +2 -0
  49. package/dist/tools/list-linkedin-reference-data.test.d.ts.map +1 -0
  50. package/dist/tools/list-linkedin-reference-data.test.js +48 -0
  51. package/dist/tools/list-linkedin-reference-data.test.js.map +1 -0
  52. package/dist/tools/remove-people-from-collection.d.ts +4 -0
  53. package/dist/tools/remove-people-from-collection.d.ts.map +1 -0
  54. package/dist/tools/remove-people-from-collection.js +29 -0
  55. package/dist/tools/remove-people-from-collection.js.map +1 -0
  56. package/dist/tools/resolve-linkedin-entity.d.ts +4 -0
  57. package/dist/tools/resolve-linkedin-entity.d.ts.map +1 -0
  58. package/dist/tools/resolve-linkedin-entity.js +30 -0
  59. package/dist/tools/resolve-linkedin-entity.js.map +1 -0
  60. package/dist/tools/resolve-linkedin-entity.test.d.ts +2 -0
  61. package/dist/tools/resolve-linkedin-entity.test.d.ts.map +1 -0
  62. package/dist/tools/resolve-linkedin-entity.test.js +66 -0
  63. package/dist/tools/resolve-linkedin-entity.test.js.map +1 -0
  64. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  MCP server for [lhremote](https://github.com/alexey-pelykh/lhremote) — LinkedHelper automation toolkit.
4
4
 
5
- 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.
5
+ 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 44 registered tools to control LinkedHelper.
6
6
 
7
7
  Built on [`@lhremote/core`](../core).
8
8
 
@@ -52,10 +52,11 @@ await runStdioServer();
52
52
  | Account & Instance | `list-accounts`, `start-instance`, `stop-instance`, `check-status` |
53
53
  | Campaigns | `campaign-list`, `campaign-create`, `campaign-get`, `campaign-export`, `campaign-update`, `campaign-delete`, `campaign-start`, `campaign-stop` |
54
54
  | Campaign Status | `campaign-status`, `campaign-statistics`, `campaign-retry` |
55
- | Campaign Actions | `campaign-add-action`, `campaign-remove-action`, `campaign-reorder-actions`, `campaign-move-next` |
56
- | Campaign Targeting | `campaign-exclude-list`, `campaign-exclude-add`, `campaign-exclude-remove`, `import-people-from-urls` |
57
- | Profiles & Messaging | `query-profile`, `query-profiles`, `query-messages`, `check-replies`, `scrape-messaging-history` |
58
- | Utilities | `describe-actions` |
55
+ | Campaign Actions | `campaign-add-action`, `campaign-remove-action`, `campaign-update-action`, `campaign-reorder-actions`, `campaign-move-next` |
56
+ | Campaign Targeting | `campaign-exclude-list`, `campaign-exclude-add`, `campaign-exclude-remove`, `campaign-list-people`, `campaign-remove-people`, `import-people-from-urls`, `collect-people` |
57
+ | Collections | `list-collections`, `create-collection`, `delete-collection`, `add-people-to-collection`, `remove-people-from-collection`, `import-people-from-collection` |
58
+ | Profiles & Messaging | `query-profile`, `query-profiles`, `query-profiles-bulk`, `query-messages`, `check-replies`, `scrape-messaging-history` |
59
+ | Utilities | `describe-actions`, `get-errors` |
59
60
 
60
61
  See the [root README](https://github.com/alexey-pelykh/lhremote#mcp-tools) for parameter details on each tool.
61
62
 
@@ -83,7 +83,17 @@ describe("createServer", () => {
83
83
  expect(names).toContain("campaign-update-action");
84
84
  expect(names).toContain("campaign-remove-people");
85
85
  expect(names).toContain("get-errors");
86
- expect(names).toHaveLength(37);
86
+ expect(names).toContain("list-collections");
87
+ expect(names).toContain("create-collection");
88
+ expect(names).toContain("delete-collection");
89
+ expect(names).toContain("add-people-to-collection");
90
+ expect(names).toContain("remove-people-from-collection");
91
+ expect(names).toContain("import-people-from-collection");
92
+ expect(names).toContain("collect-people");
93
+ expect(names).toContain("build-linkedin-url");
94
+ expect(names).toContain("list-linkedin-reference-data");
95
+ expect(names).toContain("resolve-linkedin-entity");
96
+ expect(names).toHaveLength(47);
87
97
  });
88
98
  });
89
99
  //# sourceMappingURL=server.test.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"server.test.js","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.test.js","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /** Register the {@link https://github.com/alexey-pelykh/lhremote#add-people-to-collection | add-people-to-collection} MCP tool. */
3
+ export declare function registerAddPeopleToCollection(server: McpServer): void;
4
+ //# sourceMappingURL=add-people-to-collection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"add-people-to-collection.d.ts","sourceRoot":"","sources":["../../src/tools/add-people-to-collection.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,mIAAmI;AACnI,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBrE"}
@@ -0,0 +1,29 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ // Copyright (C) 2026 Oleksii PELYKH
3
+ import { addPeopleToCollection } from "@lhremote/core";
4
+ import { z } from "zod";
5
+ import { cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
6
+ /** Register the {@link https://github.com/alexey-pelykh/lhremote#add-people-to-collection | add-people-to-collection} MCP tool. */
7
+ export function registerAddPeopleToCollection(server) {
8
+ server.tool("add-people-to-collection", "Add people to a LinkedHelper collection (List) by person IDs. Idempotent — adding an already-present person is a no-op.", {
9
+ collectionId: z
10
+ .number()
11
+ .int()
12
+ .positive()
13
+ .describe("Collection ID to add people to"),
14
+ personIds: z
15
+ .array(z.number().int().positive())
16
+ .nonempty()
17
+ .describe("Person IDs to add to the collection"),
18
+ ...cdpConnectionSchema,
19
+ }, async ({ collectionId, personIds, cdpPort, cdpHost, allowRemote }) => {
20
+ try {
21
+ const result = await addPeopleToCollection({ collectionId, personIds, cdpPort, cdpHost, allowRemote });
22
+ return mcpSuccess(JSON.stringify(result, null, 2));
23
+ }
24
+ catch (error) {
25
+ return mcpCatchAll(error, "Failed to add people to collection");
26
+ }
27
+ });
28
+ }
29
+ //# sourceMappingURL=add-people-to-collection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"add-people-to-collection.js","sourceRoot":"","sources":["../../src/tools/add-people-to-collection.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,mIAAmI;AACnI,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,yHAAyH,EACzH;QACE,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;aAClC,QAAQ,EAAE;aACV,QAAQ,CAAC,qCAAqC,CAAC;QAClD,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,EAAE,YAAY,EAAE,SAAS,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,OAAO,WAAW,CAAC,KAAK,EAAE,oCAAoC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /** Register the {@link https://github.com/alexey-pelykh/lhremote#build-linkedin-url | build-linkedin-url} MCP tool. */
3
+ export declare function registerBuildLinkedInUrl(server: McpServer): void;
4
+ //# sourceMappingURL=build-linkedin-url.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-linkedin-url.d.ts","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqCzE,uHAAuH;AACvH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8FhE"}
@@ -0,0 +1,117 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ // Copyright (C) 2026 Oleksii PELYKH
3
+ import { buildLinkedInUrl } from "@lhremote/core";
4
+ import { z } from "zod";
5
+ import { mcpError, mcpSuccess } from "../helpers.js";
6
+ const snFilterValueSchema = z.object({
7
+ id: z.string().describe("Entity ID or URN"),
8
+ text: z.string().optional().describe("Display text"),
9
+ selectionType: z
10
+ .enum(["INCLUDED", "EXCLUDED"])
11
+ .describe("Include or exclude this value"),
12
+ });
13
+ const snFilterSchema = z.object({
14
+ type: z
15
+ .string()
16
+ .describe("Filter type (CURRENT_COMPANY, PAST_COMPANY, REGION, SENIORITY_LEVEL, FUNCTION, INDUSTRY, COMPANY_HEADCOUNT, COMPANY_TYPE, CURRENT_TITLE, PAST_TITLE, YEARS_AT_CURRENT_COMPANY, YEARS_AT_CURRENT_POSITION, YEARS_OF_EXPERIENCE, SCHOOL, PROFILE_LANGUAGE, GROUP, CONNECTION)"),
17
+ values: z.array(snFilterValueSchema).describe("Filter values"),
18
+ });
19
+ const booleanExpressionSchema = z.union([
20
+ z.object({
21
+ raw: z.string().describe("Raw boolean expression string"),
22
+ }).strict(),
23
+ z.object({
24
+ and: z.array(z.string()).optional().describe("Terms joined with AND"),
25
+ or: z.array(z.string()).optional().describe("Terms grouped with OR"),
26
+ not: z.array(z.string()).optional().describe("Terms negated with NOT"),
27
+ phrases: z
28
+ .array(z.string())
29
+ .optional()
30
+ .describe("Exact phrases (quoted)"),
31
+ }),
32
+ ]);
33
+ /** Register the {@link https://github.com/alexey-pelykh/lhremote#build-linkedin-url | build-linkedin-url} MCP tool. */
34
+ export function registerBuildLinkedInUrl(server) {
35
+ server.tool("build-linkedin-url", "Build a LinkedIn URL for any supported source type. Dispatches to the appropriate builder based on sourceType: SearchPage (basic search with faceted filters), SNSearchPage (Sales Navigator with Rest.li encoding), parameterised templates (company/school/group/event pages), or fixed URLs (connections, profile views, etc.).", {
36
+ sourceType: z
37
+ .string()
38
+ .describe("LinkedIn source type (SearchPage, SNSearchPage, OrganizationPeople, Alumni, Group, Event, MyConnections, LWVYPP, SentInvitationPage, FollowersPage, FollowingPage, SNListPage, SNOrgsPage, SNOrgsListsPage, TSearchPage, TProjectPage, RSearchPage, RProjectPage)"),
39
+ // SearchPage params
40
+ keywords: z
41
+ .union([z.string(), booleanExpressionSchema])
42
+ .optional()
43
+ .describe("Keywords (string or structured boolean expression)"),
44
+ currentCompany: z
45
+ .array(z.string())
46
+ .optional()
47
+ .describe("Current company IDs (SearchPage)"),
48
+ pastCompany: z
49
+ .array(z.string())
50
+ .optional()
51
+ .describe("Past company IDs (SearchPage)"),
52
+ geoUrn: z
53
+ .array(z.string())
54
+ .optional()
55
+ .describe("Geographic URN IDs (SearchPage)"),
56
+ industry: z
57
+ .array(z.string())
58
+ .optional()
59
+ .describe("Industry IDs (SearchPage)"),
60
+ school: z
61
+ .array(z.string())
62
+ .optional()
63
+ .describe("School IDs (SearchPage)"),
64
+ network: z
65
+ .array(z.string())
66
+ .optional()
67
+ .describe('Connection degree codes: "F", "S", "O" (SearchPage)'),
68
+ profileLanguage: z
69
+ .array(z.string())
70
+ .optional()
71
+ .describe("Profile language codes (SearchPage)"),
72
+ serviceCategory: z
73
+ .array(z.string())
74
+ .optional()
75
+ .describe("Service category IDs (SearchPage)"),
76
+ // SNSearchPage params
77
+ filters: z
78
+ .array(snFilterSchema)
79
+ .optional()
80
+ .describe("Sales Navigator filters (SNSearchPage)"),
81
+ // Parameterised template params
82
+ slug: z
83
+ .string()
84
+ .optional()
85
+ .describe("Company or school slug (OrganizationPeople, Alumni)"),
86
+ id: z
87
+ .string()
88
+ .optional()
89
+ .describe("Entity ID (Group, Event, SNListPage, SNOrgsListsPage, TProjectPage, RProjectPage)"),
90
+ }, async (args) => {
91
+ try {
92
+ // Strip undefined values to satisfy exactOptionalPropertyTypes
93
+ const input = {
94
+ sourceType: args.sourceType,
95
+ ...(args.keywords !== undefined && { keywords: args.keywords }),
96
+ ...(args.currentCompany !== undefined && { currentCompany: args.currentCompany }),
97
+ ...(args.pastCompany !== undefined && { pastCompany: args.pastCompany }),
98
+ ...(args.geoUrn !== undefined && { geoUrn: args.geoUrn }),
99
+ ...(args.industry !== undefined && { industry: args.industry }),
100
+ ...(args.school !== undefined && { school: args.school }),
101
+ ...(args.network !== undefined && { network: args.network }),
102
+ ...(args.profileLanguage !== undefined && { profileLanguage: args.profileLanguage }),
103
+ ...(args.serviceCategory !== undefined && { serviceCategory: args.serviceCategory }),
104
+ ...(args.filters !== undefined && { filters: args.filters }),
105
+ ...(args.slug !== undefined && { slug: args.slug }),
106
+ ...(args.id !== undefined && { id: args.id }),
107
+ };
108
+ const result = buildLinkedInUrl(input);
109
+ return mcpSuccess(JSON.stringify(result, null, 2));
110
+ }
111
+ catch (error) {
112
+ const message = error instanceof Error ? error.message : String(error);
113
+ return mcpError(message);
114
+ }
115
+ });
116
+ }
117
+ //# sourceMappingURL=build-linkedin-url.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-linkedin-url.js","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=build-linkedin-url.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-linkedin-url.test.d.ts","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,101 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ // Copyright (C) 2026 Oleksii PELYKH
3
+ import { describe, expect, it, beforeEach, vi } from "vitest";
4
+ import { registerBuildLinkedInUrl } from "./build-linkedin-url.js";
5
+ import { createMockServer } from "./testing/mock-server.js";
6
+ function extractText(result) {
7
+ const r = result;
8
+ return r.content?.[0]?.text ?? "";
9
+ }
10
+ describe("registerBuildLinkedInUrl", () => {
11
+ beforeEach(() => {
12
+ vi.clearAllMocks();
13
+ });
14
+ it("registers a tool named build-linkedin-url", () => {
15
+ const { server } = createMockServer();
16
+ registerBuildLinkedInUrl(server);
17
+ expect(server.tool).toHaveBeenCalledOnce();
18
+ expect(server.tool).toHaveBeenCalledWith("build-linkedin-url", expect.any(String), expect.any(Object), expect.any(Function));
19
+ });
20
+ it("builds SearchPage URL with keywords", async () => {
21
+ const { server, getHandler } = createMockServer();
22
+ registerBuildLinkedInUrl(server);
23
+ const handler = getHandler("build-linkedin-url");
24
+ const result = await handler({
25
+ sourceType: "SearchPage",
26
+ keywords: "software engineer",
27
+ });
28
+ const parsed = JSON.parse(extractText(result));
29
+ expect(parsed.sourceType).toBe("SearchPage");
30
+ expect(parsed.url).toContain("/search/results/people/");
31
+ expect(parsed.url).toContain("keywords=");
32
+ });
33
+ it("builds fixed URL for MyConnections", async () => {
34
+ const { server, getHandler } = createMockServer();
35
+ registerBuildLinkedInUrl(server);
36
+ const handler = getHandler("build-linkedin-url");
37
+ const result = await handler({
38
+ sourceType: "MyConnections",
39
+ });
40
+ const parsed = JSON.parse(extractText(result));
41
+ expect(parsed.sourceType).toBe("MyConnections");
42
+ expect(parsed.url).toContain("/connections/");
43
+ });
44
+ it("builds parameterised URL for OrganizationPeople", async () => {
45
+ const { server, getHandler } = createMockServer();
46
+ registerBuildLinkedInUrl(server);
47
+ const handler = getHandler("build-linkedin-url");
48
+ const result = await handler({
49
+ sourceType: "OrganizationPeople",
50
+ slug: "google",
51
+ });
52
+ const parsed = JSON.parse(extractText(result));
53
+ expect(parsed.url).toBe("https://www.linkedin.com/company/google/people/");
54
+ });
55
+ it("returns error for invalid sourceType", async () => {
56
+ const { server, getHandler } = createMockServer();
57
+ registerBuildLinkedInUrl(server);
58
+ const handler = getHandler("build-linkedin-url");
59
+ const result = await handler({
60
+ sourceType: "InvalidType",
61
+ });
62
+ expect(result.isError).toBe(true);
63
+ expect(extractText(result)).toContain("Unknown source type");
64
+ });
65
+ it("returns error when required param is missing", async () => {
66
+ const { server, getHandler } = createMockServer();
67
+ registerBuildLinkedInUrl(server);
68
+ const handler = getHandler("build-linkedin-url");
69
+ const result = await handler({
70
+ sourceType: "OrganizationPeople",
71
+ // missing slug
72
+ });
73
+ expect(result.isError).toBe(true);
74
+ expect(extractText(result)).toContain("Missing required parameter");
75
+ });
76
+ it("builds SNSearchPage URL with filters", async () => {
77
+ const { server, getHandler } = createMockServer();
78
+ registerBuildLinkedInUrl(server);
79
+ const handler = getHandler("build-linkedin-url");
80
+ const result = await handler({
81
+ sourceType: "SNSearchPage",
82
+ keywords: "engineer",
83
+ filters: [
84
+ {
85
+ type: "CURRENT_COMPANY",
86
+ values: [
87
+ {
88
+ id: "urn:li:organization:1441",
89
+ text: "Google",
90
+ selectionType: "INCLUDED",
91
+ },
92
+ ],
93
+ },
94
+ ],
95
+ });
96
+ const parsed = JSON.parse(extractText(result));
97
+ expect(parsed.sourceType).toBe("SNSearchPage");
98
+ expect(parsed.url).toContain("/sales/search/people");
99
+ });
100
+ });
101
+ //# sourceMappingURL=build-linkedin-url.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-linkedin-url.test.js","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /** Register the {@link https://github.com/alexey-pelykh/lhremote#collect-people | collect-people} MCP tool. */
3
+ export declare function registerCollectPeople(server: McpServer): void;
4
+ //# sourceMappingURL=collect-people.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collect-people.d.ts","sourceRoot":"","sources":["../../src/tools/collect-people.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+D7D"}
@@ -0,0 +1,67 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ // Copyright (C) 2026 Oleksii PELYKH
3
+ import { CollectionBusyError, CollectionError, collectPeople, } from "@lhremote/core";
4
+ import { z } from "zod";
5
+ import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
6
+ /** Register the {@link https://github.com/alexey-pelykh/lhremote#collect-people | collect-people} MCP tool. */
7
+ export function registerCollectPeople(server) {
8
+ server.tool("collect-people", "Collect people from a LinkedIn page into a campaign. Detects the source type from the URL automatically. Returns immediately — poll campaign-status for progress.", {
9
+ campaignId: z
10
+ .number()
11
+ .int()
12
+ .positive()
13
+ .describe("Campaign ID to collect people into"),
14
+ sourceUrl: z
15
+ .string()
16
+ .url()
17
+ .describe("LinkedIn page URL to collect people from (e.g., search results, company people, group members)"),
18
+ limit: z
19
+ .number()
20
+ .int()
21
+ .positive()
22
+ .optional()
23
+ .describe("Maximum number of profiles to collect"),
24
+ maxPages: z
25
+ .number()
26
+ .int()
27
+ .positive()
28
+ .optional()
29
+ .describe("Maximum number of pages to process"),
30
+ pageSize: z
31
+ .number()
32
+ .int()
33
+ .positive()
34
+ .optional()
35
+ .describe("Number of results per page"),
36
+ sourceType: z
37
+ .string()
38
+ .optional()
39
+ .describe("Explicit source type to bypass URL detection (e.g., SearchPage, MyConnections)"),
40
+ ...cdpConnectionSchema,
41
+ }, async ({ campaignId, sourceUrl, limit, maxPages, pageSize, sourceType, cdpPort, cdpHost, allowRemote }) => {
42
+ try {
43
+ const result = await collectPeople({
44
+ campaignId,
45
+ sourceUrl,
46
+ ...(limit !== undefined && { limit }),
47
+ ...(maxPages !== undefined && { maxPages }),
48
+ ...(pageSize !== undefined && { pageSize }),
49
+ ...(sourceType !== undefined && { sourceType }),
50
+ cdpPort,
51
+ ...(cdpHost !== undefined && { cdpHost }),
52
+ ...(allowRemote !== undefined && { allowRemote }),
53
+ });
54
+ return mcpSuccess(JSON.stringify(result, null, 2));
55
+ }
56
+ catch (error) {
57
+ if (error instanceof CollectionBusyError) {
58
+ return mcpError(`Cannot collect — instance is busy (state: ${error.runnerState})`);
59
+ }
60
+ if (error instanceof CollectionError) {
61
+ return mcpError(`Collection failed: ${error.message}`);
62
+ }
63
+ return mcpCatchAll(error, "Failed to collect people");
64
+ }
65
+ });
66
+ }
67
+ //# sourceMappingURL=collect-people.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collect-people.js","sourceRoot":"","sources":["../../src/tools/collect-people.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,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,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,mKAAmK,EACnK;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,oCAAoC,CAAC;QACjD,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,CAAC,gGAAgG,CAAC;QAC7G,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,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,CAAC,oCAAoC,CAAC;QACjD,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,4BAA4B,CAAC;QACzC,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,gFAAgF,CAAC;QAC7F,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACxG,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;gBACjC,UAAU;gBACV,SAAS;gBACT,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;gBACrC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC3C,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC3C,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;gBAC/C,OAAO;gBACP,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;gBACzC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;aAClD,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,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAC,6CAA6C,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;YACrF,CAAC;YACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,OAAO,QAAQ,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=collect-people.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collect-people.test.d.ts","sourceRoot":"","sources":["../../src/tools/collect-people.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,129 @@
1
+ // SPDX-License-Identifier: AGPL-3.0-only
2
+ // Copyright (C) 2026 Oleksii PELYKH
3
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
4
+ vi.mock("@lhremote/core", async (importOriginal) => {
5
+ const actual = await importOriginal();
6
+ return {
7
+ ...actual,
8
+ collectPeople: vi.fn(),
9
+ };
10
+ });
11
+ import { CollectionBusyError, CollectionError, collectPeople, } from "@lhremote/core";
12
+ import { registerCollectPeople } from "./collect-people.js";
13
+ import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
14
+ import { createMockServer } from "./testing/mock-server.js";
15
+ describe("registerCollectPeople", () => {
16
+ beforeEach(() => {
17
+ vi.clearAllMocks();
18
+ });
19
+ afterEach(() => {
20
+ vi.restoreAllMocks();
21
+ });
22
+ it("registers a tool named collect-people", () => {
23
+ const { server } = createMockServer();
24
+ registerCollectPeople(server);
25
+ expect(server.tool).toHaveBeenCalledOnce();
26
+ expect(server.tool).toHaveBeenCalledWith("collect-people", expect.any(String), expect.any(Object), expect.any(Function));
27
+ });
28
+ it("returns success result with detected source type", async () => {
29
+ const { server, getHandler } = createMockServer();
30
+ registerCollectPeople(server);
31
+ vi.mocked(collectPeople).mockResolvedValue({
32
+ success: true,
33
+ campaignId: 42,
34
+ sourceType: "SearchPage",
35
+ });
36
+ const handler = getHandler("collect-people");
37
+ const result = await handler({
38
+ campaignId: 42,
39
+ sourceUrl: "https://www.linkedin.com/search/results/people/",
40
+ cdpPort: 9222,
41
+ });
42
+ expect(result).toEqual({
43
+ content: [
44
+ {
45
+ type: "text",
46
+ text: JSON.stringify({
47
+ success: true,
48
+ campaignId: 42,
49
+ sourceType: "SearchPage",
50
+ }, null, 2),
51
+ },
52
+ ],
53
+ });
54
+ });
55
+ it("passes all arguments to the operation", async () => {
56
+ const { server, getHandler } = createMockServer();
57
+ registerCollectPeople(server);
58
+ vi.mocked(collectPeople).mockResolvedValue({
59
+ success: true,
60
+ campaignId: 42,
61
+ sourceType: "SearchPage",
62
+ });
63
+ const handler = getHandler("collect-people");
64
+ await handler({
65
+ campaignId: 42,
66
+ sourceUrl: "https://www.linkedin.com/search/results/people/",
67
+ limit: 100,
68
+ maxPages: 5,
69
+ pageSize: 25,
70
+ sourceType: "SearchPage",
71
+ cdpPort: 9222,
72
+ });
73
+ expect(collectPeople).toHaveBeenCalledWith(expect.objectContaining({
74
+ campaignId: 42,
75
+ sourceUrl: "https://www.linkedin.com/search/results/people/",
76
+ limit: 100,
77
+ maxPages: 5,
78
+ pageSize: 25,
79
+ sourceType: "SearchPage",
80
+ cdpPort: 9222,
81
+ }));
82
+ });
83
+ it("returns error when instance is busy", async () => {
84
+ const { server, getHandler } = createMockServer();
85
+ registerCollectPeople(server);
86
+ vi.mocked(collectPeople).mockRejectedValue(new CollectionBusyError("running"));
87
+ const handler = getHandler("collect-people");
88
+ const result = await handler({
89
+ campaignId: 42,
90
+ sourceUrl: "https://www.linkedin.com/search/results/people/",
91
+ cdpPort: 9222,
92
+ });
93
+ expect(result).toEqual({
94
+ isError: true,
95
+ content: [
96
+ {
97
+ type: "text",
98
+ text: "Cannot collect — instance is busy (state: running)",
99
+ },
100
+ ],
101
+ });
102
+ });
103
+ it("returns error for unrecognized source URL", async () => {
104
+ const { server, getHandler } = createMockServer();
105
+ registerCollectPeople(server);
106
+ vi.mocked(collectPeople).mockRejectedValue(new CollectionError("Unrecognized source URL: https://www.linkedin.com/unknown/"));
107
+ const handler = getHandler("collect-people");
108
+ const result = await handler({
109
+ campaignId: 42,
110
+ sourceUrl: "https://www.linkedin.com/unknown/",
111
+ cdpPort: 9222,
112
+ });
113
+ expect(result).toEqual({
114
+ isError: true,
115
+ content: [
116
+ {
117
+ type: "text",
118
+ text: "Collection failed: Unrecognized source URL: https://www.linkedin.com/unknown/",
119
+ },
120
+ ],
121
+ });
122
+ });
123
+ describeInfrastructureErrors(registerCollectPeople, "collect-people", () => ({
124
+ campaignId: 42,
125
+ sourceUrl: "https://www.linkedin.com/search/results/people/",
126
+ cdpPort: 9222,
127
+ }), (error) => vi.mocked(collectPeople).mockRejectedValue(error), "Failed to collect people");
128
+ });
129
+ //# sourceMappingURL=collect-people.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collect-people.test.js","sourceRoot":"","sources":["../../src/tools/collect-people.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,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE;KACvB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,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,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QACtC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,gBAAgB,EAChB,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,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE9B,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC;YACzC,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,iDAAiD;YAC5D,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,UAAU,EAAE,YAAY;qBACzB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;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,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE9B,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC;YACzC,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,OAAO,CAAC;YACZ,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,iDAAiD;YAC5D,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,YAAY;YACxB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CACxC,MAAM,CAAC,gBAAgB,CAAC;YACtB,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,iDAAiD;YAC5D,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,YAAY;YACxB,OAAO,EAAE,IAAI;SACd,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE9B,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,iBAAiB,CACxC,IAAI,mBAAmB,CAAC,SAAS,CAAC,CACnC,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,iDAAiD;YAC5D,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,oDAAoD;iBAC3D;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAClD,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE9B,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,iBAAiB,CACxC,IAAI,eAAe,CAAC,4DAA4D,CAAC,CAClF,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,mCAAmC;YAC9C,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,+EAA+E;iBACtF;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,4BAA4B,CAC1B,qBAAqB,EACrB,gBAAgB,EAChB,GAAG,EAAE,CAAC,CAAC;QACL,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,iDAAiD;QAC5D,OAAO,EAAE,IAAI;KACd,CAAC,EACF,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAC5D,0BAA0B,CAC3B,CAAC;AACJ,CAAC,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /** Register the {@link https://github.com/alexey-pelykh/lhremote#create-collection | create-collection} MCP tool. */
3
+ export declare function registerCreateCollection(server: McpServer): void;
4
+ //# sourceMappingURL=create-collection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-collection.d.ts","sourceRoot":"","sources":["../../src/tools/create-collection.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,qHAAqH;AACrH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoBhE"}