@sentientui/mcp 0.18.4 → 0.20.0

package/dist/lib.d.cts

@@ -2,7 +2,23 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 declare class ApiError extends Error {
     status: number;
-    constructor(status: number, message: string);
+    /**
+     * The server's human sentence (body.message / body.reason), kept beside the
+     * machine code. The code alone is what apiErrorGuidance matches on, but
+     * dropping the sentence meant a 409 "Unpromote this variant before hiding
+     * it." or a 400 "a URL-reached goal needs a URL pattern" reached the agent
+     * as a bare `variant_promoted` / `invalid_goal` with no way to act on it.
+     */
+    detail?: string | undefined;
+    constructor(status: number, message: string, 
+    /**
+     * The server's human sentence (body.message / body.reason), kept beside the
+     * machine code. The code alone is what apiErrorGuidance matches on, but
+     * dropping the sentence meant a 409 "Unpromote this variant before hiding
+     * it." or a 400 "a URL-reached goal needs a URL pattern" reached the agent
+     * as a bare `variant_promoted` / `invalid_goal` with no way to act on it.
+     */
+    detail?: string | undefined);
 }
 declare class ApiClient {
     private baseUrl;
@@ -20,6 +36,8 @@ declare class ApiClient {
     });
     get<T = unknown>(path: string): Promise<T>;
     post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string, body?: unknown): Promise<T>;
     private request;
 }
 
@@ -36,4 +54,13 @@ declare function createMcpServer(client: ApiClient): McpServer;
  */
 declare const PUBLIC_UI_RESOURCE_URIS: readonly string[];
 
-export { ApiClient, ApiError, PUBLIC_UI_RESOURCE_URIS, createMcpServer };
+type ToolAccess = 'read' | 'write';
+type ToolCatalogEntry = {
+    name: string;
+    access: ToolAccess;
+    summary: string;
+};
+declare const TOOL_CATALOG: readonly ToolCatalogEntry[];
+declare const TOOL_NAMES: readonly string[];
+
+export { ApiClient, ApiError, PUBLIC_UI_RESOURCE_URIS, TOOL_CATALOG, TOOL_NAMES, type ToolAccess, type ToolCatalogEntry, createMcpServer };

package/dist/lib.d.ts

@@ -2,7 +2,23 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 declare class ApiError extends Error {
     status: number;
-    constructor(status: number, message: string);
+    /**
+     * The server's human sentence (body.message / body.reason), kept beside the
+     * machine code. The code alone is what apiErrorGuidance matches on, but
+     * dropping the sentence meant a 409 "Unpromote this variant before hiding
+     * it." or a 400 "a URL-reached goal needs a URL pattern" reached the agent
+     * as a bare `variant_promoted` / `invalid_goal` with no way to act on it.
+     */
+    detail?: string | undefined;
+    constructor(status: number, message: string, 
+    /**
+     * The server's human sentence (body.message / body.reason), kept beside the
+     * machine code. The code alone is what apiErrorGuidance matches on, but
+     * dropping the sentence meant a 409 "Unpromote this variant before hiding
+     * it." or a 400 "a URL-reached goal needs a URL pattern" reached the agent
+     * as a bare `variant_promoted` / `invalid_goal` with no way to act on it.
+     */
+    detail?: string | undefined);
 }
 declare class ApiClient {
     private baseUrl;
@@ -20,6 +36,8 @@ declare class ApiClient {
     });
     get<T = unknown>(path: string): Promise<T>;
     post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string, body?: unknown): Promise<T>;
     private request;
 }
 
@@ -36,4 +54,13 @@ declare function createMcpServer(client: ApiClient): McpServer;
  */
 declare const PUBLIC_UI_RESOURCE_URIS: readonly string[];
 
-export { ApiClient, ApiError, PUBLIC_UI_RESOURCE_URIS, createMcpServer };
+type ToolAccess = 'read' | 'write';
+type ToolCatalogEntry = {
+    name: string;
+    access: ToolAccess;
+    summary: string;
+};
+declare const TOOL_CATALOG: readonly ToolCatalogEntry[];
+declare const TOOL_NAMES: readonly string[];
+
+export { ApiClient, ApiError, PUBLIC_UI_RESOURCE_URIS, TOOL_CATALOG, TOOL_NAMES, type ToolAccess, type ToolCatalogEntry, createMcpServer };

package/dist/lib.js

@@ -4,10 +4,57 @@ import {
   ApiError,
   PUBLIC_UI_RESOURCE_URIS,
   createMcpServer
-} from "./chunk-X3CXBGWM.js";
+} from "./chunk-35I5EJTS.js";
+
+// src/tool-catalog.ts
+var TOOL_CATALOG = [
+  // Projects
+  { name: "list_projects", access: "read", summary: "List the projects this credential can see (an sk_ key sees only its own project)" },
+  { name: "create_project", access: "write", summary: "Create a project and return its pk_ public key (account login only \u2014 not an sk_ key or demo token)" },
+  { name: "get_project_stats", access: "read", summary: "Ingestion health: status, 24h events and sessions, and /v1/agent API calls" },
+  { name: "add_origin", access: "write", summary: "Allow-list a site origin so the SDK's events from it are accepted" },
+  // Components and variants
+  { name: "list_components", access: "read", summary: "Adaptive components with variant counts and impressions" },
+  { name: "get_variant_performance", access: "read", summary: "Per-(component, variant) rates with their n and the server's evidence verdict vs the baseline" },
+  { name: "get_variant_brief", access: "read", summary: "Evidence-driven brief for writing a new code-native variant" },
+  { name: "get_test_brief", access: "read", summary: "Ready-to-paste test code that forces one of a component's real variants" },
+  { name: "create_variant", access: "write", summary: "Create a no-code managed text variant as a draft" },
+  { name: "update_variant", access: "write", summary: "Edit a managed variant's name or text, or activate a draft (status active) / move it back to draft" },
+  { name: "delete_variant_draft", access: "write", summary: "Delete a managed variant that is still a draft" },
+  { name: "pause_variant", access: "write", summary: "Pause a variant so no new traffic is assigned to it (undo with resume_variant)" },
+  { name: "resume_variant", access: "write", summary: "Resume a paused variant \u2014 manual or guardrail pause" },
+  { name: "retire_variant", access: "write", summary: "Retire (archive) an active variant (undo with restore_variant)" },
+  { name: "restore_variant", access: "write", summary: "Bring a retired variant back to active" },
+  // Goals, funnels, guardrails
+  { name: "get_goal_funnel", access: "read", summary: "Per-goal conversion summary (windowed) with descriptive all-time per-variant rates \u2014 not a step funnel (see get_funnel_report)" },
+  { name: "list_goals", access: "read", summary: "Defined goals (id, role, event, status), including ones with no conversions yet" },
+  { name: "list_funnels", access: "read", summary: "Defined multi-step funnels" },
+  { name: "get_funnel_report", access: "read", summary: "Step-by-step funnel drop-off" },
+  { name: "list_guardrail_events", access: "read", summary: "Every variant currently paused by a guardrail (optionally only pauses from the last N days)" },
+  // Audience and layout
+  { name: "get_persona_breakdown", access: "read", summary: "Visitor clusters with session counts and reliability (all retained sessions)" },
+  { name: "get_layout_stats", access: "read", summary: "Per-persona section order with bandit pulls and reward (cumulative state)" },
+  // Insights
+  { name: "get_insights", access: "read", summary: "Ranked measured findings with their sample, plus AI narrations marked unmeasured" },
+  { name: "refresh_insights", access: "write", summary: "Regenerate AI insights (Starter+ and an editor/admin role; a paid model call)" },
+  // Generated versions (persona x slot cells)
+  { name: "get_cell_matrix", access: "read", summary: 'The "Who sees what" matrix of generated versions per visitor type and region' },
+  { name: "get_cell_detail", access: "read", summary: "One cell's generated version, why it was written, and how it performs" },
+  { name: "generate_cell", access: "write", summary: "Queue AI generation for one cell \u2014 publishes automatically, or waits for approval when review mode is on" },
+  { name: "list_cell_reviews", access: "read", summary: "Generated versions waiting for approval (review mode)" },
+  { name: "review_cell", access: "write", summary: "Approve (publish) or reject one generated version waiting for review" },
+  // Agent traffic
+  { name: "get_agent_traffic", access: "read", summary: "Which AI crawlers, agentic browsers and agent API callers read the site (windowed)" },
+  { name: "get_agent_legibility", access: "read", summary: "Whether the pages agents read are machine-legible, with fixes" },
+  // Setup
+  { name: "get_integration_guide", access: "read", summary: "SDK setup guide (static \u2014 same for every project)" }
+];
+var TOOL_NAMES = TOOL_CATALOG.map((t) => t.name);
 export {
   ApiClient,
   ApiError,
   PUBLIC_UI_RESOURCE_URIS,
+  TOOL_CATALOG,
+  TOOL_NAMES,
   createMcpServer
 };

package/package.json

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