@loopops/mcp-server 3.12.0 → 3.14.0

package/dist/index.js

@@ -9,6 +9,7 @@ import { trpcQuery } from "./api-client.js";
 import { registerIdentityTools } from "./tools/identity.js";
 import { registerReportingTools } from "./tools/reporting.js";
 import { registerConfigTools } from "./tools/config.js";
+import { registerDeployTools } from "./tools/deploy.js";
 import { registerEngTools } from "./tools/eng.js";
 import { registerCrmTools } from "./tools/crm.js";
 import { registerEngageTools } from "./tools/engage.js";
@@ -60,6 +61,7 @@ registerCrmTools(server, allowedSkills);
 registerEngageTools(server, allowedSkills);
 registerAccountMasterTools(server, allowedSkills);
 registerPeopleMasterTools(server, allowedSkills);
+registerDeployTools(server, allowedSkills);
 registerTalTools(server, allowedSkills);
 registerScoringTools(server, allowedSkills);
 registerSfdcSyncTools(server, allowedSkills);

package/dist/tools/deploy.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Deploy — placement-pipeline MCP tools (ops+).
+ *
+ * Phase 1.2 (this file) ships the first user-placement tool:
+ *   propose_user_assignments — run the Python placement model on Modal,
+ *                              persist proposals against an open
+ *                              planning_cycle. See docs/DEPLOY-PLAN.md.
+ *
+ * The review/edit/approve/commit triplet (Phase 1.3–1.5) lands here too
+ * as it ships. Quota + account placement (Phases 2–3) get separate
+ * groups on top.
+ *
+ * tRPC procedures live in packages/api/src/routers/mcp.ts; input schemas
+ * in packages/api/src/routers/mcp-schemas.ts.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDeployTools(server: McpServer, allowed: Set<string>): void;

package/dist/tools/deploy.js

@@ -0,0 +1,54 @@
+/**
+ * Deploy — placement-pipeline MCP tools (ops+).
+ *
+ * Phase 1.2 (this file) ships the first user-placement tool:
+ *   propose_user_assignments — run the Python placement model on Modal,
+ *                              persist proposals against an open
+ *                              planning_cycle. See docs/DEPLOY-PLAN.md.
+ *
+ * The review/edit/approve/commit triplet (Phase 1.3–1.5) lands here too
+ * as it ships. Quota + account placement (Phases 2–3) get separate
+ * groups on top.
+ *
+ * tRPC procedures live in packages/api/src/routers/mcp.ts; input schemas
+ * in packages/api/src/routers/mcp-schemas.ts.
+ */
+import { z } from "zod";
+import { trpcMutation } from "../api-client.js";
+import { safeTool } from "./_helpers.js";
+export function registerDeployTools(server, allowed) {
+    if (allowed.has("propose_user_assignments")) {
+        server.tool("propose_user_assignments", [
+            "Run the user-placement model for an open planning cycle. The",
+            "model walks the active scenario's roster + the current",
+            "config/deploy/assignments.yaml and emits one proposal row per AE",
+            "across three kinds: 'assign' (planned hire onto a new territory),",
+            "'ratify' (existing AE staying put), 'depart' (AE in",
+            "assignments.yaml but not in the roster — will be removed at",
+            "commit). Patches in hierarchy.yaml not covered by any",
+            "assign/ratify proposal surface as 'uncovered territories'",
+            "warnings. Re-running on the same cycle supersedes the prior set",
+            "of proposals — the partial unique index keeps only one active",
+            "proposal per (cycle, user). Pass dryRun:true to preview the",
+            "model output without writing to the proposal table.",
+        ].join(" "), {
+            planningCycleId: z
+                .string()
+                .uuid()
+                .optional()
+                .describe("Planning cycle to write proposals against. Defaults to the org's currently-open cycle if exactly one exists; if multiple open or none, the call returns an error listing the cycles found."),
+            scenarioId: z
+                .string()
+                .optional()
+                .describe("Override which scenario to load (e.g. 'stretch'). Default: 'base'. Must exist in config/design/scenarios/."),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("Run the model and return proposals without persisting. Useful for previewing what the model would emit before committing to a cycle. Default: false."),
+            branch: z
+                .string()
+                .optional()
+                .describe("Git branch to read configs from. Default: main."),
+        }, safeTool(async (input) => trpcMutation("mcp.proposeUserAssignments", input)));
+    }
+}

package/dist/tools/people-master.js

@@ -142,6 +142,33 @@ export function registerPeopleMasterTools(server, allowed) {
             return trpcMutation("mcp.importPeopleCsv", { csv, ...rest });
         }));
     }
+    if (allowed.has("notify_activity_capture")) {
+        server.tool("notify_activity_capture", [
+            "Send the one-time privacy notification email to cro_org members whose meeting",
+            "metadata is being captured. Defaults to dryRun: true so the operator previews the",
+            "recipient list before committing. Idempotent — re-running drains only un-notified",
+            "persons. Required step before flipping the activity-capture cron from disabled to",
+            "enabled in config/govern/schedules.yaml.",
+        ].join(" "), {
+            walkId: z
+                .string()
+                .optional()
+                .describe("Walk id from config/people_master/hierarchy_walks.yaml. Default: 'cro_org'."),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("When true (default), returns the would-be recipients without sending. Pass false to actually send."),
+            personIds: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Restrict to a specific subset of person ids (e.g. for a test send before broadcast). Empty = full walk."),
+            privacyDocUrl: z
+                .string()
+                .url()
+                .optional()
+                .describe("Optional 'Learn more' URL surfaced as a button in the email body. Omit to hide."),
+        }, safeTool(async (input) => trpcMutation("mcp.notifyActivityCapture", input)));
+    }
     if (allowed.has("sync_people_master_resolution_rules")) {
         server.tool("sync_people_master_resolution_rules", [
             "Apply the committed config/people_master/resolution_rules.yaml to the DB.",

package/package.json

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