splera-mcp 0.1.1 → 0.1.3

package/README.md

@@ -138,9 +138,13 @@ You've hit your plan's monthly experiment cap. Options: [upgrade](https://splera
 The SDK isn't reaching the page being tested. Verify the script tag is in place:
 
 ```html
-<script src="https://splera.app/sdk/splera.js" data-experiment-id="YOUR-EXPERIMENT-UUID" async></script>
+<script src="https://splera.app/sdk/splera.js"
+        data-experiment="YOUR-EXPERIMENT-UUID"
+        data-api-url="https://splera.app"></script>
 ```
 
+`data-api-url` is required: without it the SDK tracks nothing. If your experiment was created with splera-mcp 0.1.1, its install code was missing this attribute and used a callback form of `getVariant` that never runs. Re-copy the snippet from the experiment page on the dashboard.
+
 Also confirm the page is receiving real traffic. The dashboard shows live exposure counts at [splera.app/experiments/:id](https://splera.app).
 
 ### Agent doesn't use the Splera tool even when I ask

package/dist/config.d.ts

@@ -17,4 +17,4 @@ export declare function loadConfig(): Config;
  * Pre-release / build metadata is NOT supported — we don't ship those for MCP.
  */
 export declare function isBelow(current: string, minimum: string): boolean;
-export declare const CURRENT_MCP_VERSION = "0.1.1";
+export declare const CURRENT_MCP_VERSION = "0.1.3";

package/dist/config.js

@@ -51,4 +51,4 @@ export function isBelow(current, minimum) {
     }
     return false;
 }
-export const CURRENT_MCP_VERSION = '0.1.1';
+export const CURRENT_MCP_VERSION = '0.1.3';

package/dist/installSnippet.d.ts

@@ -0,0 +1,4 @@
+export declare function buildInstallSnippet(experimentId: string, variants: {
+    id: string;
+    name: string;
+}[], primaryEventName: string, decisionMode: string): string;

package/dist/installSnippet.js

@@ -0,0 +1,32 @@
+/**
+ * The install snippet create_experiment hands the agent. MUST match the web
+ * dashboard's `buildScriptTag` (packages/web/src/pages/experiments/lib/
+ * installPrompts.ts) — the SDK reads `data-experiment` + `data-api-url` from
+ * the tag and `getVariant(id, variantIds)` returns the variant synchronously.
+ * 0.1.1 shipped a callback form + no data-api-url, so nothing was tracked.
+ * Guarded by __tests__/installSnippet.test.ts.
+ */
+const SDK_URL = 'https://splera.app/sdk/splera.js';
+const API_URL = 'https://splera.app';
+// Same rule as the web builder (Codex #23): code literals JSON-encoded, prose one line.
+const inline = (s) => s.replace(/[\u0000-\u001f\u007f]+/g, ' ').trim();
+export function buildInstallSnippet(experimentId, variants, primaryEventName, decisionMode) {
+    const branches = variants
+        .map((v, i) => {
+        const keyword = i === 0 ? 'if' : '} else if';
+        return `  ${keyword} (variant === ${JSON.stringify(v.id)}) {\n    // Show ${inline(v.name)}`;
+    })
+        .join('\n');
+    return `<script src="${SDK_URL}"
+        data-experiment="${experimentId}"
+        data-api-url="${API_URL}"${decisionMode === 'bandit' ? '\n        data-decision-mode="bandit"' : ''}></script>
+
+<script>
+  const variant = Splera.getVariant("${experimentId}", ${JSON.stringify(variants.map((v) => v.id))});
+${branches}
+  }
+
+  // Call this when the conversion event happens:
+  Splera.track(${JSON.stringify(primaryEventName)});
+</script>`;
+}

package/dist/tools/createExperiment.js

@@ -1,4 +1,5 @@
 import { apiFetch, apiUrl } from '../apiClient.js';
+import { buildInstallSnippet } from '../installSnippet.js';
 /**
  * Mirror of `packages/web/src/pages/experiments/lib/createExperiment.ts#variantId`.
  * Duplicated rather than imported because @splera/shared doesn't export it and
@@ -126,14 +127,10 @@ export const createExperimentTool = {
             `ID: ${exp.id}\n` +
             `Variants:\n${variantLines}\n` +
             `Primary metric: ${primaryMetric.event_name} (goal: ${primaryMetric.goal})\n\n` +
-            `To activate, add this to your site's <head>:\n` +
-            `<script src="https://splera.app/sdk/splera.js" data-experiment-id="${exp.id}" async></script>\n\n` +
-            `Then wrap the element you want to vary:\n` +
-            `Splera.getVariant('${exp.id}', (variant) => {\n` +
-            `  if (variant === 'variant_b') document.querySelector('#cta').textContent = '${variants[1]?.name ?? 'Variant B'}';\n` +
-            `});\n\n` +
-            `Track conversions:\n` +
-            `Splera.track('${primaryMetric.event_name}');\n\n` +
+            `Add this to the page (the first <script> in <head>, the second where the element renders),\n` +
+            `then put each variant's UI in its branch and move Splera.track() to the moment the conversion happens:\n\n` +
+            buildInstallSnippet(exp.id, variants, primaryMetric.event_name, body.decision_mode) +
+            `\n\nThe SDK is permanent: keep it installed after the test ends.\n\n` +
             `View live results: ${resultsUrl}`;
         // Structured JSON block. CRITICAL: agents parse this, not the prose.
         // `apiUrl` from config isn't substituted into results_url because the
@@ -152,6 +149,7 @@ export const createExperimentTool = {
                 goal: primaryMetric.goal,
             },
             sdk_script_url: 'https://splera.app/sdk/splera.js',
+            install_snippet: buildInstallSnippet(exp.id, variants, primaryMetric.event_name, body.decision_mode),
             results_url: resultsUrl,
             api_url: apiUrl,
         };

package/dist/tools/shipWinner.js

@@ -44,10 +44,13 @@ export const shipWinnerTool = {
             `Guard window: ${exp.guard_window_days} days (until ${guardWindowEndsDate}).\n` +
             `  - Use get_results to monitor for degradation.\n` +
             `  - If the live rate drops below baseline past the alert threshold, you'll get an email alert.\n` +
-            `  - Rollback is manual only (dashboard): ${resultsUrl}\n\n` +
-            `Next step (optional): when you're confident the winner is stable, hardcode it\n` +
-            `into your codebase and remove the Splera script tag. The dashboard will walk\n` +
-            `you through it.`;
+            `  - Roll back in one click from the dashboard: ${resultsUrl}\n` +
+            `  - On Pro, turn on auto-rollback in Settings to roll back automatically on a drop.\n\n` +
+            `Keep the Splera <script> tag installed: it is how this ship (and any rollback)\n` +
+            `reaches the site, and it runs future experiments.\n\n` +
+            `Next step (optional): once the winner is stable, hardcode it and remove only this\n` +
+            `experiment's getVariant branches and track() calls. The dashboard's Finalize step\n` +
+            `walks you through it.`;
         // Flatten to the spec's ShipResponse shape in the JSON block.
         const shipResponse = {
             winning_variant_id: exp.winning_variant_id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "splera-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "mcpName": "io.github.sohaibt/splera",
   "description": "Model Context Protocol (MCP) server for Splera — A/B testing for vibe coders. Create experiments, check results, and ship winners directly from your AI coding agent.",
   "type": "module",