strategy-mcp 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Strategy MCP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,181 @@
-# Temporary Holding Version
+# Strategy MCP
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version](https://img.shields.io/npm/v/strategy-mcp.svg)](https://www.npmjs.com/package/strategy-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/strategy-mcp.svg)](https://www.npmjs.com/package/strategy-mcp)
+[![license](https://img.shields.io/npm/l/strategy-mcp.svg)](https://github.com/Ritterbeckaj/strategy-mcp/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/strategy-mcp.svg)](https://www.npmjs.com/package/strategy-mcp)
+
+```bash
+npx -y strategy-mcp
+```
+
+Deterministic strategic-planning frameworks as a local MCP server. Runs anywhere
+Node 18+ runs, makes **zero network calls**, and needs **no API keys**.
+
+Four tools are free and MIT-licensed in this repo. Eight more (twelve total) ship
+as [StrategyBrain Pro](#strategybrain-pro).
+
+```
+swot_analysis   marketing_mix   lean_canvas   decision_matrix     ← free (this repo)
+```
+
+## Free tools (MIT)
+
+| Tool | What it actually returns |
+|---|---|
+| `swot_analysis` | S/W/O/T, then **S-O / W-O / S-T / W-T cross-mapping** and 3–5 offensive + defensive actions. Not just the four quadrants. |
+| `marketing_mix` | The 4Ps — product, price, place, promotion — plus the one-line pitch that connects them. |
+| `lean_canvas` | One-page business model: problem → segments → UVP → solution → channels → revenue → costs → metrics → unfair advantage. |
+| `decision_matrix` | Options scored against weighted criteria, ranked, with the margin between winner and runner-up. |
+
+Every tool is a pure function of its input. Same input, same output, no model
+call, no drift between runs, nothing sent anywhere.
+
+## Install
+
+**Requirements:** Node 18 or newer. Nothing to clone, no absolute paths.
+
+The server is on npm, so `npx` fetches and runs it:
+
+```bash
+npx -y strategy-mcp
+```
+
+That speaks MCP over stdio and waits for a client. Or install it once, globally:
+
+```bash
+npm install -g strategy-mcp
+strategy-mcp
+```
+
+Prefer the source? Same four tools:
+
+```bash
+git clone https://github.com/Ritterbeckaj/strategy-mcp.git
+cd strategy-mcp && npm install
+```
+
+### OpenCode
+
+`~/.config/opencode/opencode.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "strategy": {
+        "type": "local",
+        "command": ["npx", "-y", "strategy-mcp@latest"]
+      }
+    }
+  }
+}
+```
+
+Installed globally instead? `"command": ["strategy-mcp"]`.
+
+### Claude Code
+
+```bash
+claude mcp add strategy -- npx -y strategy-mcp@latest
+```
+
+### Claude Desktop / Cursor
+
+Claude Desktop — `claude_desktop_config.json`
+(macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\Claude\`).
+Cursor — `~/.cursor/mcp.json`. Same shape:
+
+```json
+{
+  "mcpServers": {
+    "strategy": {
+      "command": "npx",
+      "args": ["-y", "strategy-mcp@latest"]
+    }
+  }
+}
+```
+
+Building from a local clone instead? Point `command` at `node` and `args` at the
+absolute path of `index.js`.
+
+Restart the client. The four tools appear as `swot_analysis`, `marketing_mix`,
+`lean_canvas`, `decision_matrix`.
+
+Then just ask:
+
+> "Run a SWOT on my print-on-demand merch line and tell me which threat actually kills it."
+
+## Or use the hosted servers (no install)
+
+The same tools — plus FactCheck and LeadGen — run as remote MCP endpoints over
+Streamable HTTP. Useful when you can't install anything locally:
+
+| Server | Endpoint | Tools |
+|---|---|---|
+| StrategyBrain | `https://strategybrain-mcp.factcheck-mcp-worker.workers.dev/mcp` | 12 |
+| FactCheck | `https://factcheck-mcp.factcheck-mcp-worker.workers.dev/mcp` | 7 (6 + `get_usage`) |
+| LeadGen | `https://leadgen-mcp.factcheck-mcp-worker.workers.dev/mcp` | 6 |
+
+Header on every request:
+
+```
+x-api-key: oc_trial_5a4900841684ff7d265ba3028bcb1fcc
+```
+
+That's a **shared public demo key: 100 calls/day across all users**. Fine for
+testing whether it works in your client. If you need a real quota, buy a pack
+and you get your own key.
+
+## What touches the network
+
+READMEs in this category tend to say "fully offline" and stop there. Enumerated
+instead:
+
+| Pack | Tools | Network |
+|---|---|---|
+| StrategyBrain (free 4 here + Pro's 8) | 12 | **none** |
+| Monetize MCP | 8 | **none** |
+| FactCheck MCP | 6 | 4 tools → Wikipedia, Semantic Scholar, optional Google Fact Check. `cross_verify` and `anti_hallucination_protocol` are local. |
+| LeadGen MCP | 6 | 2 tools → DuckDuckGo, plus the page you point it at. `qualify_lead`, `save_lead`, `list_leads`, `draft_outreach` are local. |
+
+**26 of the 32 tools on sale make zero network calls.** Six do, and they call
+free, keyless, read-only public endpoints — no account, no billing, nothing
+written. `GOOGLE_FACTCHECK_API_KEY` is optional; without it the server degrades
+to Wikipedia + Semantic Scholar. When a network call fails, the tool returns
+`UNVERIFIED` rather than inventing a result.
+
+## StrategyBrain Pro
+
+The other eight frameworks, same offline/no-key design:
+
+`porter_five_forces` · `pestle_analysis` · `ansoff_matrix` · `jobs_to_be_done` ·
+`tam_sam_som` · `okr_plan` · `roadmap_plan` · `brainstorm_session`
+
+**[$12 — StrategyBrain Pro](https://ritterbeck.gumroad.com/l/strategybrain-pro)** ·
+**[$29 with a 30-minute setup call](https://ritterbeck.gumroad.com/l/strategybrain-pro)**
+· 30-day refund if it isn't useful.
+
+Free entry point: **[Monetize MCP — 8 tools, $0+](https://ritterbeck.gumroad.com/l/monetize-mcp)**.
+Test the install before paying for anything.
+
+Full set — all four packs, 33 tools:
+**[The MCP Toolkit](https://ritterbeck.gumroad.com/mcp-bundle)** ($29, or $79 with setup).
+
+## Why open-core
+
+The four tools here are the ones that survive being used on their own. The Pro
+pack funds maintenance and the next batch. If the free tools earn it, buy Pro.
+If they don't, you've lost nothing but a `npm install`.
+
+## Publishing your own
+
+MIT — fork it, rename it in `package.json` and in the `McpServer` constructor,
+`npm publish`. If you fork, pick your own package name: `strategy-mcp` is taken
+(as of v0.2.0, by this project).
+
+## License
+
+MIT — see [LICENSE](LICENSE). The Pro tools are proprietary and are not in this
+repository.

package/index.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+/**
+ * Strategy MCP — open-core edition (MIT).
+ *
+ * Free core tools: swot_analysis, marketing_mix, lean_canvas, decision_matrix.
+ *
+ * Pro (8 more frameworks: Porter's Five Forces, PESTLE, Ansoff, Jobs-to-be-Done,
+ * TAM/SAM/SOM, OKR, brainstorm_session, roadmap_plan) is available at:
+ *   https://ritterbeck.gumroad.com (StrategyBrain Pro)
+ * The Pro pack is proprietary and not part of this repository.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const server = new McpServer({ name: "strategy-mcp", version: "0.2.0" });
+
+server.tool(
+  "swot_analysis",
+  "Run a SWOT analysis: strengths, weaknesses, opportunities, threats, then derive 3-5 offensive and defensive strategic actions.",
+  {
+    subject: z.string().describe("What is being analyzed (business, product line, niche, campaign)"),
+    strengths: z.array(z.string()).optional(),
+    weaknesses: z.array(z.string()).optional(),
+    opportunities: z.array(z.string()).optional(),
+    threats: z.array(z.string()).optional(),
+  },
+  async ({ subject, strengths = [], weaknesses = [], opportunities = [], threats = [] }) => {
+    const view = {
+      type: "SWOT",
+      subject,
+      internal: { strengths, weaknesses },
+      external: { opportunities, threats },
+      cross_mapping: [
+        "S-O (attack): use which strength to seize which opportunity?",
+        "W-O (build): what weakness blocks an opportunity, and how to fix it?",
+        "S-T (defend): which strength mitigates which threat?",
+        "W-T (survive): what risk must be neutralized first?",
+      ],
+      output: ["3-5 offensive actions (SO/WO)", "3-5 defensive actions (ST/WT)", "1 top priority per quadrant"],
+    };
+    return json(view);
+  }
+);
+
+server.tool(
+  "lean_canvas",
+  "One-page business model (9 blocks). Provide any 2+ blocks; the template guides completion of the rest.",
+  {
+    name: z.string().describe("Venture / product name"),
+    problem: z.string().optional(),
+    solution: z.string().optional(),
+    key_metrics: z.string().optional(),
+    unique_value_proposition: z.string().optional(),
+    unfair_advantage: z.string().optional(),
+    channels: z.string().optional(),
+    customer_segments: z.string().optional(),
+    cost_structure: z.string().optional(),
+    revenue_streams: z.string().optional(),
+  },
+  async (a) => {
+    const view = {
+      type: "Lean Canvas",
+      name: a.name,
+      canvas: {
+        problem: a.problem ?? "Top 1-3 problems",
+        solution: a.solution ?? "Minimal feature set per problem",
+        key_metrics: a.key_metrics ?? "3 numbers that prove traction",
+        unique_value_proposition: a.unique_value_proposition ?? "Single clear message: why buy",
+        unfair_advantage: a.unfair_advantage ?? "What cannot be copied/bought",
+        channels: a.channels ?? "How you reach customers",
+        customer_segments: a.customer_segments ?? "Who pays (early adopters first)",
+        cost_structure: a.cost_structure ?? "Fixed + variable costs",
+        revenue_streams: a.revenue_streams ?? "Pricing + revenue model",
+      },
+      output: ["Fill every gap", "Flag the riskiest assumption per block", "Design 1 experiment to de-risk the top assumption"],
+    };
+    return json(view);
+  }
+);
+
+server.tool(
+  "decision_matrix",
+  "Score options against weighted criteria to pick objectively. Pass equal-length arrays or leave blank for template.",
+  {
+    question: z.string().describe("The decision to make"),
+    options: z.array(z.string()).optional(),
+    criteria: z.array(z.string()).optional(),
+    weights: z.array(z.number()).optional().describe("Must sum to 1.0; same length as criteria"),
+  },
+  async ({ question, options = [], criteria = [], weights = [] }) => {
+    const view = {
+      type: "Decision matrix",
+      question,
+      table: options.length ? { options, criteria, weights } : {
+        hint: "Fill: options (2-6), criteria (3-6), weights summing to 1.0",
+        sample: { options: ["Option A", "Option B"], criteria: ["Cost", "Speed", "Impact"], weights: [0.4, 0.3, 0.3] },
+      },
+      scoring: "Score each option 1-10 per criterion; total = SUM(score * weight). Highest wins; document why.",
+      output: ["Weighted totals per option", "Sensitivity: swap top-2 weights and recheck", "One decision + contingency"],
+    };
+    return json(view);
+  }
+);
+
+server.tool(
+  "marketing_mix",
+  "4P plan: Product, Price, Place (channels), Promotion, plus the pitch line.",
+  {
+    product: z.string(),
+    target_customer: z.string().optional(),
+    product_offer: z.string().optional(),
+    price: z.string().optional(),
+    place: z.string().optional(),
+    promotion: z.string().optional(),
+  },
+  async ({ product, ...p }) => {
+    const view = {
+      type: "Marketing mix (4Ps)",
+      product,
+      mix: {
+        product_offer: p.product_offer ?? "Features, benefits, packaging, variants",
+        price: p.price ?? "List price, anchor, discounts, perceived value",
+        place: p.place ?? "Channels: store, marketplace, social, email, POD platform",
+        promotion: p.promotion ?? "Hooks per channel + launch sequence (7 days)",
+      },
+      target_customer: p.target_customer ?? "Define 1 persona: who, what problem, where they hang out",
+      output: ["One-sentence pitch", "Launch sequence day-by-day", "3 test creatives to A/B in week 1"],
+    };
+    return json(view);
+  }
+);
+
+
+function json(v) {
+  return { content: [{ type: "text", text: JSON.stringify(v, null, 2) }] };
+}
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "strategy-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "description": "Deterministic strategic-planning frameworks (SWOT, 4Ps, Lean Canvas, decision matrix) as a local MCP server. No API keys, no network calls. Pro unlocks 8 more frameworks.",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "strategy-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "author": "Ritterbeckaj",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ritterbeckaj/strategy-mcp.git"
+  },
+  "homepage": "https://ritterbeck.gumroad.com/l/strategybrain-pro",
+  "bugs": {
+    "url": "https://github.com/Ritterbeckaj/strategy-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "opencode",
+    "strategy",
+    "swot",
+    "lean-canvas",
+    "okr",
+    "business-planning",
+    "offline",
+    "no-api-key"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "smoke": "node scripts/smoke.mjs",
+    "prepublishOnly": "node --check index.js && node scripts/smoke.mjs"
+  }
+}