@mentoringo/vantage-ops-mcp 1.3.0

package/dist/tools/admin-tools.js

@@ -0,0 +1,214 @@
+import { z } from "zod";
+import { tables, scanTable, getItem, apiHealth, describeTable, readsConfigured } from "../dynamo.js";
+import { clientEntity, userEntity, listOutput, getOutput, healthOutput, tableCountsOutput, } from "../schemas.js";
+export function registerAdminTools(server) {
+    server.registerTool("vantage_health", {
+        description: "Check Vantage API health and MCP read-surface auth",
+        inputSchema: {},
+        outputSchema: healthOutput,
+    }, async () => {
+        try {
+            const api = await apiHealth();
+            const keyConfigured = readsConfigured();
+            const summary = [
+                "Vantage Health Check",
+                "",
+                `API: ${api.healthy ? "OK" : "DOWN"} — ${api.message}`,
+                `MCP key: ${keyConfigured ? "configured" : "NOT SET (reads will fail)"}`,
+            ].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    healthy: api.healthy && keyConfigured,
+                    details: {
+                        api_healthy: api.healthy,
+                        api_message: api.message,
+                        key_configured: keyConfigured,
+                    },
+                    summary,
+                },
+            };
+        }
+        catch (e) {
+            const summary = `Health check failed: ${e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    healthy: false,
+                    details: { error: e.message },
+                    summary,
+                },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_clients_list", {
+        description: "List all Vantage clients/tenants",
+        inputSchema: {
+            status: z
+                .string()
+                .optional()
+                .describe("Filter by client status (e.g. active, inactive)"),
+        },
+        outputSchema: listOutput(clientEntity),
+    }, async ({ status }) => {
+        try {
+            let items;
+            if (status) {
+                // Use scan with filter since client table is small
+                const result = await scanTable(tables.clients, {
+                    limit: 50,
+                    filterExpression: "#s = :s",
+                    expressionValues: { ":s": { S: status } },
+                    expressionNames: { "#s": "status" },
+                });
+                items = result.items;
+            }
+            else {
+                const result = await scanTable(tables.clients, { limit: 50 });
+                items = result.items;
+            }
+            if (items.length === 0) {
+                const summary = "No clients found.";
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { items: [], count: 0, summary },
+                };
+            }
+            const lines = items.map((c) => {
+                return `${c.name || c.id}\n  id: ${c.id} | status: ${c.status || "—"} | slug: ${c.slug || "—"} | industry: ${c.industry || "—"}`;
+            });
+            const summary = `${items.length} clients:\n\n${lines.join("\n\n")}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items, count: items.length, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error listing clients: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items: [], count: 0, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_client_get", {
+        description: "Get full details for a single Vantage client by ID",
+        inputSchema: {
+            id: z.string().describe("Client ID"),
+        },
+        outputSchema: getOutput(clientEntity),
+    }, async ({ id }) => {
+        try {
+            const item = await getItem(tables.clients, { id: { S: id } });
+            if (!item) {
+                const summary = `Client ${id} not found.`;
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { found: false, summary },
+                };
+            }
+            const summary = JSON.stringify(item, null, 2);
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { found: true, item, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error fetching client: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { found: false, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_users_list", {
+        description: "List all Vantage platform users",
+        inputSchema: {
+            client_id: z.string().optional().describe("Filter by client ID"),
+        },
+        outputSchema: listOutput(userEntity),
+    }, async ({ client_id }) => {
+        try {
+            let items;
+            if (client_id) {
+                const result = await scanTable(tables.users, {
+                    limit: 50,
+                    filterExpression: "client_id = :c",
+                    expressionValues: { ":c": { S: client_id } },
+                });
+                items = result.items;
+            }
+            else {
+                const result = await scanTable(tables.users, { limit: 50 });
+                items = result.items;
+            }
+            if (items.length === 0) {
+                const summary = "No users found.";
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { items: [], count: 0, summary },
+                };
+            }
+            const lines = items.map((u) => {
+                const name = u.name || [u.first_name, u.last_name].filter(Boolean).join(" ") || u.id;
+                return `${name}\n  email: ${u.email || "—"} | role: ${u.role || "—"} | client: ${u.client_name || u.client_id || "—"}`;
+            });
+            const summary = `${items.length} users:\n\n${lines.join("\n\n")}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items, count: items.length, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error listing users: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items: [], count: 0, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_table_counts", {
+        description: "Get item counts across all Vantage DynamoDB tables for a quick health overview",
+        inputSchema: {},
+        outputSchema: tableCountsOutput,
+    }, async () => {
+        try {
+            const aliases = Object.entries(tables);
+            const tableMap = {};
+            const lineResults = await Promise.all(aliases.map(async ([label, alias]) => {
+                try {
+                    const { itemCount, tableSizeBytes } = await describeTable(alias);
+                    tableMap[label] = {
+                        item_count: itemCount,
+                        size_bytes: tableSizeBytes,
+                        available: true,
+                    };
+                    const sizeMB = (tableSizeBytes / (1024 * 1024)).toFixed(1);
+                    return `  ${label}: ${itemCount.toLocaleString()} items (${sizeMB} MB)`;
+                }
+                catch {
+                    tableMap[label] = { available: false };
+                    return `  ${label}: unavailable`;
+                }
+            }));
+            const summary = ["Vantage Table Overview", "", ...lineResults].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { tables: tableMap, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error: ${e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { tables: {}, summary },
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=admin-tools.js.map

package/dist/tools/admin-tools.js.map

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

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

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

package/dist/tools/campaign-tools.js

@@ -0,0 +1,219 @@
+import { z } from "zod";
+import { tables, queryByIndex, queryTable, scanTable, getItem } from "../dynamo.js";
+import { campaignEntity, campaignTargetEntity, listOutput, getOutput, statsOutput, } from "../schemas.js";
+export function registerCampaignTools(server) {
+    server.registerTool("vantage_campaigns_list", {
+        description: "List Vantage campaigns with optional status or client filter",
+        inputSchema: {
+            status: z
+                .enum(["draft", "active", "paused", "completed"])
+                .optional()
+                .describe("Filter by campaign status (uses by-status GSI)"),
+            client_id: z
+                .string()
+                .optional()
+                .describe("Filter by client ID (uses by-client GSI)"),
+            vertical: z
+                .string()
+                .optional()
+                .describe("Filter by vertical (uses by-vertical GSI)"),
+            limit: z.number().optional().default(25).describe("Max results (default 25, max 50)"),
+        },
+        outputSchema: listOutput(campaignEntity),
+    }, async ({ status, client_id, vertical, limit }) => {
+        try {
+            const cap = Math.min(limit || 25, 50);
+            let items;
+            if (status) {
+                const result = await queryByIndex(tables.campaigns, "by-status", "#s = :s", { ":s": { S: status } }, { limit: cap, scanForward: false, expressionNames: { "#s": "status" } });
+                items = result.items;
+            }
+            else if (client_id) {
+                const result = await queryByIndex(tables.campaigns, "by-client", "client_id = :c", { ":c": { S: client_id } }, { limit: cap, scanForward: false });
+                items = result.items;
+            }
+            else if (vertical) {
+                const result = await queryByIndex(tables.campaigns, "by-vertical", "vertical = :v", { ":v": { S: vertical } }, { limit: cap, scanForward: false });
+                items = result.items;
+            }
+            else {
+                const result = await scanTable(tables.campaigns, { limit: cap });
+                items = result.items;
+            }
+            if (items.length === 0) {
+                const summary = "No campaigns found.";
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { items: [], count: 0, summary },
+                };
+            }
+            const lines = items.map((c) => {
+                const recipients = c.recipient_count || c.total_recipients || "—";
+                return `${c.name || c.id}\n  id: ${c.id || "—"} | status: ${c.status || "—"} | type: ${c.campaign_type || "—"} | vertical: ${c.vertical || "—"} | recipients: ${recipients} | created: ${c.created_at || "—"}`;
+            });
+            const summary = `${items.length} campaigns:\n\n${lines.join("\n\n")}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items, count: items.length, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error listing campaigns: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items: [], count: 0, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_campaign_get", {
+        description: "Get full details for a single Vantage campaign by ID. " +
+            "Enriches total_targets and target_company_ids from the " +
+            "campaign-targets junction table — the values stored on the " +
+            "campaign record drift to 0 / [] because add_targets writes only " +
+            "to the junction. The REST GET /campaigns/{id} endpoint does the " +
+            "same enrichment server-side; this tool mirrors it for MCP " +
+            "callers who go through /v2/mcp-reads.",
+        inputSchema: {
+            id: z.string().describe("Campaign ID"),
+        },
+        outputSchema: getOutput(campaignEntity),
+    }, async ({ id }) => {
+        try {
+            const item = await getItem(tables.campaigns, { id: { S: id } });
+            if (!item) {
+                const summary = `Campaign ${id} not found.`;
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { found: false, summary },
+                };
+            }
+            // Enrich with live junction data. Failure here shouldn't fail the
+            // whole get_campaign call — better to return the campaign with the
+            // stored (possibly stale) counters than to 500.
+            try {
+                const targets = await queryTable(tables.campaignTargets, "campaign_id = :c", { ":c": { S: id } }, { limit: 500 });
+                item.total_targets = targets.count;
+                item.target_company_ids = targets.items
+                    .map((t) => t.company_id)
+                    .filter(Boolean);
+            }
+            catch {
+                // Leave the stored values in place if the junction query fails.
+            }
+            const summary = JSON.stringify(item, null, 2);
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { found: true, item, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error fetching campaign: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { found: false, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_campaigns_stats", {
+        description: "Get aggregate campaign statistics — counts by status, type, and vertical",
+        inputSchema: {},
+        outputSchema: statsOutput,
+    }, async () => {
+        try {
+            const result = await scanTable(tables.campaigns, { limit: 200 });
+            const items = result.items;
+            const byStatus = {};
+            const byType = {};
+            const byVertical = {};
+            for (const c of items) {
+                const status = c.status || "unknown";
+                const type = c.campaign_type || "unknown";
+                const vertical = c.vertical || "unknown";
+                byStatus[status] = (byStatus[status] || 0) + 1;
+                byType[type] = (byType[type] || 0) + 1;
+                byVertical[vertical] = (byVertical[vertical] || 0) + 1;
+            }
+            const fmt = (obj) => Object.entries(obj)
+                .sort((a, b) => b[1] - a[1])
+                .map(([k, v]) => `  ${k}: ${v}`)
+                .join("\n");
+            const summary = [
+                `Total campaigns: ${items.length}`,
+                "",
+                "By Status:",
+                fmt(byStatus),
+                "",
+                "By Type:",
+                fmt(byType),
+                "",
+                "By Vertical:",
+                fmt(byVertical),
+            ].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    total: items.length,
+                    buckets: {
+                        status: byStatus,
+                        type: byType,
+                        vertical: byVertical,
+                    },
+                    summary,
+                },
+            };
+        }
+        catch (e) {
+            const summary = `Error fetching stats: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { total: 0, buckets: {}, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_campaign_list_targets", {
+        description: "List the companies attached to a campaign (campaign-targets " +
+            "junction). Returns the per-link metadata — priority, added_by, " +
+            "added_at — that vantage_campaign_get's target_company_ids field " +
+            "doesn't carry. Use this when you need to audit how a campaign's " +
+            "target list was built, not just count it.",
+        inputSchema: {
+            campaign_id: z.string().describe("Campaign ID"),
+            limit: z.number().optional().default(100).describe("Max results (default 100, max 500)"),
+        },
+        outputSchema: listOutput(campaignTargetEntity),
+    }, async ({ campaign_id, limit }) => {
+        try {
+            const cap = Math.min(limit || 100, 500);
+            const result = await queryTable(tables.campaignTargets, "campaign_id = :c", { ":c": { S: campaign_id } }, { limit: cap });
+            if (result.items.length === 0) {
+                const summary = `No targets attached to campaign ${campaign_id}.`;
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { items: [], count: 0, summary },
+                };
+            }
+            const lines = result.items.map((t) => {
+                const priority = t.priority || "—";
+                const added = t.added_at || "—";
+                return `${t.company_id}\n  priority: ${priority} | added: ${added} | by: ${t.added_by || "—"}`;
+            });
+            const summary = `${result.items.length} targets:\n\n${lines.join("\n\n")}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items: result.items, count: result.items.length, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error listing campaign targets: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items: [], count: 0, summary },
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=campaign-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-tools.js","sourceRoot":"","sources":["../../src/tools/campaign-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;iBAChD,QAAQ,EAAE;iBACV,QAAQ,CAAC,gDAAgD,CAAC;YAC7D,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;YACvD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;YACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SACtF;QACD,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC;KACzC,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,KAA4B,CAAC;YAEjC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,MAAM,CAAC,SAAS,EAAE,WAAW,EAC7B,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAClC,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CACxE,CAAC;gBACF,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;iBAAM,IAAI,SAAS,EAAE,CAAC;gBACrB,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,MAAM,CAAC,SAAS,EAAE,WAAW,EAC7B,gBAAgB,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAC5C,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CACnC,CAAC;gBACF,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;iBAAM,IAAI,QAAQ,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,MAAM,CAAC,SAAS,EAAE,aAAa,EAC/B,eAAe,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAC1C,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CACnC,CAAC;gBACF,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBACjE,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,qBAAqB,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;oBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE;iBACpD,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC5B,MAAM,UAAU,GAAG,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,gBAAgB,IAAI,GAAG,CAAC;gBAClE,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,IAAI,GAAG,cAAc,CAAC,CAAC,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,aAAa,IAAI,GAAG,gBAAgB,CAAC,CAAC,QAAQ,IAAI,GAAG,kBAAkB,UAAU,eAAe,CAAC,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACjN,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,kBAAkB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;aAC3D,CAAC;QACJ,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,4BAA4B,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,wDAAwD;YACxD,yDAAyD;YACzD,6DAA6D;YAC7D,kEAAkE;YAClE,kEAAkE;YAClE,4DAA4D;YAC5D,uCAAuC;QACzC,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;SACvC;QACD,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC;KACxC,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAEhE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,OAAO,GAAG,YAAY,EAAE,aAAa,CAAC;gBAC5C,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;oBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;iBAC7C,CAAC;YACJ,CAAC;YAED,kEAAkE;YAClE,mEAAmE;YACnE,gDAAgD;YAChD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,MAAM,CAAC,eAAe,EACtB,kBAAkB,EAClB,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EACnB,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;gBACF,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;gBACnC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,KAAK;qBACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;qBACxB,MAAM,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;YAClE,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;aAClD,CAAC;QACJ,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,4BAA4B,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;gBAC5C,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EAAE,0EAA0E;QACvF,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,WAAW;KAC1B,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAE3B,MAAM,QAAQ,GAA2B,EAAE,CAAC;YAC5C,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,MAAM,UAAU,GAA2B,EAAE,CAAC;YAE9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;gBACrC,MAAM,IAAI,GAAG,CAAC,CAAC,aAAa,IAAI,SAAS,CAAC;gBAC1C,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,SAAS,CAAC;gBACzC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzD,CAAC;YAED,MAAM,GAAG,GAAG,CAAC,GAA2B,EAAE,EAAE,CAC1C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;iBAChB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC3B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;iBAC/B,IAAI,CAAC,IAAI,CAAC,CAAC;YAEhB,MAAM,OAAO,GAAG;gBACd,oBAAoB,KAAK,CAAC,MAAM,EAAE;gBAClC,EAAE;gBACF,YAAY;gBACZ,GAAG,CAAC,QAAQ,CAAC;gBACb,EAAE;gBACF,UAAU;gBACV,GAAG,CAAC,MAAM,CAAC;gBACX,EAAE;gBACF,cAAc;gBACd,GAAG,CAAC,UAAU,CAAC;aAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE;oBACjB,KAAK,EAAE,KAAK,CAAC,MAAM;oBACnB,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;wBAChB,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,UAAU;qBACrB;oBACD,OAAO;iBACR;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,yBAAyB,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACzE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE;gBACrD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,+BAA+B,EAC/B;QACE,WAAW,EACT,8DAA8D;YAC9D,iEAAiE;YACjE,kEAAkE;YAClE,kEAAkE;YAClE,2CAA2C;QAC7C,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SACzF;QACD,YAAY,EAAE,UAAU,CAAC,oBAAoB,CAAC;KAC/C,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,MAAM,CAAC,eAAe,EACtB,kBAAkB,EAClB,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAC5B,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YAEF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,mCAAmC,WAAW,GAAG,CAAC;gBAClE,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;oBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE;iBACpD,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACnC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;gBACnC,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;gBAChC,OAAO,GAAG,CAAC,CAAC,UAAU,iBAAiB,QAAQ,aAAa,KAAK,UAAU,CAAC,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;YACjG,CAAC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,gBAAgB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAE3E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;aAChF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,mCAAmC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACnF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/company-tools.d.ts

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

package/dist/tools/company-tools.js

@@ -0,0 +1,194 @@
+import { z } from "zod";
+import { tables, queryByIndex, scanTable, scanAll, getItem } from "../dynamo.js";
+import { companyEntity, listOutput, getOutput, statsOutput, } from "../schemas.js";
+export function registerCompanyTools(server) {
+    server.registerTool("vantage_companies_search", {
+        description: "Search Vantage companies with optional filters. Returns up to 50 results. Use GSI filters for efficient queries or scan with text filter for fuzzy matching.",
+        inputSchema: {
+            filter: z
+                .string()
+                .optional()
+                .describe("Text filter — matches against company name (scans table, slower)"),
+            tier: z
+                .enum(["enterprise", "large", "mid-market", "smb", "emerging"])
+                .optional()
+                .describe("Filter by tier (uses by-tier GSI)"),
+            status: z
+                .enum([
+                "new",
+                "prospect",
+                "target",
+                "active",
+                "qualified",
+                "engaged",
+                "opportunity",
+                "customer",
+                "churned",
+                "disqualified",
+            ])
+                .optional()
+                .describe("Filter by status (uses by-status GSI)"),
+            client_id: z
+                .string()
+                .optional()
+                .describe("Filter by client ID (uses by-client GSI)"),
+            limit: z.number().optional().default(25).describe("Max results (default 25, max 50)"),
+        },
+        outputSchema: listOutput(companyEntity),
+    }, async ({ filter, tier, status, client_id, limit }) => {
+        try {
+            const cap = Math.min(limit || 25, 50);
+            let items;
+            if (tier) {
+                const result = await queryByIndex(tables.companies, "by-tier", "tier = :t", { ":t": { S: tier } }, { limit: cap, scanForward: false });
+                items = result.items;
+            }
+            else if (status) {
+                const result = await queryByIndex(tables.companies, "by-status", "#s = :s", { ":s": { S: status } }, { limit: cap, scanForward: false, expressionNames: { "#s": "status" } });
+                items = result.items;
+            }
+            else if (client_id) {
+                const result = await queryByIndex(tables.companies, "by-client", "client_id = :c", { ":c": { S: client_id } }, { limit: cap, scanForward: false });
+                items = result.items;
+            }
+            else {
+                const result = await scanTable(tables.companies, { limit: cap });
+                items = result.items;
+            }
+            if (filter) {
+                const lower = filter.toLowerCase();
+                items = items.filter((c) => (c.name || "").toLowerCase().includes(lower) ||
+                    (c.domain || "").toLowerCase().includes(lower));
+            }
+            if (items.length === 0) {
+                const summary = "No companies found.";
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { items: [], count: 0, summary },
+                };
+            }
+            const lines = items.map((c) => {
+                const score = c.lead_score ? ` | score: ${c.lead_score}` : "";
+                const t = c.tier ? ` | ${c.tier}` : "";
+                return `${c.name || c.id}${t}${score}\n  status: ${c.status || "—"} | vertical: ${c.vertical || "—"} | domain: ${c.domain || "—"}`;
+            });
+            const summary = `${items.length} companies:\n\n${lines.join("\n\n")}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    items,
+                    count: items.length,
+                    summary,
+                },
+            };
+        }
+        catch (e) {
+            const summary = `Error searching companies: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { items: [], count: 0, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_company_get", {
+        description: "Get full details for a single Vantage company by ID and vertical",
+        inputSchema: {
+            id: z.string().describe("Company ID (partition key)"),
+            vertical: z.string().describe("Company vertical (sort key)"),
+        },
+        outputSchema: getOutput(companyEntity),
+    }, async ({ id, vertical }) => {
+        try {
+            const item = await getItem(tables.companies, {
+                id: { S: id },
+                vertical: { S: vertical },
+            });
+            if (!item) {
+                const summary = `Company ${id} not found in vertical ${vertical}.`;
+                return {
+                    content: [{ type: "text", text: summary }],
+                    structuredContent: { found: false, summary },
+                };
+            }
+            const summary = JSON.stringify(item, null, 2);
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { found: true, item, summary },
+            };
+        }
+        catch (e) {
+            const summary = `Error fetching company: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { found: false, summary },
+                isError: true,
+            };
+        }
+    });
+    server.registerTool("vantage_companies_stats", {
+        description: "Get aggregate company statistics — counts by tier, status, and vertical",
+        inputSchema: {},
+        outputSchema: statsOutput,
+    }, async () => {
+        try {
+            // Project only the three facets we aggregate on. Smaller pages
+            // come back over the wire faster, and scanAll walks every page
+            // so counts reflect the whole table (not the 1 MB first page).
+            const result = await scanAll(tables.companies, {
+                projectionExpression: "tier, #s, vertical",
+                expressionNames: { "#s": "status" },
+            });
+            const items = result.items;
+            const byTier = {};
+            const byStatus = {};
+            const byVertical = {};
+            for (const c of items) {
+                const tier = c.tier || "unknown";
+                const status = c.status || "unknown";
+                const vertical = c.vertical || "unknown";
+                byTier[tier] = (byTier[tier] || 0) + 1;
+                byStatus[status] = (byStatus[status] || 0) + 1;
+                byVertical[vertical] = (byVertical[vertical] || 0) + 1;
+            }
+            const fmt = (obj) => Object.entries(obj)
+                .sort((a, b) => b[1] - a[1])
+                .map(([k, v]) => `  ${k}: ${v}`)
+                .join("\n");
+            const summary = [
+                `Total companies: ${items.length}${result.truncated ? " (truncated — try narrower scope)" : ""}`,
+                "",
+                "By Tier:",
+                fmt(byTier),
+                "",
+                "By Status:",
+                fmt(byStatus),
+                "",
+                "By Vertical:",
+                fmt(byVertical),
+            ].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    total: items.length,
+                    truncated: result.truncated,
+                    buckets: {
+                        tier: byTier,
+                        status: byStatus,
+                        vertical: byVertical,
+                    },
+                    summary,
+                },
+            };
+        }
+        catch (e) {
+            const summary = `Error fetching stats: ${e.stderr?.trim() || e.message}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: { total: 0, buckets: {}, summary },
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=company-tools.js.map