@firstdistro/mcp 1.1.2 → 1.2.1

package/README.md

@@ -211,8 +211,7 @@ node bin/firstdistro-mcp.js init
 
 ## Support
 
-- Documentation: https://firstdistro.com/docs
-- Issues: https://github.com/firstdistro/mcp/issues
+- Documentation: https://firstdistro.com/documentation
 - Email: support@firstdistro.com
 
 ## License

package/dist/server.js

@@ -1053,6 +1053,99 @@ ${nextStepsOutput}`
       }
     }
   );
+  server.tool(
+    "create_experience",
+    `Create a new customer journey/experience to track user progress through a flow.
+
+You need three things from the user:
+1. A name for the experience (e.g., "Team Onboarding", "Checkout Flow")
+2. What triggers the START \u2014 when does a user enter this journey?
+3. What counts as SUCCESS \u2014 when has the user completed it?
+
+If the user hasn't provided all three, ask follow-up questions before calling this tool.
+
+After creation, help the user add the returned tracking events to their code.`,
+    {
+      name: z.string().describe('Name of the experience (e.g., "Team Onboarding")'),
+      description: z.string().optional().describe("What this journey tracks"),
+      start_event_description: z.string().describe('What triggers the start (e.g., "User visits the team settings page")'),
+      success_event_description: z.string().describe('What counts as completion (e.g., "User successfully invites a team member")')
+    },
+    async ({ name, description, start_event_description, success_event_description }) => {
+      try {
+        const response = await fetch(`${config.baseUrl}/api/vendor/experiences`, {
+          method: "POST",
+          headers: {
+            ...getApiHeaders(config.apiKey),
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({
+            name,
+            description,
+            start_event_description,
+            success_event_description
+          })
+        });
+        if (!response.ok) {
+          const errorData = await response.json().catch(() => ({}));
+          const errorMessage = errorData.error || response.statusText;
+          if (response.status === 409) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `Experience "${name}" already exists. Use list_experiences to see your existing journeys.`
+                }
+              ],
+              isError: true
+            };
+          }
+          return {
+            content: [
+              {
+                type: "text",
+                text: formatHttpError(response.status, errorMessage, `Create experience "${name}"`)
+              }
+            ],
+            isError: true
+          };
+        }
+        const rawData = await response.json();
+        const data = unwrapApiResponse(rawData);
+        const events = data.events || {};
+        const integrationHint = data.integration_hint || "";
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Experience "${data.experience?.name || name}" created successfully!
+
+**Event names to track:**
+- Start: \`${events.start}\`
+- Success: \`${events.success}\`
+
+**Add to your code:**
+${integrationHint}
+
+The experience is now visible in the FirstDistro dashboard at /dashboard/experiences with status "pending" \u2014 it will become "active" once events start flowing.
+
+Use \`check_events_flowing\` after deploying to verify events are arriving.`
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatNetworkError(error)
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
 }
 function registerUnconfiguredTools(server, configError = null) {
   const message = configError ? `FirstDistro configuration error:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@firstdistro/mcp",
-  "version": "1.1.2",
-  "description": "MCP server that brings customer health scores, stuck users, and funnel analytics into Claude, Cursor, and other AI tools — catch churn risks early",
+  "version": "1.2.1",
+  "description": "MCP server for customer success — monitor health scores, detect churn risks, and manage customer journeys from Claude, Cursor, and other AI tools",
   "type": "module",
   "bin": {
     "firstdistro-mcp": "./bin/firstdistro-mcp.js"
@@ -31,6 +31,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "cac": "^6.7.14",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.0.18"
@@ -40,14 +41,21 @@
   },
   "keywords": [
     "mcp",
+    "mcp-server",
     "model-context-protocol",
     "firstdistro",
     "customer-success",
+    "cs-tools",
+    "churn",
+    "health-score",
+    "customer-health",
+    "saas",
     "ai",
     "claude",
+    "cursor",
     "llm"
   ],
   "license": "MIT",
-  "homepage": "https://firstdistro.com/documentation/mcp/overview",
+  "homepage": "https://firstdistro.com/documentation",
   "author": "FirstDistro <support@firstdistro.com>"
 }