@sellhapi/mcp 0.1.3 → 0.1.5

package/dist/server.js

@@ -12,6 +12,7 @@ const studio_js_1 = require("./tools/studio.js");
 const commerce_js_1 = require("./tools/commerce.js");
 const content_js_1 = require("./tools/content.js");
 const intelligence_js_1 = require("./tools/intelligence.js");
+const analytics_js_1 = require("./tools/analytics.js");
 const index_js_1 = require("./resources/index.js");
 function createMcpServer() {
     const server = new mcp_js_1.McpServer({
@@ -22,6 +23,7 @@ function createMcpServer() {
     (0, commerce_js_1.registerCommerceTools)(server);
     (0, content_js_1.registerContentTools)(server);
     (0, intelligence_js_1.registerIntelligenceTools)(server);
+    (0, analytics_js_1.registerAnalyticsTools)(server);
     (0, index_js_1.registerResources)(server);
     return server;
 }

package/dist/tools/analytics.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Analytics tools — read-only access to pre-computed capability metrics.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAnalyticsTools(server: McpServer): void;

package/dist/tools/analytics.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Analytics tools — read-only access to pre-computed capability metrics.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAnalyticsTools = registerAnalyticsTools;
+const v4_1 = require("zod/v4");
+const client_js_1 = require("../client.js");
+const util_js_1 = require("../util.js");
+function registerAnalyticsTools(server) {
+    server.registerTool("get_analytics", {
+        title: "Get Analytics",
+        description: "Get pre-computed analytics for this vendor. Returns revenue, transaction counts, and other metrics per capability for a given period. Use this to answer questions like 'what's my revenue this month', 'which capability earns the most', or 'how many orders have I had'. Metrics are computed on a schedule — call this before making business recommendations.",
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            period: v4_1.z.enum(["7d", "30d", "90d"]).optional().default("30d").describe("Time period for metrics (default: 30d)"),
+        },
+    }, async ({ period }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)(`/api/mcp/analytics?period=${period}`);
+        return JSON.stringify(data, null, 2);
+    }));
+}

package/dist/tools/commerce.js

@@ -72,10 +72,58 @@ function registerCommerceTools(server) {
         const data = await (0, client_js_1.get)("/api/mcp/appointments/services");
         return JSON.stringify(data.services, null, 2);
     }));
+    // ── Discounts ─────────────────────────────────────────────────────────────
+    server.registerTool("list_discounts", {
+        title: "List Discounts",
+        description: "List all active discounts for this vendor. Returns id, name, code, discountType, value, scope, usage count, and expiry. Use this to check existing discounts before creating new ones.",
+        annotations: { readOnlyHint: true },
+    }, async () => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)("/api/mcp/discounts");
+        return JSON.stringify(data.discounts, null, 2);
+    }));
+    server.registerTool("create_discount", {
+        title: "Create Discount",
+        description: "Create a discount code or automatic discount. For percentage discounts, value is 1–100 (e.g. 20 = 20% off). For fixed discounts, value is in kobo (₦1 = 100 kobo) — the API converts to Naira internally. minimumOrderKobo is also in kobo. scope 'all_products' applies sitewide. 'specific_products' and 'specific_categories' require editing via the dashboard after creation. code is optional — omit for automatic (no-code) discounts.",
+        inputSchema: {
+            name: v4_1.z.string().describe("Internal discount name e.g. 'Lagos Launch 20% Off'"),
+            discountType: v4_1.z.enum(["percentage", "fixed"]).describe("percentage = % off, fixed = fixed Naira amount off"),
+            value: v4_1.z.number().describe("For percentage: 1–100. For fixed: amount in kobo (₦1 = 100 kobo)."),
+            code: v4_1.z.string().optional().describe("Discount code customers enter at checkout (e.g. 'LAUNCH20'). Omit for automatic discount."),
+            description: v4_1.z.string().optional().describe("Internal description"),
+            scope: v4_1.z.enum(["all_products", "specific_products", "specific_categories"]).optional().default("all_products").describe("Which products this applies to. specific_products/specific_categories require assigning products in the dashboard after creation."),
+            usageLimit: v4_1.z.number().int().min(1).optional().describe("Maximum total uses. Omit for unlimited."),
+            minimumOrderKobo: v4_1.z.number().int().min(0).optional().describe("Minimum cart total in kobo to qualify for this discount."),
+            expiresAt: v4_1.z.string().optional().describe("Expiry datetime — ISO 8601 string. Omit for no expiry."),
+            startsAt: v4_1.z.string().optional().describe("Start datetime — ISO 8601 string. Omit to activate immediately."),
+        },
+    }, async (input) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/discounts", input);
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Categories ────────────────────────────────────────────────────────────
+    server.registerTool("list_categories", {
+        title: "List Categories",
+        description: "List all product categories for this vendor. Call this before create_product or update_product to get valid categoryId values. Returns id, name, description for each category.",
+        annotations: { readOnlyHint: true },
+    }, async () => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)("/api/mcp/categories");
+        return JSON.stringify(data.categories, null, 2);
+    }));
+    server.registerTool("create_category", {
+        title: "Create Category",
+        description: "Create a product category. Returns the new category id — use it immediately in create_product or update_product. Returns a 409 conflict (with the existing id) if a category with the same name already exists — use that id instead of creating a duplicate.",
+        inputSchema: {
+            name: v4_1.z.string().describe("Category name e.g. 'Clothing', 'Baked Goods'"),
+            description: v4_1.z.string().optional().describe("Optional description"),
+        },
+    }, async (input) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/categories", input);
+        return JSON.stringify(data, null, 2);
+    }));
     // ── Write: Create product ─────────────────────────────────────────────────
     server.registerTool("create_product", {
         title: "Create Product",
-        description: "Create a physical or digital product. Call list_capabilities first to confirm the relevant capability (physical_products or digital_products) is active. Prices must be in kobo (₦1 = 100 kobo). imageUrl is optional — use an external URL if the vendor has one, or omit it.",
+        description: "Create a physical or digital product. Call list_capabilities first to confirm the relevant capability (physical_products or digital_products) is active. Call list_categories first to get a valid categoryId — supplying an invalid categoryId returns a 400 error. Prices must be in kobo (₦1 = 100 kobo). imageUrl is optional.",
         inputSchema: {
             name: v4_1.z.string().describe("Product name"),
             description: v4_1.z.string().optional().describe("Product description"),
@@ -83,11 +131,27 @@ function registerCommerceTools(server) {
             type: v4_1.z.enum(["physical", "digital"]).optional().default("physical").describe("Product type — physical (default) or digital"),
             stock: v4_1.z.number().int().min(0).optional().describe("Initial stock quantity (0 = out of stock). Omit for untracked stock."),
             imageUrl: v4_1.z.string().optional().describe("External image URL for the product"),
+            categoryId: v4_1.z.string().uuid().optional().describe("Category ID from list_categories. Omit if no category applies."),
         },
     }, async (input) => (0, util_js_1.safeCall)(async () => {
         const data = await (0, client_js_1.post)("/api/mcp/products", input);
         return JSON.stringify(data, null, 2);
     }));
+    // ── Write: Update product ─────────────────────────────────────────────────
+    server.registerTool("update_product", {
+        title: "Update Product",
+        description: "Update an existing product's name, description, category, or image. Call list_products to get the productId, list_categories to get a valid categoryId. Only fields provided are updated — omitted fields stay unchanged. Pass categoryId: null to remove the category.",
+        inputSchema: {
+            productId: v4_1.z.string().uuid().describe("Product ID from list_products"),
+            name: v4_1.z.string().optional().describe("New product name"),
+            description: v4_1.z.string().optional().describe("New product description"),
+            categoryId: v4_1.z.string().uuid().nullable().optional().describe("Category ID from list_categories, or null to remove category"),
+            imageUrl: v4_1.z.string().nullable().optional().describe("New image URL, or null to clear"),
+        },
+    }, async ({ productId, ...rest }) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.patch)(`/api/mcp/products/${productId}`, rest);
+        return JSON.stringify(data, null, 2);
+    }));
     // ── Write: Create event ───────────────────────────────────────────────────
     server.registerTool("create_event", {
         title: "Create Event",
@@ -181,13 +245,13 @@ function registerCommerceTools(server) {
     // ── Write: Create form ───────────────────────────────────────────────────
     server.registerTool("create_form", {
         title: "Create Form",
-        description: "Create a published storefront form. Returns the form ID — use it in useContentForm(formId) and useSubmitForm(formId) in storefront code. Call list_capabilities first to confirm content capability is active. Field types: text, email, phone, textarea, select, checkbox, date, number.",
+        description: "Create a published storefront form. Returns the form ID — use it in useContentForm(formId) and useSubmitForm(formId) in storefront code. Call list_capabilities first to confirm content capability is active. Field types: text, email, phone, textarea, select, radio, checkbox, date, number, file.",
         inputSchema: {
             title: v4_1.z.string().describe("Form name e.g. 'Contact Us'"),
             description: v4_1.z.string().optional(),
             fields: v4_1.z.array(v4_1.z.object({
                 label: v4_1.z.string().describe("Field label shown to the user"),
-                type: v4_1.z.enum(["text", "email", "phone", "textarea", "select", "checkbox", "date", "number"]).describe("Field input type"),
+                type: v4_1.z.enum(["text", "email", "phone", "textarea", "select", "radio", "checkbox", "date", "number", "file"]).describe("Field input type"),
                 required: v4_1.z.boolean().optional().default(false),
                 placeholder: v4_1.z.string().optional(),
                 options: v4_1.z.array(v4_1.z.string()).optional().describe("Options for select fields"),

package/dist/tools/studio.js

@@ -124,7 +124,7 @@ function registerStudioTools(server) {
     // ── Push code (zero credits) ───────────────────────────────────────────────
     server.registerTool("push_code", {
         title: "Push Code",
-        description: "Push client-generated React code to a project. Runs BuildGuard validation + esbuild bundling and returns a preview URL. ZERO AI credit cost — you generate the code, SellHapi only builds it. CRITICAL RULES: (1) import ONLY from @sellhapi/studio-runtime and react — NO external packages; (2) every top-level JSX section must have data-region, data-label, data-scope attributes; (3) NO inline style={{}} — use Tailwind only; (4) NO localStorage/sessionStorage for state management — EXCEPTION: window.location.href IS required and allowed for payment redirects (all commerce hooks return { paymentLink } — redirect with window.location.href = result.paymentLink); (5) prices via priceKobo / 100 — never hardcode currency. Call get_build_rules or get_runtime_hooks for full reference.",
+        description: "Push client-generated React code to a project. Runs BuildGuard validation + esbuild bundling and returns a preview URL. ZERO AI credit cost — you generate the code, SellHapi only builds it. CRITICAL RULES: (1) import ONLY from @sellhapi/studio-runtime and react — NO external packages; (2) every top-level JSX section must have data-region, data-label, data-scope attributes; (3) use inline React style objects for ALL styling — Tailwind is NOT available; (4) NO localStorage/sessionStorage for state management — EXCEPTION: window.location.href IS required and allowed for payment redirects (all commerce hooks return { paymentLink } — redirect with window.location.href = result.paymentLink); (5) prices via priceKobo / 100 — never hardcode currency. Call get_build_rules or get_runtime_hooks for full reference.",
         inputSchema: {
             projectId: v4_1.z.string().describe("Studio project ID"),
             files: v4_1.z.record(v4_1.z.string(), v4_1.z.string()).describe("Map of filename → code content. Must include App.tsx as entry point."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellhapi/mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "SellHapi MCP server — build and manage SellHapi storefronts from AI tools",
   "bin": {
     "sellhapi-mcp": "./dist/index.js"