@getcheddar/cheddar-mcp 0.1.0

package/dist/tools/customers.js

@@ -0,0 +1,150 @@
+export const customerTools = [
+    {
+        name: "cheddar_customer_get",
+        description: "Retrieve a customer by their ID or code from Cheddar",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The customer ID (UUID) or unique customer code",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_customer_create",
+        description: "Create a new customer in Cheddar",
+        inputSchema: {
+            type: "object",
+            properties: {
+                code: {
+                    type: "string",
+                    description: "Unique customer code/identifier (required)",
+                },
+                firstName: {
+                    type: "string",
+                    description: "Customer's first name",
+                },
+                lastName: {
+                    type: "string",
+                    description: "Customer's last name",
+                },
+                email: {
+                    type: "string",
+                    description: "Customer's email address",
+                },
+                company: {
+                    type: "string",
+                    description: "Customer's company name",
+                },
+                notes: {
+                    type: "string",
+                    description: "Internal notes about the customer",
+                },
+                taxRate: {
+                    type: "string",
+                    description: "Tax rate to apply to this customer (e.g., '0.08' for 8%)",
+                },
+                isTaxExempt: {
+                    type: "boolean",
+                    description: "Whether the customer is tax exempt",
+                },
+                taxNumber: {
+                    type: "string",
+                    description: "Tax/VAT number for the customer",
+                },
+            },
+            required: ["code"],
+        },
+    },
+    {
+        name: "cheddar_customer_update",
+        description: "Update an existing customer's information in Cheddar",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The customer ID or code to update",
+                },
+                firstName: {
+                    type: "string",
+                    description: "Customer's first name",
+                },
+                lastName: {
+                    type: "string",
+                    description: "Customer's last name",
+                },
+                email: {
+                    type: "string",
+                    description: "Customer's email address",
+                },
+                company: {
+                    type: "string",
+                    description: "Customer's company name",
+                },
+                notes: {
+                    type: "string",
+                    description: "Internal notes about the customer",
+                },
+                taxRate: {
+                    type: "string",
+                    description: "Tax rate to apply to this customer",
+                },
+                isTaxExempt: {
+                    type: "boolean",
+                    description: "Whether the customer is tax exempt",
+                },
+                taxNumber: {
+                    type: "string",
+                    description: "Tax/VAT number for the customer",
+                },
+            },
+            required: ["id"],
+        },
+    },
+];
+export async function handleCustomerTool(client, name, args) {
+    switch (name) {
+        case "cheddar_customer_get": {
+            const { id } = args;
+            const customer = await client.getCustomer(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(customer, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_customer_create": {
+            const customer = await client.createCustomer(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Customer created successfully:\n${JSON.stringify(customer, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        case "cheddar_customer_update": {
+            const { id, ...updates } = args;
+            const customer = await client.updateCustomer(id, updates);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Customer updated successfully:\n${JSON.stringify(customer, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown customer tool: ${name}`);
+    }
+}
+//# sourceMappingURL=customers.js.map

package/dist/tools/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../../src/tools/customers.ts"],"names":[],"mappings":"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"}

package/dist/tools/payment-methods.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { CheddarApiClient } from "../lib/cheddar-client.js";
+export declare const paymentMethodTools: Tool[];
+export declare function handlePaymentMethodTool(client: CheddarApiClient, name: string, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=payment-methods.d.ts.map

package/dist/tools/payment-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-methods.d.ts","sourceRoot":"","sources":["../../src/tools/payment-methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB,EAAE,IAAI,EAuFpC,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqF7D"}

package/dist/tools/payment-methods.js

@@ -0,0 +1,162 @@
+export const paymentMethodTools = [
+    {
+        name: "cheddar_payment_method_get",
+        description: "Retrieve a payment method by its ID from Cheddar",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The payment method ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_payment_method_get_customer",
+        description: "Get the customer associated with a payment method",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The payment method ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_payment_method_get_gateway_account",
+        description: "Get the gateway account for a payment method",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The payment method ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_payment_token_create",
+        description: "Create a secure token for a payment method (PCI-compliant). This tokenizes card details and returns a nonce that can be used to add the payment method to a customer.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cardNumber: {
+                    type: "string",
+                    description: "Credit card number (will be tokenized, never stored)",
+                },
+                expirationDate: {
+                    type: "string",
+                    description: "Card expiration date in MM/YY or MM/YYYY format",
+                },
+                cvv: {
+                    type: "string",
+                    description: "Card security code/CVV",
+                },
+                cardholderName: {
+                    type: "string",
+                    description: "Name on the card (optional)",
+                },
+            },
+            required: ["cardNumber", "expirationDate", "cvv"],
+        },
+    },
+    {
+        name: "cheddar_payment_method_add_to_customer",
+        description: "Add a tokenized payment method to a customer. Requires a valid token from cheddar_payment_token_create.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customerId: {
+                    type: "string",
+                    description: "The customer ID or code to add the payment method to",
+                },
+                token: {
+                    type: "string",
+                    description: "The payment method token from create_payment_token",
+                },
+            },
+            required: ["customerId", "token"],
+        },
+    },
+];
+export async function handlePaymentMethodTool(client, name, args) {
+    switch (name) {
+        case "cheddar_payment_method_get": {
+            const { id } = args;
+            const paymentMethod = await client.getPaymentMethod(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(paymentMethod, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_payment_method_get_customer": {
+            const { id } = args;
+            const customer = await client.getPaymentMethodCustomer(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(customer, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_payment_method_get_gateway_account": {
+            const { id } = args;
+            const gatewayAccount = await client.getPaymentMethodGatewayAccount(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(gatewayAccount, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_payment_token_create": {
+            const { cardNumber, expirationDate, cvv, cardholderName } = args;
+            // Mask card number in response for security
+            const maskedCard = cardNumber.slice(-4).padStart(cardNumber.length, "*");
+            const token = await client.createPaymentMethodToken({
+                cardNumber,
+                expirationDate,
+                cvv,
+                cardholderName,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Payment token created for card ending in ${maskedCard.slice(-4)}:\n${JSON.stringify(token, null, 2)}\n\nThis token expires at: ${token.expiresAt}\nUse cheddar_payment_method_add_to_customer to attach this to a customer.`,
+                    },
+                ],
+            };
+        }
+        case "cheddar_payment_method_add_to_customer": {
+            const { customerId, token } = args;
+            const paymentMethod = await client.addPaymentMethodToCustomer(customerId, token);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Payment method added to customer successfully:\n${JSON.stringify(paymentMethod, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown payment method tool: ${name}`);
+    }
+}
+//# sourceMappingURL=payment-methods.js.map

package/dist/tools/payment-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-methods.js","sourceRoot":"","sources":["../../src/tools/payment-methods.ts"],"names":[],"mappings":"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"}

package/dist/tools/subscriptions.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { CheddarApiClient } from "../lib/cheddar-client.js";
+export declare const subscriptionTools: Tool[];
+export declare function handleSubscriptionTool(client: CheddarApiClient, name: string, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/tools/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/tools/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,iBAAiB,EAAE,IAAI,EAmGnC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgG7D"}

package/dist/tools/subscriptions.js

@@ -0,0 +1,191 @@
+export const subscriptionTools = [
+    {
+        name: "cheddar_subscription_get",
+        description: "Retrieve a subscription by its ID from Cheddar",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The subscription ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_subscription_get_customer",
+        description: "Get the customer associated with a subscription",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The subscription ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_subscription_get_plan",
+        description: "Get the plan associated with a subscription",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The subscription ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_subscription_get_payment_method",
+        description: "Get the payment method associated with a subscription",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The subscription ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_subscription_delete_promotion",
+        description: "Remove a promotional discount from a customer's subscription",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customerId: {
+                    type: "string",
+                    description: "The customer ID or code whose subscription promotion should be removed",
+                },
+            },
+            required: ["customerId"],
+        },
+    },
+    {
+        name: "cheddar_plan_get",
+        description: "Retrieve a plan by its ID or code from Cheddar",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The plan ID (UUID) or plan code",
+                },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "cheddar_gateway_account_get",
+        description: "Retrieve a gateway account by its ID from Cheddar",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "The gateway account ID (UUID)",
+                },
+            },
+            required: ["id"],
+        },
+    },
+];
+export async function handleSubscriptionTool(client, name, args) {
+    switch (name) {
+        case "cheddar_subscription_get": {
+            const { id } = args;
+            const subscription = await client.getSubscription(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(subscription, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_subscription_get_customer": {
+            const { id } = args;
+            const customer = await client.getSubscriptionCustomer(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(customer, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_subscription_get_plan": {
+            const { id } = args;
+            const plan = await client.getSubscriptionPlan(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(plan, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_subscription_get_payment_method": {
+            const { id } = args;
+            const paymentMethod = await client.getSubscriptionPaymentMethod(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(paymentMethod, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_subscription_delete_promotion": {
+            const { customerId } = args;
+            await client.deleteSubscriptionPromotion(customerId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Promotion removed from customer's subscription successfully.`,
+                    },
+                ],
+            };
+        }
+        case "cheddar_plan_get": {
+            const { id } = args;
+            const plan = await client.getPlan(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(plan, null, 2),
+                    },
+                ],
+            };
+        }
+        case "cheddar_gateway_account_get": {
+            const { id } = args;
+            const gatewayAccount = await client.getGatewayAccount(id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(gatewayAccount, null, 2),
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown subscription tool: ${name}`);
+    }
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/tools/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/tools/subscriptions.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAW;IACvC;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IACD;QACE,IAAI,EAAE,mCAAmC;QACzC,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IACD;QACE,IAAI,EAAE,yCAAyC;QAC/C,WAAW,EAAE,uDAAuD;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IACD;QACE,IAAI,EAAE,uCAAuC;QAC7C,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wEAAwE;iBACtF;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAwB,EACxB,IAAY,EACZ,IAAyC;IAEzC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,0BAA0B,CAAC,CAAC,CAAC;YAChC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YACtD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5C;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,mCAAmC,CAAC,CAAC,CAAC;YACzC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;YAC1D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACrC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;qBACpC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,yCAAyC,CAAC,CAAC,CAAC;YAC/C,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC7C;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,uCAAuC,CAAC,CAAC,CAAC;YAC7C,MAAM,EAAE,UAAU,EAAE,GAAG,IAA8B,CAAC;YACtD,MAAM,MAAM,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,8DAA8D;qBACrE;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;qBACpC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,6BAA6B,CAAC,CAAC,CAAC;YACnC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;YAC1D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC9C;iBACF;aACF,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@getcheddar/cheddar-mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Cheddar Payment Platform integration",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "cheddar-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "payments",
+    "subscription",
+    "billing",
+    "cheddar",
+    "ai",
+    "claude",
+    "cursor"
+  ],
+  "author": "Cheddar (chdr)",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.4",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0",
+    "eslint": "^8.55.0",
+    "prettier": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}