@aioproductoscom/mcp 0.7.0 → 0.8.0

package/README.md

@@ -52,6 +52,7 @@ at a self-hosted platform.
 | `get_product_brain` | a grounded read-only snapshot of your product (revenue, accounts, web + product analytics, features, signals, open work) |
 | `analyze_funnel` | build an ordered conversion funnel from your events (users per step, conversion, drop-off); omit steps to list available events |
 | `get_retention` | weekly cohort retention — who comes back, week over week |
+| `analyze_paths` | user paths (Sankey) — what people do after a start event, with drop-off |
 | `list_conversations` | the support-chat inbox (open threads, visitor, topic, status) |
 | `get_conversation` | one support thread + its full message history |
 | `reply_to_conversation` | reply to a visitor (**visible in their chat widget**, sent as you) |

package/dist/client.js

@@ -81,6 +81,17 @@ export class PlatformClient {
         const qs = p.toString();
         return this.req(`/api/me/retention${qs ? `?${qs}` : ""}`);
     }
+    paths(opts) {
+        const p = new URLSearchParams();
+        if (opts.productId)
+            p.set("product_id", opts.productId);
+        if (opts.window)
+            p.set("window", String(opts.window));
+        if (opts.start)
+            p.set("start", opts.start);
+        const qs = p.toString();
+        return this.req(`/api/me/paths${qs ? `?${qs}` : ""}`);
+    }
     listConversations(opts) {
         const p = new URLSearchParams();
         if (opts.productId)

package/dist/index.js

@@ -17,7 +17,7 @@ function text(data) {
         ],
     };
 }
-const server = new McpServer({ name: "productos", version: "0.7.0" }, {
+const server = new McpServer({ name: "productos", version: "0.8.0" }, {
     instructions: "You manage ProductOS PM tickets on behalf of the connected member — the board is the team's " +
         "source of truth, so work precisely. Resolve names to ids with pm_meta before create_task / " +
         "update_task; never guess an id. Link a task to the spine (feature_id / insight_id) whenever the " +
@@ -57,6 +57,11 @@ server.tool("analyze_funnel", "Build a conversion funnel from the product's own
     window_days: z.number().optional(),
 }, async (a) => text(await client.funnel({ steps: a.steps, productId: a.product_id, window: a.window_days })));
 server.tool("get_retention", "Weekly cohort retention for the product: users grouped by their first-seen week, with the share returning each week after. Optional product_id (defaults to the primary product) and window_days (default 56 = 8 weekly cohorts).", { product_id: z.string().optional(), window_days: z.number().optional() }, async (a) => text(await client.retention({ productId: a.product_id, window: a.window_days })));
+server.tool("analyze_paths", "Trace what users do AFTER a start event — the journey flow (Sankey) from the product's own events, so YOU can reason about real behaviour on your model. Returns nodes (the event at each depth, with distinct users + share of journeys) and links (source→target with how many users took that step), including where people drop off ('(exit)') and the collapsed long tail ('(other)'). Pass `start` to anchor on a specific event, or omit it to anchor on the most common journey start. Optional product_id (defaults to the primary product) and window_days (default 30).", {
+    start: z.string().optional(),
+    product_id: z.string().optional(),
+    window_days: z.number().optional(),
+}, async (a) => text(await client.paths({ start: a.start, productId: a.product_id, window: a.window_days })));
 server.tool("list_conversations", "List support-chat conversations in the inbox (open + snoozed by default; pass status='all' to include closed). Each has id, visitor, topic, status, and last activity. Optional product_id to scope to one product.", { product_id: z.string().optional(), status: z.enum(["all"]).optional() }, async (a) => text(await client.listConversations({ productId: a.product_id, status: a.status })));
 server.tool("get_conversation", "Read one support conversation: the visitor + the full message thread (visitor, agent, and internal notes), oldest first.", { conversation_id: z.string() }, async (a) => text(await client.getConversation(a.conversation_id)));
 server.tool("reply_to_conversation", "Send a reply into a support conversation. This message IS VISIBLE TO THE VISITOR in the chat widget — it goes out as you (the member who owns this token). Use add_note for internal triage you don't want the visitor to see.", { conversation_id: z.string(), body: z.string() }, async (a) => text(await client.inboxAction({ action: "reply", conversation_id: a.conversation_id, body: a.body })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aioproductoscom/mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "ProductOS MCP — manage tickets, read your product brain + analytics, and run the support inbox from Claude Code, Cursor, Codex, and any MCP host.",
   "type": "module",
   "license": "MIT",