@sentientui/mcp 0.3.4 → 0.4.0

package/dist/index.cjs

@@ -61,7 +61,61 @@ 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.",