@brander/mcp-tools 0.2.0

package/dist/server/tools/generate-screen-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-screen-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-screen-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+OxB,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIpC,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,2BAA2B,QAO8H,CAAC"}

package/dist/server/tools/generate-screen-schema.js

@@ -0,0 +1,227 @@
+/**
+ * Self-contained generate_screen Zod schema + tool description for the MCP server.
+ *
+ * All 14 element prop schemas are defined here so the compiled dist/server can run
+ * as a standalone Node.js server without depending on @brander/elements at runtime.
+ * (Avoids CJS/ESM interop issues — brander-elements is CJS but mcp-tools is ESM.)
+ */
+import { z } from "zod";
+// ============================================================================
+// ELEMENT PROP SCHEMAS (14 element types)
+// ============================================================================
+const headerPropsSchema = z.object({
+    title: z.string().describe("Main page title"),
+    subtitle: z.string().optional().describe("Page description or subtitle"),
+});
+const chatBubblePropsSchema = z.object({
+    text: z.string().describe("Response text content"),
+    markdown: z.boolean().optional().describe("Whether to render as markdown"),
+});
+const statsGridPropsSchema = z.object({
+    stats: z
+        .array(z.object({
+        id: z.string().describe("Unique stat identifier"),
+        title: z.string().describe("Stat title"),
+        value: z.string().describe("Main value"),
+        period: z.string().optional().describe("Period (This Month, This Year, etc.)"),
+        trend: z
+            .object({
+            direction: z.enum(["up", "down", "neutral"]),
+            percentage: z.string().describe("Trend percentage"),
+        })
+            .optional()
+            .describe("Trend direction"),
+        subtitle: z.string().optional().describe("Additional context"),
+    }))
+        .describe("Array of statistics (generate 4 if not requested differently)"),
+});
+const dataTablePropsSchema = z.object({
+    title: z.string().optional().describe("Table title"),
+    columns: z
+        .array(z.object({
+        key: z.string().describe("Column key"),
+        label: z.string().describe("Column label"),
+        type: z.enum(["text", "number", "status", "date", "currency", "boolean"]),
+        sortable: z.boolean().optional().describe("Whether column is sortable"),
+        filterable: z.boolean().optional().describe("Whether column is filterable"),
+    }))
+        .describe("Column definitions"),
+    rows: z
+        .array(z.looseObject({ id: z.string().describe("Unique row identifier") }))
+        .describe("Data rows"),
+    pageSize: z.number().optional().describe("Number of rows per page"),
+});
+const lineChartPropsSchema = z.object({
+    title: z.string().describe("Chart title"),
+    labels: z.array(z.string()).describe("X-axis labels (e.g., ['Jan', 'Feb', 'Mar'])"),
+    data: z.array(z.number()).describe("Chart data"),
+});
+const pieChartPropsSchema = z.object({
+    title: z.string().describe("Chart title"),
+    data: z
+        .array(z.object({
+        label: z.string().describe("Segment label"),
+        value: z.number().describe("Segment value"),
+        color: z.string().optional().describe("Segment color"),
+    }))
+        .describe("Pie chart segments"),
+});
+const barChartPropsSchema = z.object({
+    id: z.string().describe("Unique chart identifier"),
+    title: z.string().optional().describe("Chart title"),
+    categories: z.array(z.string()).describe("X-axis category labels"),
+    series: z
+        .array(z.object({
+        name: z.string().describe("Series name"),
+        data: z.array(z.number()).describe("Data values"),
+    }))
+        .describe("Data series (minimum 2 series)"),
+    stacked: z.boolean().optional().describe("Stack bars"),
+    showLegend: z.boolean().optional().describe("Display legend"),
+});
+const itemGridPropsSchema = z.object({
+    title: z.string().optional().describe("Grid title"),
+    items: z
+        .array(z.object({
+        id: z.string().describe("Item ID"),
+        title: z.string().describe("Item name"),
+        description: z.string().optional().describe("Item description"),
+        price: z.string().describe("Item price"),
+        image: z
+            .string()
+            .optional()
+            .describe("REAL image URL (e.g., https://images.unsplash.com/...)"),
+        category: z.string().optional().describe("Item category"),
+        rating: z.number().optional().describe("Rating score"),
+        stock: z.number().optional().describe("Stock quantity"),
+    }))
+        .describe("Grid items"),
+    pageSize: z.number().optional().describe("Number of items per page"),
+});
+const itemCardPropsSchema = z.object({
+    id: z.string().describe("Item ID"),
+    title: z.string().describe("Item name"),
+    subtitle: z.string().optional().describe("Brief description"),
+    image: z.string().optional().describe("Image URL"),
+    price: z.string().optional().describe("Item price with currency symbol (e.g., '99.99$')"),
+    category: z.string().optional().describe("Item category"),
+    stock: z.number().optional().describe("Number of items in stock"),
+    rating: z.number().optional().describe("Item rating (0-5)"),
+    description: z.string().optional().describe("Detailed description"),
+});
+const imagePropsSchema = z.object({
+    src: z.string().describe("Image source URL"),
+    alt: z.string().describe("Alt text for accessibility"),
+    title: z.string().optional().describe("Image title"),
+    caption: z.string().optional().describe("Image caption"),
+    width: z.number().optional().describe("Image width"),
+    height: z.number().optional().describe("Image height"),
+});
+const detailsDataPropsSchema = z.object({
+    items: z
+        .array(z.object({
+        id: z.string().describe("Item ID"),
+        title: z.string().describe("Section title"),
+        value: z.string().describe("Section value"),
+        type: z.enum(["text", "price", "status"]).describe("Section type"),
+        category: z.string().describe("Section category (REQUIRED for logical grouping)"),
+        color: z
+            .enum(["default", "primary", "secondary", "error", "info", "success", "warning"])
+            .optional()
+            .describe("Section color"),
+        variant: z.enum(["outlined", "filled"]).optional().describe("Section variant"),
+        size: z.enum(["small", "medium"]).optional().describe("Section size"),
+    }))
+        .describe("Data sections — minimum 4 per category if not otherwise requested"),
+});
+const formPropsSchema = z.object({
+    title: z.string().describe("Form title"),
+    description: z.string().optional().describe("Form description"),
+    fields: z
+        .array(z.object({
+        id: z.string().describe("Unique field ID"),
+        name: z.string().describe("Field name"),
+        label: z.string().describe("Field label"),
+        type: z.enum([
+            "text",
+            "email",
+            "date",
+            "amount",
+            "number",
+            "tel",
+            "select",
+            "textarea",
+            "checkbox",
+        ]),
+        required: z.boolean().optional().describe("Is field required"),
+        placeholder: z.string().optional().describe("Placeholder text"),
+        options: z.array(z.object({ value: z.string(), label: z.string() })).optional(),
+    }))
+        .describe("Form fields"),
+    submitButton: z
+        .object({
+        label: z.string().optional().describe("Button text"),
+        action: z.string().optional().describe("Submit action"),
+    })
+        .optional(),
+});
+const buttonPropsSchema = z.object({
+    id: z.string().describe("Unique button identifier"),
+    label: z.string().describe("Button text"),
+    variant: z.enum(["primary", "secondary", "tertiary"]).describe("Button style variant"),
+    type: z.enum(["action", "link"]).describe("Button behavior type"),
+    action: z.string().optional().describe("Query to send to AI (required if type is action)"),
+    url: z.string().optional().describe("External URL (required if type is link)"),
+    size: z.enum(["small", "medium", "large"]).optional().describe("Button size"),
+    disabled: z.boolean().optional().describe("Disabled state"),
+    startIcon: z.string().optional().describe("Icon name for start position"),
+    endIcon: z.string().optional().describe("Icon name for end position"),
+});
+const alertPropsSchema = z.object({
+    id: z.string().describe("Unique alert identifier"),
+    severity: z.enum(["success", "error", "warning", "info"]).describe("Alert severity level"),
+    title: z.string().optional().describe("Optional alert title/heading"),
+    message: z.string().describe("Main alert message"),
+    variant: z.enum(["standard", "outlined"]).optional().describe("Alert style variant"),
+    closeable: z.boolean().optional().describe("Show close button"),
+    showIcon: z.boolean().optional().describe("Display severity icon"),
+    actionText: z.string().optional().describe("Optional action button text"),
+    actionQuery: z.string().optional().describe("Query to send when action button clicked"),
+});
+// ============================================================================
+// SCREEN SCHEMA — discriminated union of all 14 element types
+// ============================================================================
+const clickQuery = z
+    .string()
+    .optional()
+    .describe("Optional query to send when this element is clicked");
+const screenElementSchema = z.discriminatedUnion("elementType", [
+    z.object({ elementType: z.literal("header"), props: headerPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("chat-bubble"), props: chatBubblePropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("stats-grid"), props: statsGridPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("data-table"), props: dataTablePropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("line-chart"), props: lineChartPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("pie-chart"), props: pieChartPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("bar-chart"), props: barChartPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("item-grid"), props: itemGridPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("item-card"), props: itemCardPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("image"), props: imagePropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("details-data"), props: detailsDataPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("form"), props: formPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("button"), props: buttonPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("alert"), props: alertPropsSchema, clickQuery }),
+]);
+/** Full input schema for the MCP `generate_screen` tool */
+export const generateScreenInputSchema = z.object({
+    elements: z
+        .array(screenElementSchema)
+        .describe("Ordered array of elements to render. Each element has an elementType and props."),
+});
+/** Tool description for generate_screen */
+export const GENERATE_SCREEN_DESCRIPTION = "**REQUIRED FOR ALL VISUAL RESPONSES** - Render branded, interactive UI components. " +
+    "You MUST use this tool instead of writing React code for dashboards, data tables, charts, stats, or any visual content. " +
+    "Provide an ordered array of elements: for dashboards use header + stats-grid + data-table + charts; " +
+    "for simple text use chat-bubble. For clickable elements, add a `clickQuery` with placeholders [field] for dynamic values. " +
+    "Example: clickQuery: 'Show detailed analytics for [title] including sales trends and inventory'. " +
+    "Use [title], [id], [name] placeholders that will be filled when user clicks. DO NOT write React code - use this tool. " +
+    "Available elements: header, chat-bubble, stats-grid, data-table, line-chart, pie-chart, bar-chart, item-grid, item-card, image, details-data, form, button, alert.";

package/dist/server/tools/tool-handler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool handler — creates the MCP handler for the single generate_screen tool.
+ */
+import { ProjectConfig } from "../brand/brand-types.js";
+import { ToolHandlerResult, ApiConfig } from "../types/mcp-types.js";
+/**
+ * Create the handler for the generate_screen tool.
+ * Accepts an array of elements and returns them as a composed screen.
+ */
+export declare function createScreenHandler(projectConfig: ProjectConfig, apiConfig?: ApiConfig): (input: Record<string, unknown>) => ToolHandlerResult;
+//# sourceMappingURL=tool-handler.d.ts.map

package/dist/server/tools/tool-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAKxD,OAAO,EAAE,iBAAiB,EAAiB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAmBpF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,SAAS,GACpB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,iBAAiB,CAoEvD"}

package/dist/server/tools/tool-handler.js

@@ -0,0 +1,83 @@
+/**
+ * Tool handler — creates the MCP handler for the single generate_screen tool.
+ */
+import { getClickBehavior } from "../elements/click-behaviors.js";
+import { buildContentSummary } from "../elements/element-functions.js";
+import { RESOURCE_URI } from "../resource/resource-registry.js";
+import { ElementType } from "../types/element-types.js";
+import { getElementDefinition } from "./element-definitions.js";
+/** Build _meta with resource URI and optional CSP connect domains */
+function buildMeta(apiConfig) {
+    const meta = {
+        ui: { resourceUri: RESOURCE_URI },
+        "ui/resourceUri": RESOURCE_URI,
+    };
+    if (apiConfig) {
+        meta.ui.csp = {
+            connectDomains: [new URL(apiConfig.apiBaseUrl).origin],
+        };
+    }
+    return meta;
+}
+/**
+ * Create the handler for the generate_screen tool.
+ * Accepts an array of elements and returns them as a composed screen.
+ */
+export function createScreenHandler(projectConfig, apiConfig) {
+    const meta = buildMeta(apiConfig);
+    const { brandSettings } = projectConfig;
+    return (input) => {
+        const rawElements = input.elements || [];
+        if (rawElements.length === 0) {
+            return {
+                content: [{ type: "text", text: "Failed to render screen: no elements provided." }],
+                structuredContent: {
+                    elementType: ElementType.SCREEN,
+                    elements: [],
+                    brandSettings,
+                    projectSettings: projectConfig.settings,
+                    screenVisibility: projectConfig.screenVisibility,
+                    customScreens: projectConfig.customScreens,
+                    apiConfig,
+                },
+                _meta: meta,
+            };
+        }
+        // Build screen elements with click behaviors
+        const elements = rawElements.map((raw) => {
+            const elType = raw.elementType;
+            const def = getElementDefinition(elType);
+            const behavior = getClickBehavior(elType);
+            return {
+                elementType: elType,
+                props: raw.props,
+                clickQuery: raw.clickQuery, // AI-generated query (preferred)
+                clickBehavior: {
+                    queryTemplate: behavior?.queryTemplate ?? null,
+                    entityName: def?.name ?? raw.elementType,
+                }, // Fallback template system
+            };
+        });
+        // Build text summary — per-element summaries joined
+        const summaries = elements.map((el) => {
+            const def = getElementDefinition(el.elementType);
+            return buildContentSummary(el.elementType, el.props) || def?.name || el.elementType;
+        });
+        const summary = elements.length === 1
+            ? summaries[0]
+            : `Rendered screen with ${elements.length} elements:\n${summaries.map((s) => `  - ${s}`).join("\n")}`;
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: {
+                elementType: ElementType.SCREEN,
+                elements,
+                brandSettings,
+                projectSettings: projectConfig.settings,
+                screenVisibility: projectConfig.screenVisibility,
+                customScreens: projectConfig.customScreens,
+                apiConfig,
+            },
+            _meta: meta,
+        };
+    };
+}

package/dist/server/tools/tool-registry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tool registration — registers the single generate_screen tool with the MCP server.
+ *
+ * Uses the high-level McpServer.registerTool() API for composability — customers
+ * can register their own tools alongside BranderUX tools on the same server.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ProjectConfig } from "../brand/brand-types.js";
+import { ApiConfig } from "../types/mcp-types.js";
+/**
+ * Register the BranderUX generate_screen tool with the MCP server.
+ * Single tool that renders 1-N branded elements in a composed screen.
+ */
+export declare function registerTools(server: McpServer, projectConfig: ProjectConfig, apiConfig?: ApiConfig): void;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/server/tools/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMlD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,SAAS,GACpB,IAAI,CAuBN"}

package/dist/server/tools/tool-registry.js

@@ -0,0 +1,30 @@
+/**
+ * Tool registration — registers the single generate_screen tool with the MCP server.
+ *
+ * Uses the high-level McpServer.registerTool() API for composability — customers
+ * can register their own tools alongside BranderUX tools on the same server.
+ */
+import { generateScreenInputSchema, GENERATE_SCREEN_DESCRIPTION, } from "./generate-screen-schema.js";
+import { createScreenHandler } from "./tool-handler.js";
+import { RESOURCE_URI } from "../resource/resource-registry.js";
+const TOOL_NAME = "generate_screen";
+/**
+ * Register the BranderUX generate_screen tool with the MCP server.
+ * Single tool that renders 1-N branded elements in a composed screen.
+ */
+export function registerTools(server, projectConfig, apiConfig) {
+    const handler = createScreenHandler(projectConfig, apiConfig);
+    server.registerTool(TOOL_NAME, {
+        description: GENERATE_SCREEN_DESCRIPTION,
+        inputSchema: generateScreenInputSchema,
+        _meta: {
+            ui: { resourceUri: RESOURCE_URI },
+            "ui/resourceUri": RESOURCE_URI,
+        },
+    }, async (args) => {
+        // The SDK validates + parses against generateScreenInputSchema,
+        // but our handler expects Record<string, unknown>
+        return handler(args);
+    });
+    console.error(`Registered BranderUX tool: ${TOOL_NAME} ` + `(14 element types, resource: ${RESOURCE_URI})`);
+}

package/dist/server/types/element-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Standalone Element types — no imports from main app.
+ * Mirrors types/element-types.ts ElementType enum.
+ */
+export declare enum ElementType {
+    HEADER = "header",
+    STATS_GRID = "stats-grid",
+    DATA_TABLE = "data-table",
+    LINE_CHART = "line-chart",
+    PIE_CHART = "pie-chart",
+    ITEM_GRID = "item-grid",
+    ITEM_CARD = "item-card",
+    IMAGE = "image",
+    DETAILS_DATA = "details-data",
+    CHAT_BUBBLE = "chat-bubble",
+    FORM = "form",
+    BUTTON = "button",
+    BAR_CHART = "bar-chart",
+    ALERT = "alert",
+    SCREEN = "screen"
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface ElementDefinition {
+    id: ElementType;
+    name: string;
+    description: string;
+    toolSchema: ToolSchema;
+}
+//# sourceMappingURL=element-types.d.ts.map

package/dist/server/types/element-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-types.d.ts","sourceRoot":"","sources":["../../../src/types/element-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB"}

package/dist/server/types/element-types.js

@@ -0,0 +1,22 @@
+/**
+ * Standalone Element types — no imports from main app.
+ * Mirrors types/element-types.ts ElementType enum.
+ */
+export var ElementType;
+(function (ElementType) {
+    ElementType["HEADER"] = "header";
+    ElementType["STATS_GRID"] = "stats-grid";
+    ElementType["DATA_TABLE"] = "data-table";
+    ElementType["LINE_CHART"] = "line-chart";
+    ElementType["PIE_CHART"] = "pie-chart";
+    ElementType["ITEM_GRID"] = "item-grid";
+    ElementType["ITEM_CARD"] = "item-card";
+    ElementType["IMAGE"] = "image";
+    ElementType["DETAILS_DATA"] = "details-data";
+    ElementType["CHAT_BUBBLE"] = "chat-bubble";
+    ElementType["FORM"] = "form";
+    ElementType["BUTTON"] = "button";
+    ElementType["BAR_CHART"] = "bar-chart";
+    ElementType["ALERT"] = "alert";
+    ElementType["SCREEN"] = "screen";
+})(ElementType || (ElementType = {}));

package/dist/server/types/mcp-types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * MCP-specific helper types for the BranderUX MCP server.
+ */
+import { ElementType } from "./element-types.js";
+import { BrandSettings, ProjectSettings, ScreenVisibilityMap, CustomScreen } from "../brand/brand-types.js";
+/** API configuration for app-side query enhancement */
+export interface ApiConfig {
+    apiBaseUrl: string;
+    betaKey: string;
+    projectId: string;
+}
+/** Screen element entry within a composed screen */
+export interface ScreenElement {
+    elementType: ElementType;
+    props: Record<string, unknown>;
+    clickQuery?: string;
+    clickBehavior: {
+        queryTemplate: string | null;
+        entityName: string;
+    };
+}
+/** structuredContent shape — always a screen with 1-N elements */
+export interface ScreenStructuredContent {
+    elementType: ElementType.SCREEN;
+    elements: ScreenElement[];
+    brandSettings: BrandSettings;
+    projectSettings?: ProjectSettings;
+    screenVisibility?: ScreenVisibilityMap;
+    customScreens?: CustomScreen[];
+    apiConfig?: ApiConfig;
+    /** Index signature required by MCP SDK CallToolResult.structuredContent */
+    [key: string]: unknown;
+}
+/** Tool handler result shape matching MCP SDK CallToolResult */
+export interface ToolHandlerResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: ScreenStructuredContent;
+    _meta: {
+        ui: {
+            resourceUri: string;
+        };
+        /** Legacy key for older hosts */
+        "ui/resourceUri": string;
+        [key: string]: unknown;
+    };
+    /** Index signature required by MCP SDK CallToolResult */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=mcp-types.d.ts.map

package/dist/server/types/mcp-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-types.d.ts","sourceRoot":"","sources":["../../../src/types/mcp-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,YAAY,EACb,MAAM,yBAAyB,CAAC;AAEjC,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE;QACb,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,kEAAkE;AAClE,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2EAA2E;IAC3E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,KAAK,EAAE;QACL,EAAE,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,iCAAiC;QACjC,gBAAgB,EAAE,MAAM,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,yDAAyD;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/server/types/mcp-types.js

@@ -0,0 +1,4 @@
+/**
+ * MCP-specific helper types for the BranderUX MCP server.
+ */
+export {};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@brander/mcp-tools",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "BranderUX MCP Tools — Add branded interactive UI to any MCP server",
+  "main": "dist/server/lib-entry.js",
+  "types": "dist/server/lib-entry.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/server/lib-entry.js",
+      "types": "./dist/server/lib-entry.d.ts"
+    },
+    "./standalone": {
+      "import": "./dist/server/index.js",
+      "types": "./dist/server/index.d.ts"
+    }
+  },
+  "bin": {
+    "brander-mcp": "./dist/server/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build:app": "vite build",
+    "build:server": "tsc -p tsconfig.json",
+    "build": "npm run build:app && npm run build:server",
+    "dev": "tsx --watch src/index.ts",
+    "clean": "rm -rf dist",
+    "rebuild": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@brander/elements": "file:../brander-elements",
+    "@emotion/react": "^11.11.0",
+    "@emotion/styled": "^11.11.0",
+    "@mui/material": "^6.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "lucide-react": "^0.453.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "recharts": "^2.12.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.4",
+    "vite": "^6.0.0",
+    "vite-plugin-singlefile": "^2.0.0"
+  }
+}