@seldonframe/mcp 1.0.1 → 1.0.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seldonframe/mcp",
-  "version": "1.0.1",
-  "description": "MCP server for SeldonFrame — AI-native Business OS platform. One command creates a real hosted workspace with CRM, booking, intake, and Brain v2.",
+  "version": "1.0.3",
+  "description": "MCP server for SeldonFrame — AI-native Business OS platform. One command creates a real hosted workspace with CRM, booking, intake, and Brain v2. v1.0.3: surfaces admin URL prominently in create_workspace response (no signup required to access dashboard).",
   "type": "module",
   "bin": {
     "seldonframe-mcp": "src/index.js"

package/src/index.js

@@ -1,81 +1,81 @@
-#!/usr/bin/env node
-
-// Node version gate — must run before any imports that could fail or
-// reach for fetch(). Without this, Node 16 users get a cryptic
-// "fetch is not defined" crash the moment the first tool calls the
-// SeldonFrame API.
-//
-// Per L-29 the cleanroom test in GitHub Codespaces (default image
-// ships Node v16.20.2 in some configurations) surfaced this
-// immediately on @seldonframe/mcp@1.0.0. Strict requirement is
-// documented in engines.node = ">=18" and reinforced here at runtime
-// so users get actionable next-steps instead of a stack trace.
-//
-// Implementation note: we use dynamic `await import()` for the SDK
-// modules below specifically so this gate runs BEFORE any SDK code
-// executes. Static `import` statements at the top of an ESM module
-// are hoisted and evaluated before any module-body code, which would
-// defeat the gate if the SDK ever started failing at import-time on
-// older Node versions.
-const [nodeMajor] = process.versions.node.split(".").map(Number);
-if (nodeMajor < 18) {
-  process.stderr.write(
-    `\n  SeldonFrame MCP requires Node.js 18 or later.\n` +
-      `  You are running Node.js ${process.versions.node}.\n\n` +
-      `  To fix:\n` +
-      `    nvm install 18 && nvm use 18\n` +
-      `  Or:\n` +
-      `    nvm install 20 && nvm use 20\n\n` +
-      `  Then retry:\n` +
-      `    claude mcp add seldonframe -- npx -y @seldonframe/mcp\n\n`,
-  );
-  process.exit(1);
-}
-
-const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
-const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
-const { CallToolRequestSchema, ListToolsRequestSchema } = await import(
-  "@modelcontextprotocol/sdk/types.js"
-);
-const { WELCOME_MARKDOWN, VERSION } = await import("./welcome.js");
-const { TOOLS, TOOL_MAP } = await import("./tools.js");
-
-const server = new Server(
-  { name: "seldonframe", version: VERSION },
-  {
-    capabilities: { tools: {} },
-    instructions: WELCOME_MARKDOWN,
-  },
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: TOOLS.map(({ name, description, inputSchema }) => ({
-    name,
-    description,
-    inputSchema,
-  })),
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (req) => {
-  const tool = TOOL_MAP[req.params.name];
-  if (!tool) {
-    return {
-      isError: true,
-      content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }],
-    };
-  }
-  try {
-    const result = await tool.handler(req.params.arguments ?? {});
-    return {
-      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    };
-  } catch (err) {
-    return {
-      isError: true,
-      content: [{ type: "text", text: err instanceof Error ? err.message : String(err) }],
-    };
-  }
-});
-
-const transport = new StdioServerTransport();
-await server.connect(transport);
+#!/usr/bin/env node
+
+// Node version gate — must run before any imports that could fail or
+// reach for fetch(). Without this, Node 16 users get a cryptic
+// "fetch is not defined" crash the moment the first tool calls the
+// SeldonFrame API.
+//
+// Per L-29 the cleanroom test in GitHub Codespaces (default image
+// ships Node v16.20.2 in some configurations) surfaced this
+// immediately on @seldonframe/mcp@1.0.0. Strict requirement is
+// documented in engines.node = ">=18" and reinforced here at runtime
+// so users get actionable next-steps instead of a stack trace.
+//
+// Implementation note: we use dynamic `await import()` for the SDK
+// modules below specifically so this gate runs BEFORE any SDK code
+// executes. Static `import` statements at the top of an ESM module
+// are hoisted and evaluated before any module-body code, which would
+// defeat the gate if the SDK ever started failing at import-time on
+// older Node versions.
+const [nodeMajor] = process.versions.node.split(".").map(Number);
+if (nodeMajor < 18) {
+  process.stderr.write(
+    `\n  SeldonFrame MCP requires Node.js 18 or later.\n` +
+      `  You are running Node.js ${process.versions.node}.\n\n` +
+      `  To fix:\n` +
+      `    nvm install 18 && nvm use 18\n` +
+      `  Or:\n` +
+      `    nvm install 20 && nvm use 20\n\n` +
+      `  Then retry:\n` +
+      `    claude mcp add seldonframe -- npx -y @seldonframe/mcp\n\n`,
+  );
+  process.exit(1);
+}
+
+const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+const { CallToolRequestSchema, ListToolsRequestSchema } = await import(
+  "@modelcontextprotocol/sdk/types.js"
+);
+const { WELCOME_MARKDOWN, VERSION } = await import("./welcome.js");
+const { TOOLS, TOOL_MAP } = await import("./tools.js");
+
+const server = new Server(
+  { name: "seldonframe", version: VERSION },
+  {
+    capabilities: { tools: {} },
+    instructions: WELCOME_MARKDOWN,
+  },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: TOOLS.map(({ name, description, inputSchema }) => ({
+    name,
+    description,
+    inputSchema,
+  })),
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  const tool = TOOL_MAP[req.params.name];
+  if (!tool) {
+    return {
+      isError: true,
+      content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }],
+    };
+  }
+  try {
+    const result = await tool.handler(req.params.arguments ?? {});
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+  } catch (err) {
+    return {
+      isError: true,
+      content: [{ type: "text", text: err instanceof Error ? err.message : String(err) }],
+    };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools.js

@@ -63,6 +63,10 @@ export const TOOLS = [
       } else {
         setDefaultWorkspace(id);
       }
+      // C6: surface the bearer-token admin URL as the most prominent line
+      // in the response. Operators paste it into their browser and land
+      // directly on the dashboard — no signup, no login, no OAuth.
+      const adminUrl = result.admin_url ?? null;
       const payload = {
         ok: true,
         workspace: {
@@ -72,13 +76,23 @@ export const TOOLS = [
           tier: ws.tier ?? "free",
           created_at: ws.created_at,
         },
+        // ⚡ Admin Dashboard (bookmark this!): the one URL operators need.
+        admin_url: adminUrl,
+        admin_url_expires_at: result.bearer_token_expires_at ?? null,
+        admin_url_message: adminUrl
+          ? `⚡ Admin Dashboard (bookmark this!): ${adminUrl}\nClick to open the dashboard — no signup needed. Token expires in 7 days; re-mint with list_workspaces({}) when it does.`
+          : null,
         urls: result.urls ?? ws.urls ?? null,
+        public_urls: result.public_urls ?? null,
         installed: result.installed ?? ["crm", "caldiy-booking", "formbricks-intake", "brain-v2"],
         next: [
+          adminUrl
+            ? `Open the admin dashboard: ${adminUrl}  (paste into your browser; no signup needed)`
+            : null,
           "install_vertical_pack({ pack: 'real-estate' })  // or 'dental', 'legal'",
           "fetch_source_for_soul({ url: 'https://yoursite.com' }) → submit_soul({ soul })",
           "get_workspace_snapshot({}) — read workspace state to reason about next steps",
-        ],
+        ].filter(Boolean),
       };
       return firstEver ? withFirstCallBanner(payload) : payload;
     },
@@ -250,7 +264,7 @@ export const TOOLS = [
   {
     name: "update_landing_content",
     description:
-      "Rewrite the workspace's public landing page at / — headline, subhead, and primary CTA label. YOU decide the copy based on the user's request + the workspace Soul; this tool persists it.",
+      "Rewrite the workspace's public landing page hero — headline, subhead, and primary CTA label. C3.4 made this blueprint-aware: the operator's edit lands without losing any of the renderer's visual polish (typography, layered-shadow buttons, animations, etc.). Use this for the most common copy edits; for granular per-section / per-item edits use update_landing_section.",
     inputSchema: obj(
       {
         headline: str("Main hero heading. Keep short; 1 line."),
@@ -258,7 +272,6 @@ export const TOOLS = [
         cta_label: str("Primary call-to-action button text, e.g. 'Book a call'."),
         workspace_id: str("Optional workspace override."),
       },
-      ["headline", "subhead", "cta_label"],
     ),
     handler: async (a) => {
       const ws = wsOrDefault(a.workspace_id);
@@ -273,6 +286,51 @@ export const TOOLS = [
       });
     },
   },
+  {
+    name: "update_landing_section",
+    description:
+      "Granular per-field landing edit — change any single slot in any section of the blueprint-rendered landing page. Use when update_landing_content's three fields aren't enough. Section types: emergency-strip, hero, trust-strip, services-grid, about, mid-cta, testimonials, service-area, faq, footer. Field is a dot-segmented path on that section (e.g. 'headline', 'subhead', 'items.0.title', 'items.2.answer', 'showHours'). Value is the new value (string for copy, boolean for flags, etc.).",
+    inputSchema: obj(
+      {
+        section: {
+          type: "string",
+          enum: [
+            "emergency-strip",
+            "hero",
+            "trust-strip",
+            "services-grid",
+            "about",
+            "mid-cta",
+            "testimonials",
+            "service-area",
+            "faq",
+            "footer",
+          ],
+        },
+        field: str(
+          "Dot-segmented field path on the section. Examples: 'headline', 'subhead', 'items.0.title', 'items.2.answer', 'showHours'."
+        ),
+        value: {
+          description:
+            "New value for the field. String for copy, number for ratings, boolean for flags, object/array for richer slots.",
+        },
+        workspace_id: str("Optional workspace override."),
+      },
+      ["section", "field", "value"],
+    ),
+    handler: async (a) => {
+      const ws = wsOrDefault(a.workspace_id);
+      return api("POST", "/landing/section/update", {
+        body: {
+          section: a.section,
+          field: a.field,
+          value: a.value,
+          workspace_id: ws,
+        },
+        workspace_id: ws,
+      });
+    },
+  },
   // Note: `customize_intake_form` used to live here pointing at POST
   // /api/v1/intake/customize. Phase 2.d unified it under update_form; the
   // alias that preserves the old name now lives in the Phase 2.d block at

package/src/welcome.js

@@ -1,4 +1,4 @@
-export const VERSION = "1.0.1";
+export const VERSION = "1.0.2";
 
 export const WELCOME_MARKDOWN = `# SeldonFrame — your AI-native Business OS
 
@@ -16,15 +16,63 @@ intent and call the appropriate typed tool. The backend applies the change
 deterministically. Zero backend LLM cost means the free tier is genuinely
 free forever.
 
-## The one command
+---
+
+## Quick start — describe your business
+
+To create a personalized workspace in a single turn, ask the user to paste
+this template into Claude Code and fill in their details:
 
 \`\`\`text
-create_workspace({ name: "Dental Clinic Laval", source: "https://example.com" })
+Create a workspace for my business:
+- Business name: [your business name]
+- Industry: [e.g., hvac, dental, legal, coaching, real-estate, salon, auto-repair]
+- Location: [city, state/province]
+- Operating hours: [e.g., Mon-Sat 7am-7pm]
+- Team size: [number of people / trucks / stations]
+- Services offered: [list your main services]
+- Website: [URL, if you have one]
 \`\`\`
 
-Returns a live subdomain, seeded CRM, and booking + intake pages ready to share.
+When the user replies with that filled in, YOU should orchestrate the
+following tool sequence (each call's response is structured — chain them):
+
+1. \`create_workspace({ name: "<business name>", source: "<website if provided, else a 1-paragraph description>" })\`
+   — mints the hosted workspace + bearer token. The \`source\` arg seeds the Soul.
+2. If \`industry\` is provided, call \`install_vertical_pack({ pack: "<industry-slug>" })\`
+   — adds domain-specific objects, fields, and views.
+   Built-in packs: \`real-estate-agency\`. For other industries, the backend
+   synthesizes a custom pack via \`/api/v1/verticals/generate\`. If a builtin
+   pack matches, prefer it; otherwise call generate first, then install.
+3. If \`hours\` is provided, call \`configure_booking({ title, duration_minutes, description })\`
+   — sets the booking page defaults. Inline the parsed hours into \`description\`
+   (the booking schema doesn't take a per-day hours object yet).
+4. If \`website\` was provided, the \`source\` URL passed to step 1 already
+   triggered a Soul fetch. Confirm via \`get_workspace_snapshot({})\` and
+   call \`submit_soul({ soul })\` if you can extract a richer structured Soul.
+5. If \`services\` were listed, customize the intake form to capture
+   service-of-interest as a multi-select using \`customize_intake_form({ fields })\`.
+
+Present the final result as a summary: live URLs (public + admin), what
+was installed, and 2-3 next-best-action suggestions.
+
+## If the user just says "create a workspace" without details
+
+Ask these questions, one at a time, BEFORE calling \`create_workspace\`:
+
+1. What's your business name?
+2. What industry are you in? (suggest: hvac, dental, legal, coaching, real-estate, salon, auto-repair, consulting, fitness, other)
+3. Where are you located? (city, state)
+4. What are your operating hours?
+5. What services do you offer? (3-5 main ones)
+6. Do you have a website I can learn from? (optional)
+
+Then run the orchestration above. Don't dump all six questions in one
+message — ask conversationally so the user can think.
+
+---
 
-## How to customize a workspace
+## How to customize a workspace later
 
 1. Call \`get_workspace_snapshot({})\` to see current state, Soul, blocks, recent events.
 2. Decide what to change based on the user's intent.
@@ -56,11 +104,15 @@ Soul compilation runs HERE, not on the backend:
 
 ## When you'll need \`SELDONFRAME_API_KEY\`
 
-The first workspace is free forever. A key is only required for:
+The first workspace is free forever. Paid tiers (Starter $49/mo, Operator
+$99/mo, Agency $149/mo) unlock additional workspaces, custom domains,
+white-label, and advanced Brain capabilities. A key is required for:
 
 - Adding a **second workspace**
 - Connecting a **custom domain**
 - Publishing, exporting agents, rotating org-scoped secrets
+- Accessing the admin browser surface (\`/dashboard\`, \`/contacts\`, \`/deals\`)
+  after \`link_workspace_owner({})\`
 
 Get one at <https://app.seldonframe.com/settings/api> and
 \`export SELDONFRAME_API_KEY=sk-…\`. The MCP will pick it up on next restart.
@@ -69,12 +121,12 @@ Get one at <https://app.seldonframe.com/settings/api> and
 
 Once a key is set, \`link_workspace_owner({})\` attaches the active
 workspace to your real account. This unlocks the admin URLs
-(dashboard, contacts, deals) for browser use after sign-in. The MCP
-bearer token stays valid — no rotation needed.
+(\`/dashboard\`, \`/contacts\`, \`/deals\`) for browser use after sign-in.
+The MCP bearer token stays valid — no rotation needed.
 
 ---
 
-**Docs:** <https://app.seldonframe.com/docs>  ·  **Homepage:** <https://seldonframe.com>
+**Docs:** <https://seldonframe.com/docs>  ·  **Homepage:** <https://seldonframe.com>  ·  **Pricing:** <https://seldonframe.com/#pricing>
 `;
 
 export const FIRST_CALL_BANNER = `🌑 Welcome to SeldonFrame. Your workspace is live — every URL above works right now. From here on, every tool response will include a \`next:\` array; follow it and you'll have a production-ready Business OS in under a minute.`;