@sentientui/mcp 0.9.2 → 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-KUOPKVVD.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
@@ -1475,6 +1531,11 @@ function registerAgentTrafficTools(server, client) {
               cta: z13.boolean(),
               notes: z13.array(z13.string())
             }),
+            fixes: z13.array(z13.object({
+              check: z13.string(),
+              advice: z13.string(),
+              snippet: z13.string().optional()
+            })).optional().describe("Concrete Next.js remediation per failing check"),
             lastChecked: z13.string()
           })
         ),
@@ -1498,7 +1559,12 @@ function registerAgentTrafficTools(server, client) {
           const failed = ["price", "name", "positioning", "cta"].filter((k) => !p.checks[k]);
           return `- ${p.path}: ${p.score}/100${failed.length ? ` \u2014 missing: ${failed.join(", ")}` : " \u2014 fully legible"}`;
         }),
-        ...l.paths.flatMap((p) => p.checks.notes.map((n) => `  fix (${p.path}): ${n}`))
+        ...l.paths.flatMap(
+          (p) => {
+            var _a;
+            return ((_a = p.fixes) == null ? void 0 : _a.length) ? p.fixes.map((f) => `  fix (${p.path}): ${f.advice}`) : p.checks.notes.map((n) => `  fix (${p.path}): ${n}`);
+          }
+        )
       ];
       if (l.emptyBlocks.length > 0) {
         lines.push("", "Agent API blocks served without agent data (add agentDataByVariant):");
@@ -1510,7 +1576,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.9.2" : "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
@@ -1479,6 +1535,11 @@ function registerAgentTrafficTools(server, client) {
               cta: import_zod13.z.boolean(),
               notes: import_zod13.z.array(import_zod13.z.string())
             }),
+            fixes: import_zod13.z.array(import_zod13.z.object({
+              check: import_zod13.z.string(),
+              advice: import_zod13.z.string(),
+              snippet: import_zod13.z.string().optional()
+            })).optional().describe("Concrete Next.js remediation per failing check"),
             lastChecked: import_zod13.z.string()
           })
         ),
@@ -1502,7 +1563,12 @@ function registerAgentTrafficTools(server, client) {
           const failed = ["price", "name", "positioning", "cta"].filter((k) => !p.checks[k]);
           return `- ${p.path}: ${p.score}/100${failed.length ? ` \u2014 missing: ${failed.join(", ")}` : " \u2014 fully legible"}`;
         }),
-        ...l.paths.flatMap((p) => p.checks.notes.map((n) => `  fix (${p.path}): ${n}`))
+        ...l.paths.flatMap(
+          (p) => {
+            var _a2;
+            return ((_a2 = p.fixes) == null ? void 0 : _a2.length) ? p.fixes.map((f) => `  fix (${p.path}): ${f.advice}`) : p.checks.notes.map((n) => `  fix (${p.path}): ${n}`);
+          }
+        )
       ];
       if (l.emptyBlocks.length > 0) {
         lines.push("", "Agent API blocks served without agent data (add agentDataByVariant):");
@@ -1514,7 +1580,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.9.2" : "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-KUOPKVVD.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
@@ -1504,6 +1560,11 @@ function registerAgentTrafficTools(server, client) {
               cta: import_zod13.z.boolean(),
               notes: import_zod13.z.array(import_zod13.z.string())
             }),
+            fixes: import_zod13.z.array(import_zod13.z.object({
+              check: import_zod13.z.string(),
+              advice: import_zod13.z.string(),
+              snippet: import_zod13.z.string().optional()
+            })).optional().describe("Concrete Next.js remediation per failing check"),
             lastChecked: import_zod13.z.string()
           })
         ),
@@ -1527,7 +1588,12 @@ function registerAgentTrafficTools(server, client) {
           const failed = ["price", "name", "positioning", "cta"].filter((k) => !p.checks[k]);
           return `- ${p.path}: ${p.score}/100${failed.length ? ` \u2014 missing: ${failed.join(", ")}` : " \u2014 fully legible"}`;
         }),
-        ...l.paths.flatMap((p) => p.checks.notes.map((n) => `  fix (${p.path}): ${n}`))
+        ...l.paths.flatMap(
+          (p) => {
+            var _a;
+            return ((_a = p.fixes) == null ? void 0 : _a.length) ? p.fixes.map((f) => `  fix (${p.path}): ${f.advice}`) : p.checks.notes.map((n) => `  fix (${p.path}): ${n}`);
+          }
+        )
       ];
       if (l.emptyBlocks.length > 0) {
         lines.push("", "Agent API blocks served without agent data (add agentDataByVariant):");
@@ -1539,7 +1605,7 @@ function registerAgentTrafficTools(server, client) {
 }
 
 // src/server.ts
-var PKG_VERSION = true ? "0.9.2" : "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-KUOPKVVD.js";
+} from "./chunk-4TM3SCHF.js";
 export {
   ApiClient,
   ApiError,

package/package.json

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