@loopops/mcp-server 2.1.0 → 2.4.0

package/dist/tools/config.js

@@ -151,6 +151,162 @@ export function registerConfigTools(server, allowed) {
                 .describe("Git branch to read from and write back to. Default: main. Writing to main = live promotion."),
         }, safeTool(async ({ scenarioId, dryRun, branch }) => trpcMutation("mcp.promoteScenario", { scenarioId, dryRun, branch })));
     }
+    if (allowed.has("gap_analysis")) {
+        server.tool("gap_analysis", "Use a Claude agent to find the smallest change set that closes a scenario's capacity gap on the target measure. The agent iterates simulate_capacity calls (mutating roster + target_productivity in memory, calling the existing /capacity endpoint) up to a budget cap, then submits a structured proposal. Writes the converged proposal as a draft scenario at `config/plan/scenarios/proposed-gap-{measure}-{ts}.yaml` (override with `writeFile: false`). Use `compare_scenarios` to verify the proposal, then `promote_scenario` to make it active.", {
+            scenarioId: z
+                .string()
+                .describe("Scenario whose capacity gap to close (e.g. 'stretch'). Must exist in config/plan/scenarios/ and be complete."),
+            targetMeasure: z
+                .string()
+                .default("new_acv")
+                .describe("Measure id whose gap to close. Default: 'new_acv'. Other options: 'new_arr', 'new_logo_volume', 'new_logo_acv'."),
+            targetTerritory: z
+                .string()
+                .optional()
+                .describe("Optional territory slug to focus on (e.g. 'ams'). If omitted, agent closes the org-wide gap (sum across all territories for the measure)."),
+            maxNewHires: z
+                .number()
+                .int()
+                .nonnegative()
+                .default(20)
+                .describe("Max new planned-hire rows the agent may propose. Default: 20."),
+            maxProductivityBumpPct: z
+                .number()
+                .nonnegative()
+                .default(20)
+                .describe("Max % bump on any (profile, segment, measure) target productivity vs. base. Default: 20."),
+            maxIterations: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .default(5)
+                .describe("Max simulate_capacity calls before the agent must submit. Default: 5. Hard cap: 20."),
+            writeFile: z
+                .boolean()
+                .default(true)
+                .describe("When true (default), commit the proposal as a draft scenario. Pass false to inspect inline only."),
+            branch: z
+                .string()
+                .optional()
+                .describe("Git branch to read from and (if writeFile) write to. Default: main."),
+        }, safeTool(async ({ scenarioId, targetMeasure, targetTerritory, maxNewHires, maxProductivityBumpPct, maxIterations, writeFile, branch, }) => trpcMutation("mcp.gapAnalysis", {
+            scenarioId,
+            targetMeasure,
+            targetTerritory,
+            maxNewHires,
+            maxProductivityBumpPct,
+            maxIterations,
+            writeFile,
+            branch,
+        })));
+    }
+    if (allowed.has("scenario_what_if")) {
+        server.tool("scenario_what_if", "Apply operator-specified changes to a scenario (added hires, shifted dates, productivity changes — increases OR decreases) and render a side-by-side per-measure delta vs. the source. Single capacity simulation, no agent loop. Use this when YOU know the change and want to evaluate it; use `gap_analysis` when you want the agent to find the change. By default, exploratory only — pass `writeFile:true` to materialize as a draft scenario.", {
+            scenarioId: z
+                .string()
+                .describe("Source scenario id (e.g. 'base'). Must exist and be complete."),
+            addHires: z
+                .array(z.object({
+                id: z.string(),
+                profile_ref: z.enum(["acquisition", "expansion", "hybrid"]),
+                segment_ref: z.string(),
+                territory_slug: z.string(),
+                start_date: z.string(),
+                notes: z.string().optional(),
+            }))
+                .default([])
+                .describe("New planned-hire rows to append to the roster."),
+            shiftHireDates: z
+                .array(z.object({ hire_id: z.string(), new_start_date: z.string() }))
+                .default([])
+                .describe("Move existing planned hires to new start dates."),
+            bumpProductivity: z
+                .array(z.object({
+                profile: z.enum(["acquisition", "expansion", "hybrid"]),
+                segment: z.string(),
+                measure: z.string(),
+                new_value: z.number(),
+            }))
+                .default([])
+                .describe("Override default target productivity for (profile, segment, measure) cells. Increases OR decreases — useful for sensitivity ('what if Hybrid productivity dropped 10%?')."),
+            label: z
+                .string()
+                .optional()
+                .describe("Optional short label for the what-if (e.g. 'add-1-ams-q2'). Used in the proposed scenario filename when writeFile=true. Filesystem-unsafe characters are stripped."),
+            measureIds: z
+                .array(z.string())
+                .optional()
+                .describe("Filter the comparison output to a subset of measures. Default: all target_settable measures."),
+            writeFile: z
+                .boolean()
+                .default(false)
+                .describe("When true, write the modified scenario as a draft for compare_scenarios + promote_scenario. Default: false (exploratory)."),
+            branch: z
+                .string()
+                .optional()
+                .describe("Git branch to read from and (if writeFile) write to. Default: main."),
+        }, safeTool(async ({ scenarioId, addHires, shiftHireDates, bumpProductivity, label, measureIds, writeFile, branch, }) => trpcMutation("mcp.scenarioWhatIf", {
+            scenarioId,
+            addHires,
+            shiftHireDates,
+            bumpProductivity,
+            label,
+            measureIds,
+            writeFile,
+            branch,
+        })));
+    }
+    if (allowed.has("opportunity_search")) {
+        server.tool("opportunity_search", "Use a Claude agent to find the deployment of a fixed budget that maximizes capacity gain on a target measure. Sibling to gap_analysis with opposite objective: where gap_analysis closes a gap to zero, opportunity_search maximizes upside under a budget constraint. Same tool surface (simulate_capacity + submit_final_proposal). Writes the agent's best deployment as a draft scenario at `config/plan/scenarios/proposed-opportunity-{measure}-{ts}.yaml` (override with `writeFile: false`). Use `compare_scenarios` to verify, then `promote_scenario` to make it active.", {
+            scenarioId: z
+                .string()
+                .describe("Source scenario id (e.g. 'base'). Must exist and be complete."),
+            targetMeasure: z
+                .string()
+                .default("new_acv")
+                .describe("Measure id to maximize. Default: 'new_acv'. Other options: 'new_arr', 'new_logo_volume', 'new_logo_acv'."),
+            targetTerritory: z
+                .string()
+                .optional()
+                .describe("Optional territory slug to focus on. If omitted, agent maximizes org-wide capacity for the measure."),
+            maxNewHires: z
+                .number()
+                .int()
+                .nonnegative()
+                .default(20)
+                .describe("Max new planned-hire rows the agent may propose. Budget is at-most — agent may underspend if extra hires don't materially help. Default: 20."),
+            maxProductivityBumpPct: z
+                .number()
+                .nonnegative()
+                .default(20)
+                .describe("Max % bump on any (profile, segment, measure) target productivity vs. base. Increases only — decreases reduce capacity. Default: 20."),
+            maxIterations: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .default(5)
+                .describe("Max simulate_capacity calls before the agent must submit. Default: 5. Hard cap: 20."),
+            writeFile: z
+                .boolean()
+                .default(true)
+                .describe("When true (default), commit the deployment as a draft scenario. Pass false to inspect inline only."),
+            branch: z
+                .string()
+                .optional()
+                .describe("Git branch to read from and (if writeFile) write to. Default: main."),
+        }, safeTool(async ({ scenarioId, targetMeasure, targetTerritory, maxNewHires, maxProductivityBumpPct, maxIterations, writeFile, branch, }) => trpcMutation("mcp.opportunitySearch", {
+            scenarioId,
+            targetMeasure,
+            targetTerritory,
+            maxNewHires,
+            maxProductivityBumpPct,
+            maxIterations,
+            writeFile,
+            branch,
+        })));
+    }
     if (allowed.has("preview_routing")) {
         server.tool("preview_routing", "Simulate Route loop resolution for a hypothetical lead. Walks config/route/rules.yaml, dispatches to territory/pool/queue/user/target_account handler, and returns the resolved owner + audit trail. Useful for testing rule changes before merging. Requires at least billing geography or email.", {
             email: z.string().optional().describe("Lead email — also extracts the domain for target_account lookup."),

package/package.json

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