@sellhapi/mcp 0.1.4 → 0.1.6

package/dist/server.js

@@ -13,6 +13,7 @@ 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 invoices_js_1 = require("./tools/invoices.js");
 const index_js_1 = require("./resources/index.js");
 function createMcpServer() {
     const server = new mcp_js_1.McpServer({
@@ -24,6 +25,7 @@ function createMcpServer() {
     (0, content_js_1.registerContentTools)(server);
     (0, intelligence_js_1.registerIntelligenceTools)(server);
     (0, analytics_js_1.registerAnalyticsTools)(server);
+    (0, invoices_js_1.registerInvoiceTools)(server);
     (0, index_js_1.registerResources)(server);
     return server;
 }

package/dist/tools/commerce.js

@@ -72,6 +72,34 @@ 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",

package/dist/tools/invoices.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Invoice tools — create and list custom, service, and appointment invoices.
+ * All three invoice types are vendor-initiated: the vendor creates the invoice
+ * and sends the payment link to the customer.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerInvoiceTools(server: McpServer): void;

package/dist/tools/invoices.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Invoice tools — create and list custom, service, and appointment invoices.
+ * All three invoice types are vendor-initiated: the vendor creates the invoice
+ * and sends the payment link to the customer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInvoiceTools = registerInvoiceTools;
+const v4_1 = require("zod/v4");
+const client_js_1 = require("../client.js");
+const util_js_1 = require("../util.js");
+function registerInvoiceTools(server) {
+    // ── List all invoices ─────────────────────────────────────────────────────
+    server.registerTool("list_invoices", {
+        title: "List Invoices",
+        description: "List all invoices across all types (custom, service, appointment). Returns the most recent 50 of each type with id, type, status, isPaid, recipient, link, and createdAt. Use this to check existing invoices before creating new ones.",
+        annotations: { readOnlyHint: true },
+    }, async () => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.get)("/api/mcp/invoices");
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Create custom invoice ─────────────────────────────────────────────────
+    server.registerTool("create_custom_invoice", {
+        title: "Create Custom Invoice",
+        description: "Create a free-form invoice with custom line items for any recipient. Returns a payment link (/ci/:id) that you can share with the customer. Line item prices are in kobo (₦1 = 100 kobo). Recipient must have at least an email or phone.",
+        inputSchema: {
+            title: v4_1.z.string().describe("Invoice title e.g. 'Website Design Project'"),
+            lineItems: v4_1.z.array(v4_1.z.object({
+                description: v4_1.z.string().describe("Line item description e.g. 'Logo Design'"),
+                qty: v4_1.z.number().int().min(1).describe("Quantity"),
+                unitPriceKobo: v4_1.z.number().int().min(0).describe("Unit price in kobo"),
+            })).min(1).describe("Invoice line items — at least one required"),
+            recipient: v4_1.z.object({
+                name: v4_1.z.string().describe("Recipient full name"),
+                email: v4_1.z.string().optional().describe("Recipient email"),
+                phone: v4_1.z.string().optional().describe("Recipient phone (Nigerian format, e.g. 08012345678)"),
+            }).describe("Invoice recipient — must have at least email or phone"),
+            notes: v4_1.z.string().optional().describe("Internal notes or payment terms shown on the invoice"),
+        },
+    }, async (input) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/invoices/custom", input);
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Create service invoice ────────────────────────────────────────────────
+    server.registerTool("create_service_invoice", {
+        title: "Create Service Invoice",
+        description: "Create an invoice for a specific service listing. Call list_service_listings first to get a valid serviceListingId. Returns a payment link (/service-invoices/:id) the customer can pay online. The price you set overrides the listing's default price — use this for custom quotes.",
+        inputSchema: {
+            serviceListingId: v4_1.z.string().uuid().describe("Service listing ID from list_service_listings"),
+            priceKobo: v4_1.z.number().int().min(0).describe("Invoice price in kobo (can differ from listing's base price)"),
+            recipient: v4_1.z.object({
+                name: v4_1.z.string().describe("Recipient full name"),
+                email: v4_1.z.string().optional().describe("Recipient email"),
+                phone: v4_1.z.string().optional().describe("Recipient phone (Nigerian format)"),
+            }).describe("Invoice recipient — must have at least email or phone"),
+            notes: v4_1.z.string().optional().describe("Notes or scope of work for this engagement"),
+        },
+    }, async (input) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/invoices/service", input);
+        return JSON.stringify(data, null, 2);
+    }));
+    // ── Create appointment invoice ────────────────────────────────────────────
+    server.registerTool("create_appointment_invoice", {
+        title: "Create Appointment Invoice",
+        description: "Create an invoice for an appointment service (schedule-later mode). The customer pays first via the payment link (/appointment-invoices/:id), then you assign a specific time slot from the Appointments dashboard. Call list_appointment_services first to get a valid serviceId.",
+        inputSchema: {
+            serviceId: v4_1.z.string().uuid().describe("Appointment service ID from list_appointment_services"),
+            priceKobo: v4_1.z.number().int().min(0).describe("Invoice price in kobo"),
+            recipient: v4_1.z.object({
+                name: v4_1.z.string().describe("Recipient full name"),
+                email: v4_1.z.string().optional().describe("Recipient email"),
+                phone: v4_1.z.string().optional().describe("Recipient phone (Nigerian format)"),
+            }).describe("Invoice recipient — must have at least email or phone"),
+            notes: v4_1.z.string().optional().describe("Additional notes for the appointment"),
+        },
+    }, async (input) => (0, util_js_1.safeCall)(async () => {
+        const data = await (0, client_js_1.post)("/api/mcp/invoices/appointment", input);
+        return JSON.stringify(data, null, 2);
+    }));
+}

package/package.json

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