@sentientui/mcp 0.3.3 → 0.4.0

package/dist/index.cjs

@@ -1,6 +1,10 @@
 #!/usr/bin/env node
 "use strict";
 
+// ../../node_modules/.pnpm/tsup@8.5.1_jiti@1.21.7_postcss@8.5.14_tsx@4.22.1_typescript@5.9.3_yaml@2.9.0/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
 // src/index.ts
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 
@@ -51,12 +55,67 @@ var ApiClient = class {
 };
 
 // src/server.ts
+var import_node_module = require("module");
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 
 // src/tools/projects.ts
 var import_zod = require("zod");
 var projectIdSchema = import_zod.z.string().uuid().describe("The project UUID");
+function createProjectGuidance(err) {
+  switch (err.message) {
+    case "insufficient_scope":
+      return "Creating a project needs an account login. Connect via the hosted MCP URL (https://api.sentient-ui.com/mcp) and sign in \u2014 a project-scoped server key (sk_\u2026) cannot create projects.";
+    case "demo_read_only":
+      return "Demo mode is read-only. Create a SentientUI account and sign in to make projects.";
+    case "insufficient_role":
+      return "Your account role cannot create projects \u2014 this needs the account owner or an admin.";
+    case "project_limit_reached":
+      return "You've reached your plan's project limit. Upgrade your plan or remove an existing project, then try again.";
+    case "name_required":
+      return "A project name is required to create a project.";
+    default:
+      return null;
+  }
+}
 function registerProjectTools(server, client) {
+  server.tool(
+    "create_project",
+    "Create a NEW SentientUI project (onboarding). Returns the project id and its pk_ public key for the SDK. Requires an account login: this works when connected via OAuth (the hosted MCP URL) but NOT with a project-scoped sk_ server key or an anonymous demo token. After it succeeds, call get_integration_guide and help the user install @sentientui/react with the returned key.",
+    {
+      name: import_zod.z.string().min(1).describe("Human-readable project name"),
+      contextType: import_zod.z.enum(["saas", "ecommerce", "marketing", "internal"]).optional().describe("What kind of product this is; defaults to saas"),
+      framework: import_zod.z.enum(["next-app", "next-pages", "react", "core"]).optional().describe("Frontend framework, used to tailor setup; defaults to next-app"),
+      websiteUrl: import_zod.z.string().optional().describe("Production site origin to allow-list so the SDK's events aren't origin-blocked on day one")
+    },
+    async ({ name, contextType, framework, websiteUrl }) => {
+      try {
+        const created = await client.post("/projects", {
+          name,
+          contextType,
+          framework,
+          origin: websiteUrl
+        });
+        return {
+          content: [{
+            type: "text",
+            text: [
+              `Created project "${name}" (id: ${created.id}, type: ${contextType ?? "saas"}).`,
+              `Public key: ${created.apiKey}`,
+              `Next: install @sentientui/react with this key. Ask me to pull the setup guide (get_integration_guide) and I'll wrap your first component.`
+            ].join("\n")
+          }]
+        };
+      } catch (err) {
+        if (err instanceof ApiError) {
+          const guidance = createProjectGuidance(err);
+          if (guidance) {
+            return { content: [{ type: "text", text: guidance }], isError: true };
+          }
+        }
+        throw err;
+      }
+    }
+  );
   server.tool(
     "list_projects",
     "List all SentientUI projects for the authenticated account.",
@@ -647,10 +706,11 @@ function registerIntegrationGuideTools(server) {
 }
 
 // src/server.ts
+var { version: PKG_VERSION } = (0, import_node_module.createRequire)(importMetaUrl)("../package.json");
 function createMcpServer(client) {
   const server = new import_mcp.McpServer({
     name: "@sentientui/mcp",
-    version: "0.1.0"
+    version: PKG_VERSION
   });
   registerProjectTools(server, client);
   registerComponentTools(server, client);