@loopops/mcp-server 3.53.0 → 3.55.0

package/dist/index.js

@@ -21,6 +21,7 @@ import { registerAccountCurateTools } from "./tools/account-curate.js";
 import { registerCpqTools } from "./tools/cpq.js";
 import { registerDealPrepTools } from "./tools/deal-prep.js";
 import { registerPlanTools } from "./tools/plan.js";
+import { registerProspectingTools } from "./tools/prospecting.js";
 import { registerSfdcSyncTools } from "./tools/sfdc-sync.js";
 import { registerTalTools } from "./tools/tal.js";
 import { parseSkillModesResponse } from "./skills/loader.js";
@@ -77,6 +78,7 @@ registerCpqTools(server, allowedSkills);
 registerDealPrepTools(server, allowedSkills);
 registerPlanTools(server, allowedSkills);
 registerAccountCurateTools(server, allowedSkills);
+registerProspectingTools(server, allowedSkills);
 // Skills framework — fetch role-visible skills from the Loop API and
 // register each as a server-provided MCP prompt. Surfaces in the
 // client's `/` menu and bundles (system prompt + tool emphasis +

package/dist/tools/prospecting.d.ts

@@ -0,0 +1,19 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Prospecting tools — surface for the `/prospecting` skill.
+ *
+ * The skill bundles two new context/read tools with existing Engage
+ * review tools (my_sequences, review_sequence, approve_sequence,
+ * reject_sequence) + AM context tools (account_show,
+ * walk_account_hierarchy, score_explain).
+ *
+ * NOT YET BUILT: generate_sequence_for_account — manual sequence
+ * generation. The skill's playbook describes how to handle the gap
+ * (defer to Signal Scanner, or ask ops to add account to the
+ * signal_scanner_targets TAL). Lands in a follow-on PR.
+ *
+ * NOT YET BUILT: Gong Engage activation. approve_sequence today
+ * writes to Postgres only; Gong push lands in a separate infra PR
+ * with no UX change required.
+ */
+export declare function registerProspectingTools(server: McpServer, allowed: Set<string>): void;

package/dist/tools/prospecting.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { trpcMutation, trpcQuery } from "../api-client.js";
+import { safeTool } from "./_helpers.js";
+/**
+ * Prospecting tools — surface for the `/prospecting` skill.
+ *
+ * The skill bundles two new context/read tools with existing Engage
+ * review tools (my_sequences, review_sequence, approve_sequence,
+ * reject_sequence) + AM context tools (account_show,
+ * walk_account_hierarchy, score_explain).
+ *
+ * NOT YET BUILT: generate_sequence_for_account — manual sequence
+ * generation. The skill's playbook describes how to handle the gap
+ * (defer to Signal Scanner, or ask ops to add account to the
+ * signal_scanner_targets TAL). Lands in a follow-on PR.
+ *
+ * NOT YET BUILT: Gong Engage activation. approve_sequence today
+ * writes to Postgres only; Gong push lands in a separate infra PR
+ * with no UX change required.
+ */
+export function registerProspectingTools(server, allowed) {
+    if (allowed.has("prospecting_context")) {
+        server.tool("prospecting_context", "Loads Loop's prospecting playbook: four-phase workflow (prioritize → understand → generate → review → activate), prioritization heuristics (ICP weight 0.7 + freshness 0.3 − open-opp/open-sequence penalties), generation guardrails, approval voice, conversation patterns, handoffs to /deal_prep + /cpq_coach + /account_curate. Call ONCE per prospecting conversation. The /prospecting skill auto-loads this on entry.", {}, safeTool(async () => trpcQuery("mcp.prospectingContext")));
+    }
+    if (allowed.has("generate_sequence_for_account")) {
+        server.tool("generate_sequence_for_account", "Generate a draft prospecting email sequence for an account that doesn't have one. Single Sonnet 4.6 call grounded in AM firmographics + rep-provided context. Inserts into engage_sequences with status='draft'; rep reviews via my_sequences / review_sequence / approve_sequence. REFUSES if the account has an open opportunity (use /deal_prep instead) or an existing draft/approved sequence. ~$0.02/call. Always confirm with rep before firing — don't auto-generate on first mention of an account.", {
+            accountIdentifier: z
+                .string()
+                .min(2)
+                .max(200)
+                .describe("Account UUID, primary domain, SF Account Id (001…), or partial name. Must resolve to exactly one account."),
+            context: z
+                .string()
+                .max(2000)
+                .optional()
+                .describe("Optional rep-provided grounding: recent press release, champion mention, observed buying signal, specific use case. Strongly recommended — generic firmographic-only sequences perform poorly."),
+            playId: z
+                .enum(["enterprise_intro", "mid_market_outbound", "fallback_nurture"])
+                .optional()
+                .describe("Override the auto-selected play (default: enterprise_intro if employees ≥500, mid_market_outbound 100-500, else fallback_nurture)."),
+        }, safeTool(async (args) => trpcMutation("mcp.generateSequenceForAccount", args)));
+    }
+    if (allowed.has("prospecting_priorities")) {
+        server.tool("prospecting_priorities", "Rank target accounts in caller's territory for outbound prospecting. Hybrid CH query joining am.account_profile + salesforce.opportunity (excludes open opps) + engage_sequences (flags pending). Scope defaults to caller's own territory; managers can pass 'subtree' or {repId}. Returns top-N markdown table with ICP score + band, owner, why (reason line), and suggested action (Generate or Review existing sequence).", {
+            scope: z
+                .union([
+                z.literal("me"),
+                z.literal("my_team"),
+                z.literal("subtree"),
+                z.object({ repId: z.string().min(1) }),
+                z.object({ managerId: z.string().min(1) }),
+            ])
+                .optional()
+                .describe("Scope: 'me' (default for rep), 'my_team' / 'subtree' (manager+), or explicit {repId}/{managerId}."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Top-N to return. Default 10."),
+            min_icp_score: z
+                .number()
+                .min(0)
+                .max(100)
+                .optional()
+                .describe("Minimum ICP score (0-100). Default 0."),
+        }, safeTool(async (args) => trpcQuery("mcp.prospectingPriorities", args)));
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loopops/mcp-server",
-  "version": "3.53.0",
+  "version": "3.55.0",
   "description": "Loop Operations MCP Server — AI skills for RevOps",
   "license": "UNLICENSED",
   "type": "module",