splera-mcp 0.1.0 → 0.1.2

package/README.md

@@ -45,7 +45,7 @@ Go to [splera.app/settings](https://splera.app/settings), click **Generate new k
 #### Claude Code
 
 ```bash
-claude mcp add splera npx -y splera-mcp --env SPLERA_API_KEY=splera_live_your_key_here
+claude mcp add splera npx -y splera-mcp@latest --env SPLERA_API_KEY=splera_live_your_key_here
 ```
 
 Then restart Claude Code.
@@ -59,7 +59,7 @@ Same JSON shape for both, just different file paths.
   "mcpServers": {
     "splera": {
       "command": "npx",
-      "args": ["-y", "splera-mcp"],
+      "args": ["-y", "splera-mcp@latest"],
       "env": {
         "SPLERA_API_KEY": "splera_live_your_key_here"
       }
@@ -80,7 +80,7 @@ Add to `~/.config/zed/settings.json`:
     "splera": {
       "command": {
         "path": "npx",
-        "args": ["-y", "splera-mcp"],
+        "args": ["-y", "splera-mcp@latest"],
         "env": { "SPLERA_API_KEY": "splera_live_your_key_here" }
       }
     }
@@ -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.0";
+export declare const CURRENT_MCP_VERSION = "0.1.2";

package/dist/config.js

@@ -11,7 +11,7 @@ export function loadConfig() {
         console.error('splera-mcp: SPLERA_API_KEY not set.\n' +
             'Generate a key at https://splera.app/settings.\n' +
             'Your MCP config env block should look like:\n' +
-            '  { "splera": { "command": "npx", "args": ["-y", "splera-mcp"], ' +
+            '  { "splera": { "command": "npx", "args": ["-y", "splera-mcp@latest"], ' +
             '"env": { "SPLERA_API_KEY": "splera_live_..." } } }');
         process.exit(1);
     }
@@ -51,4 +51,4 @@ export function isBelow(current, minimum) {
     }
     return false;
 }
-export const CURRENT_MCP_VERSION = '0.1.0';
+export const CURRENT_MCP_VERSION = '0.1.2';

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/package.json

@@ -1,6 +1,7 @@
 {
   "name": "splera-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "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",
   "bin": {