@seldonframe/mcp 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seldonframe/mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for SeldonFrame — AI-native Business OS platform. One command creates a real hosted workspace with CRM, booking, intake, and Brain v2.",
   "type": "module",
   "bin": {

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/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.`;