@sentientui/mcp 0.10.0 → 0.11.0

package/README.md

@@ -93,6 +93,7 @@ A sandboxed demo token is provisioned automatically — 10 calls/month, read-onl
 | `refresh_insights` | Trigger fresh AI insight generation |
 | `get_persona_breakdown` | Visitor cluster distribution with reliability scores |
 | `get_goal_funnel` | Goal hit counts and conversion rates per variant |
+| `list_goals` | Defined goals (id, role, event, status) — includes goals with no conversions yet, so agents can wire a dashboard-defined goal into code |
 | `list_guardrail_events` | Variants auto-paused by the guardrail (last 24h) |
 | `get_layout_stats` | Per-persona section layout rankings and reward weights |
 | `get_integration_guide` | SentientUI adaptive-ladder setup guide (static — same for every project) |

package/dist/{chunk-ZH3EDKIT.js → chunk-4TM3SCHF.js}

@@ -787,6 +787,62 @@ function registerGoalTools(server, client) {
       return { content: [{ type: "text", text: lines.join("\n").trim() }], structuredContent, _meta: uiMeta("goal-funnel") };
     })
   );
+  server.registerTool(
+    "list_goals",
+    {
+      title: "List goal definitions",
+      description: `List the project's defined goals \u2014 including ones with no conversions yet, which get_goal_funnel cannot see. Returns each goal's stable id, display name, role (primary/secondary/guardrail), event type, and status. Reference a goalId verbatim from code: client.goal('<goalId>') or <Adaptive goal="<goalId>">.`,
+      inputSchema: { projectId: projectIdSchema },
+      outputSchema: {
+        goals: z6.array(
+          z6.object({
+            goalId: z6.string().describe("Stable id \u2014 use this exact string when firing the goal from code"),
+            displayName: z6.string(),
+            role: z6.string().describe("primary | secondary | guardrail"),
+            event: z6.string().describe("click | form_submit | url_reached"),
+            urlPattern: z6.string().nullable().describe("Only for url_reached goals"),
+            status: z6.string().describe("active | archived")
+          })
+        ).describe("Defined goals (empty if none)")
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    withApiErrorGuidance(async ({ projectId }) => {
+      const id = encodeURIComponent(projectId);
+      const data = await client.get(`/projects/${id}/goal-definitions`);
+      const structuredContent = {
+        goals: data.goals.map((g) => {
+          var _a;
+          return {
+            goalId: g.goal_id,
+            displayName: g.display_name,
+            role: g.role,
+            event: g.event,
+            urlPattern: (_a = g.url_pattern) != null ? _a : null,
+            status: g.status
+          };
+        })
+      };
+      if (!structuredContent.goals.length) {
+        return {
+          content: [{
+            type: "text",
+            text: "No goal definitions yet. Define one in the dashboard (Goals page or onboarding chat), or fire client.goal('<name>') from code and it will appear in get_goal_funnel once it converts."
+          }],
+          structuredContent
+        };
+      }
+      const lines = structuredContent.goals.map(
+        (g) => `${g.goalId} (${g.role}, ${g.event}${g.status === "archived" ? ", archived" : ""}) \u2014 ${g.displayName}`
+      );
+      lines.push("", `Reference a goalId verbatim from code: client.goal('<goalId>') or <Adaptive goal="<goalId>">.`);
+      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
+    })
+  );
 }
 
 // src/tools/guardrails.ts
@@ -1520,7 +1576,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.10.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.11.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new McpServer(
     {

package/dist/index.cjs

@@ -791,6 +791,62 @@ function registerGoalTools(server, client) {
       return { content: [{ type: "text", text: lines.join("\n").trim() }], structuredContent, _meta: uiMeta("goal-funnel") };
     })
   );
+  server.registerTool(
+    "list_goals",
+    {
+      title: "List goal definitions",
+      description: `List the project's defined goals \u2014 including ones with no conversions yet, which get_goal_funnel cannot see. Returns each goal's stable id, display name, role (primary/secondary/guardrail), event type, and status. Reference a goalId verbatim from code: client.goal('<goalId>') or <Adaptive goal="<goalId>">.`,
+      inputSchema: { projectId: projectIdSchema },
+      outputSchema: {
+        goals: import_zod6.z.array(
+          import_zod6.z.object({
+            goalId: import_zod6.z.string().describe("Stable id \u2014 use this exact string when firing the goal from code"),
+            displayName: import_zod6.z.string(),
+            role: import_zod6.z.string().describe("primary | secondary | guardrail"),
+            event: import_zod6.z.string().describe("click | form_submit | url_reached"),
+            urlPattern: import_zod6.z.string().nullable().describe("Only for url_reached goals"),
+            status: import_zod6.z.string().describe("active | archived")
+          })
+        ).describe("Defined goals (empty if none)")
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    withApiErrorGuidance(async ({ projectId }) => {
+      const id = encodeURIComponent(projectId);
+      const data = await client.get(`/projects/${id}/goal-definitions`);
+      const structuredContent = {
+        goals: data.goals.map((g) => {
+          var _a2;
+          return {
+            goalId: g.goal_id,
+            displayName: g.display_name,
+            role: g.role,
+            event: g.event,
+            urlPattern: (_a2 = g.url_pattern) != null ? _a2 : null,
+            status: g.status
+          };
+        })
+      };
+      if (!structuredContent.goals.length) {
+        return {
+          content: [{
+            type: "text",
+            text: "No goal definitions yet. Define one in the dashboard (Goals page or onboarding chat), or fire client.goal('<name>') from code and it will appear in get_goal_funnel once it converts."
+          }],
+          structuredContent
+        };
+      }
+      const lines = structuredContent.goals.map(
+        (g) => `${g.goalId} (${g.role}, ${g.event}${g.status === "archived" ? ", archived" : ""}) \u2014 ${g.displayName}`
+      );
+      lines.push("", `Reference a goalId verbatim from code: client.goal('<goalId>') or <Adaptive goal="<goalId>">.`);
+      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
+    })
+  );
 }
 
 // src/tools/guardrails.ts
@@ -1524,7 +1580,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.10.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.11.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new import_mcp.McpServer(
     {

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   ApiClient,
   createMcpServer
-} from "./chunk-ZH3EDKIT.js";
+} from "./chunk-4TM3SCHF.js";
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/lib.cjs

@@ -816,6 +816,62 @@ function registerGoalTools(server, client) {
       return { content: [{ type: "text", text: lines.join("\n").trim() }], structuredContent, _meta: uiMeta("goal-funnel") };
     })
   );
+  server.registerTool(
+    "list_goals",
+    {
+      title: "List goal definitions",
+      description: `List the project's defined goals \u2014 including ones with no conversions yet, which get_goal_funnel cannot see. Returns each goal's stable id, display name, role (primary/secondary/guardrail), event type, and status. Reference a goalId verbatim from code: client.goal('<goalId>') or <Adaptive goal="<goalId>">.`,
+      inputSchema: { projectId: projectIdSchema },
+      outputSchema: {
+        goals: import_zod6.z.array(
+          import_zod6.z.object({
+            goalId: import_zod6.z.string().describe("Stable id \u2014 use this exact string when firing the goal from code"),
+            displayName: import_zod6.z.string(),
+            role: import_zod6.z.string().describe("primary | secondary | guardrail"),
+            event: import_zod6.z.string().describe("click | form_submit | url_reached"),
+            urlPattern: import_zod6.z.string().nullable().describe("Only for url_reached goals"),
+            status: import_zod6.z.string().describe("active | archived")
+          })
+        ).describe("Defined goals (empty if none)")
+      },
+      annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    withApiErrorGuidance(async ({ projectId }) => {
+      const id = encodeURIComponent(projectId);
+      const data = await client.get(`/projects/${id}/goal-definitions`);
+      const structuredContent = {
+        goals: data.goals.map((g) => {
+          var _a;
+          return {
+            goalId: g.goal_id,
+            displayName: g.display_name,
+            role: g.role,
+            event: g.event,
+            urlPattern: (_a = g.url_pattern) != null ? _a : null,
+            status: g.status
+          };
+        })
+      };
+      if (!structuredContent.goals.length) {
+        return {
+          content: [{
+            type: "text",
+            text: "No goal definitions yet. Define one in the dashboard (Goals page or onboarding chat), or fire client.goal('<name>') from code and it will appear in get_goal_funnel once it converts."
+          }],
+          structuredContent
+        };
+      }
+      const lines = structuredContent.goals.map(
+        (g) => `${g.goalId} (${g.role}, ${g.event}${g.status === "archived" ? ", archived" : ""}) \u2014 ${g.displayName}`
+      );
+      lines.push("", `Reference a goalId verbatim from code: client.goal('<goalId>') or <Adaptive goal="<goalId>">.`);
+      return { content: [{ type: "text", text: lines.join("\n") }], structuredContent };
+    })
+  );
 }
 
 // src/tools/guardrails.ts
@@ -1549,7 +1605,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.10.0" : "0.0.0-dev";
+var PKG_VERSION = true ? "0.11.0" : "0.0.0-dev";
 function createMcpServer(client) {
   const server = new import_mcp.McpServer(
     {

package/dist/lib.js

@@ -3,7 +3,7 @@ import {
   ApiClient,
   ApiError,
   createMcpServer
-} from "./chunk-ZH3EDKIT.js";
+} from "./chunk-4TM3SCHF.js";
 export {
   ApiClient,
   ApiError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentientui/mcp",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "MCP server for SentientUI — exposes project data and actions to AI agents",
   "license": "MIT",
   "homepage": "https://sentient-ui.com",