@sellhapi/mcp 0.1.5 → 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/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.5",
+  "version": "0.1.6",
   "description": "SellHapi MCP server — build and manage SellHapi storefronts from AI tools",
   "bin": {
     "sellhapi-mcp": "./dist/index.js"