@clustr-ai/mcp-server 1.0.5 → 1.0.7

package/dist/index.js

@@ -3,6 +3,8 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { initClient } from "./client.js";
 import { registerImportContacts } from "./tools/import-contacts.js";
+import { registerStartABMSearch } from "./tools/start-abm-search.js";
+import { registerWhatsNew } from "./tools/whats-new.js";
 import { registerCreateTargetAccounts } from "./tools/create-target-accounts.js";
 import { registerListTargetAccounts } from "./tools/list-target-accounts.js";
 import { registerDeleteTargetAccount } from "./tools/delete-target-account.js";
@@ -19,7 +21,9 @@ const server = new McpServer({
     version: "1.0.0",
 });
 initClient();
+registerWhatsNew(server);
 registerImportContacts(server);
+registerStartABMSearch(server);
 registerSearchOpportunities(server);
 registerSearchCompanies(server);
 registerListConnectors(server);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,UAAU,EAAE,CAAC;AAEb,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,+BAA+B,CAAC,MAAM,CAAC,CAAC;AACxC,4BAA4B,CAAC,MAAM,CAAC,CAAC;AACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACnC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,UAAU,EAAE,CAAC;AAEb,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACpC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,+BAA+B,CAAC,MAAM,CAAC,CAAC;AACxC,4BAA4B,CAAC,MAAM,CAAC,CAAC;AACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACnC,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/start-abm-search.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStartABMSearch(server: McpServer): void;

package/dist/tools/start-abm-search.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { get, post, wrapToolHandler } from "../client.js";
+const startSchema = {
+    company_name: z.string().describe("Name of the target company"),
+    company_linkedin_url: z
+        .string()
+        .describe("LinkedIn company page URL (must contain /company/)"),
+    countries: z
+        .array(z.string())
+        .optional()
+        .describe('Filter buyers by country (e.g. ["United States", "United Kingdom"])'),
+    completion_email: z
+        .string()
+        .optional()
+        .describe("Email to notify when the report is ready"),
+};
+const getLinkSchema = {
+    company_linkedin_url: z
+        .string()
+        .describe("LinkedIn company page URL of the existing ABM search"),
+};
+export function registerStartABMSearch(server) {
+    server.tool("start_abm_search", "Start an Account-Based Marketing (ABM) search for a target company. " +
+        "Returns a magic_link immediately — the link shows a processing page while the pipeline runs " +
+        "(typically 2-5 minutes) and auto-resolves to the full report when done. " +
+        "The magic link is deterministic: repeated calls for the same company return the same URL.", startSchema, wrapToolHandler((params) => post("/abm-search", params)));
+    server.tool("get_abm_search_link", "Retrieve the magic link for an existing ABM search without starting a new job. " +
+        "Use this when you want to share or re-fetch the link for a search that was already run.", getLinkSchema, wrapToolHandler(({ company_linkedin_url }) => get(`/abm-search?company_linkedin_url=${encodeURIComponent(company_linkedin_url)}`)));
+}
+//# sourceMappingURL=start-abm-search.js.map

package/dist/tools/start-abm-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-abm-search.js","sourceRoot":"","sources":["../../src/tools/start-abm-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,WAAW,GAAG;IAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC/D,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,CAAC,oDAAoD,CAAC;IACjE,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IAClF,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,sEAAsE;QACpE,8FAA8F;QAC9F,0EAA0E;QAC1E,2FAA2F,EAC7F,WAAW,EACX,eAAe,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CACzD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,iFAAiF;QAC/E,yFAAyF,EAC3F,aAAa,EACb,eAAe,CAAC,CAAC,EAAE,oBAAoB,EAAE,EAAE,EAAE,CAC3C,GAAG,CAAC,oCAAoC,kBAAkB,CAAC,oBAA8B,CAAC,EAAE,CAAC,CAC9F,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/whats-new.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerWhatsNew(server: McpServer): void;

package/dist/tools/whats-new.js

@@ -0,0 +1,46 @@
+// Append an entry here every time a new tool or breaking change ships.
+// Keep entries in reverse-chronological order (newest first).
+const CHANGELOG = [
+    {
+        version: "1.1.0",
+        date: "2026-05-02",
+        changes: [
+            "NEW: start_abm_search — start an Account-Based Marketing search for any company and get a shareable magic link immediately. The link auto-resolves to the full report when the pipeline finishes.",
+            "NEW: get_abm_search_link — retrieve the magic link for an existing ABM search without re-running the pipeline.",
+        ],
+    },
+    {
+        version: "1.0.0",
+        date: "2026-04-01",
+        changes: [
+            "Initial release: import_contacts, search_opportunities, search_companies, list_connectors, get_network_stats, get_job_status, list_jobs, update_opportunity, list_opportunity_statuses, create_target_accounts, list_target_accounts, delete_target_account.",
+        ],
+    },
+];
+const CURRENT_VERSION = CHANGELOG[0].version;
+const UPGRADE_INSTRUCTIONS = "To upgrade: npm install -g @clustr-ai/mcp-server@latest  " +
+    "(or re-run whatever install command you used originally, e.g. npx @clustr-ai/mcp-server)";
+export function registerWhatsNew(server) {
+    server.tool("whats_new", `Show the Clustr MCP changelog and available tools. ` +
+        `Current version: ${CURRENT_VERSION}. ` +
+        `Call this to check whether a newer version with additional tools is available.`, {}, async () => {
+        const lines = [
+            `Clustr MCP Server — installed version: ${CURRENT_VERSION}`,
+            "",
+            "=== Changelog ===",
+        ];
+        for (const entry of CHANGELOG) {
+            lines.push(`\nv${entry.version} (${entry.date})`);
+            for (const change of entry.changes) {
+                lines.push(`  • ${change}`);
+            }
+        }
+        lines.push("");
+        lines.push("=== Upgrade ===");
+        lines.push(UPGRADE_INSTRUCTIONS);
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    });
+}
+//# sourceMappingURL=whats-new.js.map

package/dist/tools/whats-new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whats-new.js","sourceRoot":"","sources":["../../src/tools/whats-new.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,8DAA8D;AAC9D,MAAM,SAAS,GAA2D;IACxE;QACE,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE;YACP,mMAAmM;YACnM,gHAAgH;SACjH;KACF;IACD;QACE,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE;YACP,8PAA8P;SAC/P;KACF;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAE7C,MAAM,oBAAoB,GACxB,2DAA2D;IAC3D,0FAA0F,CAAC;AAE7F,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,WAAW,EACX,qDAAqD;QACnD,oBAAoB,eAAe,IAAI;QACvC,gFAAgF,EAClF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,KAAK,GAAa;YACtB,0CAA0C,eAAe,EAAE;YAC3D,EAAE;YACF,mBAAmB;SACpB,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YAClD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAEjC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clustr-ai/mcp-server",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "MCP server for the Clustr API — search referral opportunities, manage target accounts, and import contacts from AI assistants",
   "type": "module",
   "main": "dist/index.js",