@opennous/mcp 0.21.0 → 0.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Nous MCP Server — Customer graph for GTM agents.",
   "license": "AGPL-3.0-only",
   "repository": {

package/src/server.js

@@ -30,13 +30,14 @@
  *   list_triggers        — list the workspace's event triggers + available events
  *   lead_list_operations — the operations trail of a lead list (imports/enrich/push/replies), filterable
  *   check_leads          — pre-spend coverage check: which candidates you already own / should re-enrich
+ *   lead_coverage        — attribute coverage estimate ("how many agency founders do we have, by freshness")
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { get, post } from "./client.js";
 
-export const SERVER_VERSION = "0.21.0";
+export const SERVER_VERSION = "0.23.0";
 
 // ─── helpers ──────────────────────────────────────────────────────────────────
 
@@ -520,6 +521,8 @@ export function createServer() {
 
       const ws = s.workspace ?? {};
       lines.push(`WORKSPACE: ${ws.name || "(unnamed)"}${ws.website ? ` · ${ws.website}` : ""}${ws.business_type ? ` · ${ws.business_type}` : ""}`);
+      const pl = s.plan ?? {};
+      lines.push(`PLAN: ${pl.name || pl.id || "free"}${pl.crm_sync === false ? "  (CRM sync not included — do not offer it)" : ""}`);
       lines.push("");
 
       const mark = (b) => (b ? "✓" : "✗");
@@ -529,7 +532,11 @@ export function createServer() {
       const ints = setup.integrations?.connected ?? [];
       lines.push(`  ${mark((setup.integrations?.count ?? 0) > 0)} Integrations (${setup.integrations?.count ?? 0})${ints.length ? `: ${ints.map((i) => i.name).join(", ")}` : ""}`);
       const crm = setup.crm_sync ?? {};
-      lines.push(`  ${mark(crm.configured)} CRM sync${crm.configured ? `: ${(crm.providers ?? []).map((p) => p.provider).join(", ")}` : ""}${crm.pending_hygiene_proposals ? ` · ${crm.pending_hygiene_proposals} hygiene proposal(s) to review` : ""}`);
+      if (crm.available === false) {
+        lines.push(`  – CRM sync (not on the ${pl.name || pl.id || "current"} plan)`);
+      } else {
+        lines.push(`  ${mark(crm.configured)} CRM sync${crm.configured ? `: ${(crm.providers ?? []).map((p) => p.provider).join(", ")}` : ""}${crm.pending_hygiene_proposals ? ` · ${crm.pending_hygiene_proposals} hygiene proposal(s) to review` : ""}`);
+      }
       lines.push(`  ${mark(setup.enrichment?.connected)} Enrichment${setup.enrichment?.provider ? `: ${setup.enrichment.provider}` : ""}`);
       lines.push(`  ${mark((setup.webhooks?.count ?? 0) > 0 || (setup.triggers?.count ?? 0) > 0)} Events — ${setup.webhooks?.count ?? 0} webhook(s), ${setup.triggers?.count ?? 0} trigger(s)`);
 
@@ -606,7 +613,10 @@ export function createServer() {
     "update_gtm_profile, then call this to translate that context into a weighted set of scoring " +
     "signals so accounts get scored for fit. If a model already exists it is left alone unless you " +
     "pass force:true (use that when the GTM context has changed and the model should be rebuilt). If " +
-    "it reports no GTM context yet, record some with update_gtm_profile first, then call this again.",
+    "it reports no GTM context yet, record some with update_gtm_profile first, then call this again. " +
+    "When building the playbook during onboarding, also ASK the user for a few closed-WON customer " +
+    "domains and closed-LOST domains — real outcomes sharpen the ICP. Record them with update_gtm_profile " +
+    "(e.g. section 'ICP': 'Closed-won: acme.com, globex.com; closed-lost: tinyco.io') so the model reflects who actually buys.",
     {
       force: z.boolean().optional()
         .describe("Rebuild the model even if one already exists — use when the GTM context has changed."),
@@ -867,5 +877,46 @@ export function createServer() {
     }
   );
 
+  // ===========================================================================
+  // TOOL: lead_coverage  —  GET /v2/people/coverage
+  // The attribute-based planning check: "how many <agency founders> do we already
+  // have, and how fresh?" — answered WITHOUT pasting identifiers. Use it before
+  // building a list elsewhere to see how much you already cover.
+  // ===========================================================================
+  server.tool(
+    "lead_coverage",
+    "Estimate how many people you ALREADY have matching a role/keyword, bucketed by enrichment " +
+    "freshness — the planning question before building a list (no identifiers to paste). E.g. " +
+    "title='founder', keyword='agency' → how many agency founders are already in your workspace, " +
+    "how many were never enriched or are stale (>90d, so re-enrich), and how many have a fresh " +
+    "verified email. Rough by design (title is precise; keyword matches title/company/department). " +
+    "For an exact net-new check against specific candidates, use check_leads with their identifiers.",
+    {
+      title: z.string().optional().describe("Role match, e.g. 'founder', 'VP Sales' (matches job_title)."),
+      keyword: z.string().optional().describe("Extra match across title/company/department, e.g. 'agency'."),
+      stale_days: z.number().optional().describe("Days after which enrichment counts as stale (default 90)."),
+    },
+    async ({ title, keyword, stale_days }) => {
+      if (!title && !keyword) {
+        return { content: [{ type: "text", text: "Pass a title and/or keyword, e.g. title='founder', keyword='agency'." }] };
+      }
+      const r = await get("/v2/people/coverage", { title, keyword, stale_days });
+      const lines = [
+        `COVERAGE — ${[title && `title~"${title}"`, keyword && `keyword~"${keyword}"`].filter(Boolean).join(" + ")}`,
+        `  ${r.total ?? 0} already in your workspace`,
+        `    ${r.needs_enrichment ?? 0} need (re-)enrichment  (${r.never_enriched ?? 0} never enriched · ${r.stale ?? 0} stale >90d)`,
+        `    ${r.fresh_verified ?? 0} have a fresh verified email`,
+      ];
+      const sample = r.sample || [];
+      if (sample.length) {
+        lines.push("", "SAMPLE (oldest first):");
+        for (const s of sample.slice(0, 12)) {
+          lines.push(`  ${[s.job_title, s.company].filter(Boolean).join(" @ ") || s.entity_id}  [${s.enriched_at ? `enriched ${relAge(s.enriched_at)}` : "never enriched"}]`);
+        }
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+
   return server;
 }