@seldonframe/mcp 1.57.0 → 1.58.0

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "@seldonframe/mcp",
-  "version": "1.57.0",
-  "mcpName": "io.github.seldonframe/seldonframe-mcp",
-  "description": "Open-source GoHighLevel alternative for agencies. 146+ MCP tools that let Claude Code spin up white-labeled client workspaces — CRM, booking, intake forms, landing pages, AI chatbot, and pre-wired agent archetypes (speed-to-lead, missed-call-text-back, review-requester) — in minutes. AGPL-3.0.",
-  "license": "AGPL-3.0-or-later",
-  "type": "module",
-  "bin": {
-    "seldonframe-mcp": "src/index.js"
-  },
-  "files": [
-    "src",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "start": "node src/index.js",
-    "check:syntax": "node --check --input-type=module < src/index.js && node --check --input-type=module < src/client.js && node --check --input-type=module < src/tools.js && node --check --input-type=module < src/welcome.js",
-    "prepublishOnly": "npm run check:syntax"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "seldonframe",
-    "ai",
-    "agents",
-    "business-os",
-    "claude-code",
-    "crm",
-    "gohighlevel-alternative",
-    "gohighlevel",
-    "agency",
-    "whitelabel",
-    "partner-agency",
-    "booking",
-    "intake-form",
-    "landing-page",
-    "local-service-business",
-    "sms",
-    "twilio",
-    "ai-receptionist",
-    "ai-chatbot",
-    "missed-call"
-  ],
-  "homepage": "https://seldonframe.com",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/seldonframe/seldonframe",
-    "directory": "skills/mcp-server"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@seldonframe/mcp",
+  "version": "1.58.0",
+  "mcpName": "io.github.seldonframe/seldonframe-mcp",
+  "description": "Open-source GoHighLevel alternative for agencies. 146+ MCP tools that let Claude Code spin up white-labeled client workspaces — CRM, booking, intake forms, landing pages, AI chatbot, and pre-wired agent archetypes (speed-to-lead, missed-call-text-back, review-requester) — in minutes. AGPL-3.0.",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "bin": {
+    "seldonframe-mcp": "src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "check:syntax": "node --check --input-type=module < src/index.js && node --check --input-type=module < src/client.js && node --check --input-type=module < src/tools.js && node --check --input-type=module < src/welcome.js",
+    "prepublishOnly": "npm run check:syntax"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "seldonframe",
+    "ai",
+    "agents",
+    "business-os",
+    "claude-code",
+    "crm",
+    "gohighlevel-alternative",
+    "gohighlevel",
+    "agency",
+    "whitelabel",
+    "partner-agency",
+    "booking",
+    "intake-form",
+    "landing-page",
+    "local-service-business",
+    "sms",
+    "twilio",
+    "ai-receptionist",
+    "ai-chatbot",
+    "missed-call"
+  ],
+  "homepage": "https://seldonframe.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seldonframe/seldonframe.git",
+    "directory": "skills/mcp-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/finalize-summary.js

@@ -15,9 +15,16 @@
  * @param {string|null} args.aestheticArchetype — workspace's classified
  *   archetype (from snapshot.theme.aestheticArchetype). Used in the
  *   closing landing-page nudge.
+ * @param {string|null} [args.adminUrl] — bearer-token-scoped admin URL
+ *   (built in tools.js as `${appHost}/admin/${workspaceId}?token=${bearer}`,
+ *   same variable the welcome-email path already uses). Takes priority
+ *   over snapshot.ops_stack.admin_url, which is tokenless (the snapshot
+ *   endpoint has no bearer to mint one) and 404s at /admin/invalid if
+ *   printed as-is. Falls back to the tokenless value only if omitted, so
+ *   existing callers that don't pass it keep working.
  * @returns {string} the formatted operator summary
  */
-export function buildFinalizeSummary({ snapshot, durationSec, aestheticArchetype }) {
+export function buildFinalizeSummary({ snapshot, durationSec, aestheticArchetype, adminUrl = null }) {
   const ws = snapshot.workspace ?? {};
   const businessName = ws.name ?? "Your workspace";
   const chatbot = snapshot.chatbot ?? null;
@@ -57,7 +64,10 @@ export function buildFinalizeSummary({ snapshot, durationSec, aestheticArchetype
   // Ops stack URLs
   lines.push(`📅 Booking: ${opsStack.booking_url ?? snapshot.public_urls?.book ?? ""}`);
   lines.push(`📝 Intake:  ${opsStack.intake_url ?? snapshot.public_urls?.intake ?? ""}`);
-  lines.push(`🔧 Admin:   ${opsStack.admin_url ?? ""}`);
+  // The token-bearing adminUrl (computed in tools.js from the workspace's
+  // bearer) is required to open the dashboard — the snapshot's
+  // ops_stack.admin_url has no token and 404s at /admin/invalid if clicked.
+  lines.push(`🔧 Admin:   ${adminUrl ?? opsStack.admin_url ?? ""}`);
   lines.push("");
 
   // 7-automation callout

package/src/tools.js

@@ -914,6 +914,9 @@ export const TOOLS = [
         snapshot,
         durationSec: 0, // smoke test reports actual duration via Vercel logs, not the summary text
         aestheticArchetype,
+        adminUrl, // token-bearing (same variable the welcome-email body uses below) —
+        // without this the summary's Admin line falls back to the snapshot's
+        // tokenless ops_stack.admin_url and 404s at /admin/invalid when clicked.
       });
 
       return {
@@ -5086,11 +5089,13 @@ export const TOOLS = [
           error: "publish_failed_but_agent_created",
           agent: createResult.agent,
           embed_url: createResult.embed_url,
-          turn_url: createResult.turn_url,
+          turn_api_url: createResult.turn_url,
+          turn_api_method: "POST",
           publish_detail: publishResult,
           steps,
           next_steps: [
             `Agent ${agentId} was created but couldn't be published to test. Call publish_agent({ agent_id: '${agentId}', status: 'test' }) manually, or check the dashboard at /agents/${agentId}`,
+            `Turn API (POST) — this is not a clickable link, it's a POST-only endpoint: curl -sX POST ${createResult.turn_url} -H "Content-Type: application/json" -d '{"message":"hi"}'`,
           ],
         };
       }
@@ -5114,7 +5119,8 @@ export const TOOLS = [
         ok: true,
         agent: createResult.agent,
         embed_url: createResult.embed_url,
-        turn_url: createResult.turn_url,
+        turn_api_url: createResult.turn_url,
+        turn_api_method: "POST",
         dashboard_url: dashboardUrl,
         sandbox_url: `${dashboardUrl}/test`,
         llm_mode: llmMode,
@@ -5125,6 +5131,7 @@ export const TOOLS = [
           `3. When ready, publish to live: call publish_agent({ agent_id: '${agentId}', status: 'live' }) — auto-runs eval gate, requires ≥87.5% pass.`,
           `4. Add to the operator's SF-hosted landing page (one MCP call): embed_chatbot_on_workspace_landing({ workspace_id, agent_id: '${agentId}' }) — the chatbot bubble appears bottom-right on every public page. (For an external website the operator owns, paste this snippet manually: <script src="${createResult.embed_url}" async></script>)`,
           `5. ${llmKeyNote}`,
+          `6. Turn API (POST) — not a clickable link, it's a POST-only endpoint: curl -sX POST ${createResult.turn_url} -H "Content-Type: application/json" -d '{"message":"hi"}'`,
         ],
       };
     },

package/src/welcome.js

@@ -109,7 +109,7 @@ of v1.28.0 this is **ONE tool call**:
      // /settings/integrations/llm. Pass explicitly only when you need
      // per-workspace billing isolation (white-label / agency).
    })
-   // → returns { agent, embed_url, turn_url, dashboard_url, llm_mode, next_steps }
+   // → returns { agent, embed_url, turn_api_url, turn_api_method: "POST", dashboard_url, llm_mode, next_steps }
    // Internally: creates agent, publishes to test. Skips set_llm_key when
    // no key supplied (platform fallback in lib/ai/client.ts handles inference).