@getcheddar/cheddar-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cheddar (chdr)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# Cheddar MCP Server
+
+A Model Context Protocol (MCP) server for integrating with the Cheddar Payment Platform. This server provides AI assistants with tools to manage customers, payment methods, subscriptions, and generate checkout integration code.
+
+## Features
+
+- **Customer Management**: Create, read, and update customers
+- **Payment Methods**: Tokenize cards and manage payment methods (PCI-compliant)
+- **Subscriptions**: View subscription details and manage promotions
+- **Checkout Integration**: Generate hosted checkout URLs and embedded form code
+- **Code Generation**: Produce framework-specific integration code (React, Vue, Next.js, Vanilla JS)
+- **Webhook Handling**: Validate and configure webhook endpoints
+
+## Installation
+
+### Option 1: Run with npx (Recommended)
+
+```bash
+npx @chdr/cheddar-mcp
+```
+
+### Option 2: Install globally
+
+```bash
+npm install -g @chdr/cheddar-mcp
+cheddar-mcp
+```
+
+### Option 3: Docker
+
+```bash
+docker run -i --rm \
+  -e CHEDDAR_API_URL=https://api.cheddar.com \
+  -e CHEDDAR_ACCESS_TOKEN=your_token \
+  chdr/cheddar-mcp
+```
+
+## Configuration
+
+Set the following environment variables:
+
+| Variable                | Required | Description                                                |
+| ----------------------- | -------- | ---------------------------------------------------------- |
+| `CHEDDAR_API_URL`       | Yes      | The Cheddar API base URL (e.g., `https://api.cheddar.com`) |
+| `CHEDDAR_ACCESS_TOKEN`  | Yes\*    | Your OAuth2 access token                                   |
+| `CHEDDAR_CLIENT_ID`     | Yes\*    | Your OAuth2 client ID                                      |
+| `CHEDDAR_CLIENT_SECRET` | Yes\*    | Your OAuth2 client secret                                  |
+
+\*Either `CHEDDAR_ACCESS_TOKEN` OR all OAuth2 credentials are required.
+
+### Getting Credentials
+
+1. Log into your Cheddar dashboard
+2. Go to Settings > API Keys
+3. Generate OAuth2 credentials
+4. Use the Client ID and Client Secret to obtain an access token
+
+## Usage with Claude Desktop
+
+Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%/Claude/claude_desktop_config.json` on Windows):
+
+```json
+{
+  "mcpServers": {
+    "cheddar": {
+      "command": "npx",
+      "args": ["-y", "@chdr/cheddar-mcp"],
+      "env": {
+        "CHEDDAR_API_URL": "https://api.cheddar.com",
+        "CHEDDAR_ACCESS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+## Usage with Cursor
+
+1. Open Cursor Settings
+2. Navigate to Features > MCP
+3. Add a new MCP server with:
+   - Name: `cheddar`
+   - Command: `npx -y @chdr/cheddar-mcp`
+   - Set environment variables in your shell or prepend them
+
+## Available Tools
+
+### Customer Management
+
+| Tool                      | Description                       |
+| ------------------------- | --------------------------------- |
+| `cheddar_customer_get`    | Retrieve a customer by ID or code |
+| `cheddar_customer_create` | Create a new customer             |
+| `cheddar_customer_update` | Update customer information       |
+
+### Payment Methods
+
+| Tool                                         | Description                              |
+| -------------------------------------------- | ---------------------------------------- |
+| `cheddar_payment_method_get`                 | Retrieve a payment method by ID          |
+| `cheddar_payment_method_get_customer`        | Get customer from payment method         |
+| `cheddar_payment_method_get_gateway_account` | Get gateway account for payment method   |
+| `cheddar_payment_token_create`               | Tokenize card data (PCI-compliant)       |
+| `cheddar_payment_method_add_to_customer`     | Add tokenized payment method to customer |
+
+### Subscriptions & Plans
+
+| Tool                                      | Description                          |
+| ----------------------------------------- | ------------------------------------ |
+| `cheddar_subscription_get`                | Retrieve subscription by ID          |
+| `cheddar_subscription_get_customer`       | Get customer from subscription       |
+| `cheddar_subscription_get_plan`           | Get plan from subscription           |
+| `cheddar_subscription_get_payment_method` | Get payment method from subscription |
+| `cheddar_subscription_delete_promotion`   | Remove promotion from subscription   |
+| `cheddar_plan_get`                        | Retrieve plan by ID or code          |
+| `cheddar_gateway_account_get`             | Get gateway account details          |
+
+### Checkout Integration
+
+| Tool                                         | Description                          |
+| -------------------------------------------- | ------------------------------------ |
+| `cheddar_checkout_generate_hosted_url`       | Generate hosted checkout page URL    |
+| `cheddar_checkout_generate_embedded_form`    | Generate embedded checkout form code |
+| `cheddar_checkout_generate_integration_code` | Generate framework-specific code     |
+| `cheddar_checkout_validate_webhook`          | Validate webhook signature           |
+| `cheddar_checkout_configure_webhook`         | Generate webhook handler code        |
+
+## Example Usage
+
+### Get a Customer
+
+```
+Use the cheddar_customer_get tool with ID "cust_12345"
+```
+
+### Create a Payment Method Token
+
+```
+Use the cheddar_payment_token_create tool with:
+- cardNumber: "4111111111111111"
+- expirationDate: "12/25"
+- cvv: "123"
+- cardholderName: "John Doe"
+```
+
+### Generate React Integration
+
+```
+Use the cheddar_checkout_generate_integration_code tool with:
+- framework: "react"
+- integrationType: "embedded"
+- features: ["card", "subscriptions"]
+- styling: "tailwind"
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/chdr/cheddar-ai-tools.git
+cd cheddar-ai-tools/packages/cheddar-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in development mode
+npm run dev
+
+# Test
+npm test
+```
+
+## License
+
+MIT © Cheddar (chdr)
+
+## Support
+
+- Documentation: https://docs.cheddar.com
+- Support: support@cheddar.com
+- Issues: https://github.com/chdr/cheddar-ai-tools/issues

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,87 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CheddarApiClient } from "./lib/cheddar-client.js";
+import { customerTools, handleCustomerTool } from "./tools/customers.js";
+import { paymentMethodTools, handlePaymentMethodTool } from "./tools/payment-methods.js";
+import { subscriptionTools, handleSubscriptionTool } from "./tools/subscriptions.js";
+import { checkoutTools, handleCheckoutTool } from "./tools/checkout.js";
+// Configuration from environment
+const config = {
+    apiUrl: process.env.CHEDDAR_API_URL || "https://api.chdr.dev",
+    clientId: process.env.CHEDDAR_CLIENT_ID || "",
+    clientSecret: process.env.CHEDDAR_CLIENT_SECRET || "",
+    accessToken: process.env.CHEDDAR_ACCESS_TOKEN || "",
+};
+// Validate required config
+if (!config.accessToken && (!config.clientId || !config.clientSecret)) {
+    console.error("Error: CHEDDAR_ACCESS_TOKEN or both CHEDDAR_CLIENT_ID and CHEDDAR_CLIENT_SECRET must be set");
+    process.exit(1);
+}
+// Initialize Cheddar API client
+const cheddarClient = new CheddarApiClient(config);
+// Combine all tools
+const ALL_TOOLS = [
+    ...customerTools,
+    ...paymentMethodTools,
+    ...subscriptionTools,
+    ...checkoutTools,
+];
+// Create MCP server
+const server = new Server({
+    name: "cheddar-mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handler for listing available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: ALL_TOOLS,
+    };
+});
+// Handler for tool execution
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        // Route to appropriate handler based on tool name prefix
+        if (name.startsWith("cheddar_customer_")) {
+            return await handleCustomerTool(cheddarClient, name, args);
+        }
+        if (name.startsWith("cheddar_payment_")) {
+            return await handlePaymentMethodTool(cheddarClient, name, args);
+        }
+        if (name.startsWith("cheddar_subscription_")) {
+            return await handleSubscriptionTool(cheddarClient, name, args);
+        }
+        if (name.startsWith("cheddar_checkout_")) {
+            return await handleCheckoutTool(cheddarClient, name, args);
+        }
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Cheddar MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/cheddar-client.d.ts

@@ -0,0 +1,111 @@
+export interface CheddarConfig {
+    apiUrl: string;
+    clientId?: string;
+    clientSecret?: string;
+    accessToken?: string;
+}
+export interface Customer {
+    id: string;
+    code: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    company?: string;
+    notes?: string;
+    taxRate?: string;
+    isTaxExempt?: boolean;
+    taxNumber?: string;
+    createdDatetime: string;
+}
+export interface PaymentMethod {
+    id: string;
+    type: "CreditCard" | "PayPalPreapproval" | "PayPalBillingAgreement" | "External";
+    gatewayAccountId: string;
+    isPrimary: boolean;
+    isActive: boolean;
+    createdDatetime: string;
+    card?: {
+        lastFour: string;
+        cardType?: string;
+        expirationDate?: string;
+    };
+    paypal?: {
+        email?: string;
+    };
+}
+export interface PaymentMethodToken {
+    token: string;
+    expiresAt: string;
+}
+export interface Subscription {
+    id: string;
+    customerId: string;
+    planId: string;
+    paymentMethodId?: string;
+    status: "active" | "canceled" | "expired" | "pending";
+    startDate?: string;
+    endDate?: string;
+    nextBillDate?: string;
+    createdDatetime: string;
+}
+export interface Plan {
+    id: string;
+    code: string;
+    name?: string;
+    description?: string;
+    isActive: boolean;
+    setupChargeAmount?: string;
+    recurringChargeAmount?: string;
+    trialDays?: number;
+    billingFrequency?: string;
+    billingFrequencyQuantity?: number;
+    billingFrequencyUnit?: string;
+    createdDatetime: string;
+}
+export interface Product {
+    id: string;
+    code: string;
+    name?: string;
+    country?: string;
+    currency?: string;
+    createdDatetime: string;
+}
+export interface GatewayAccount {
+    id: string;
+    gateway: string;
+    isActive: boolean;
+    isPrimary: boolean;
+    createdDatetime: string;
+}
+export declare class CheddarApiClient {
+    private config;
+    private baseUrl;
+    constructor(config: CheddarConfig);
+    private getAuthHeaders;
+    private request;
+    getCustomer(id: string): Promise<Customer>;
+    createCustomer(customerData: Partial<Customer>): Promise<Customer>;
+    updateCustomer(id: string, updates: Partial<Customer>): Promise<Customer>;
+    getPaymentMethod(id: string): Promise<PaymentMethod>;
+    getPaymentMethodCustomer(id: string): Promise<Customer>;
+    getPaymentMethodGatewayAccount(id: string): Promise<GatewayAccount>;
+    createPaymentMethodToken(paymentData: {
+        cardNumber: string;
+        expirationDate: string;
+        cvv: string;
+        cardholderName?: string;
+    }): Promise<PaymentMethodToken>;
+    addPaymentMethodToCustomer(customerId: string, token: string): Promise<PaymentMethod>;
+    getSubscription(id: string): Promise<Subscription>;
+    getSubscriptionCustomer(id: string): Promise<Customer>;
+    getSubscriptionPlan(id: string): Promise<Plan>;
+    getSubscriptionPaymentMethod(id: string): Promise<PaymentMethod>;
+    deleteSubscriptionPromotion(customerId: string): Promise<void>;
+    getProduct(): Promise<Product>;
+    getPlan(id: string): Promise<Plan>;
+    getGatewayAccount(id: string): Promise<GatewayAccount>;
+    ping(): Promise<{
+        ack: number;
+    }>;
+}
+//# sourceMappingURL=cheddar-client.d.ts.map

package/dist/lib/cheddar-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cheddar-client.d.ts","sourceRoot":"","sources":["../../src/lib/cheddar-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,mBAAmB,GAAG,wBAAwB,GAAG,UAAU,CAAC;IACjF,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IAExB,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,aAAa;YAKnB,cAAc;YAcd,OAAO;IA0Bf,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1C,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIlE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMzE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvD,8BAA8B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAInE,wBAAwB,CAAC,WAAW,EAAE;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWzB,0BAA0B,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC;IAUnB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlD,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhE,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAM9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlC,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMtD,IAAI,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAGvC"}

package/dist/lib/cheddar-client.js

@@ -0,0 +1,101 @@
+// Cheddar API Client - wraps the REST API for the MCP server
+export class CheddarApiClient {
+    config;
+    baseUrl;
+    constructor(config) {
+        this.config = config;
+        this.baseUrl = config.apiUrl.replace(/\/$/, "");
+    }
+    async getAuthHeaders() {
+        // If access token is provided directly, use it
+        if (this.config.accessToken) {
+            return {
+                Authorization: `Bearer ${this.config.accessToken}`,
+                "Content-Type": "application/json",
+            };
+        }
+        // Otherwise, implement OAuth2 token fetch
+        // Note: In production, you'd want to cache and refresh tokens
+        throw new Error("OAuth2 token refresh not yet implemented. Please provide CHEDDAR_ACCESS_TOKEN.");
+    }
+    async request(method, path, body) {
+        const headers = await this.getAuthHeaders();
+        const url = `${this.baseUrl}${path}`;
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Cheddar API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    // ==================== Customer Operations ====================
+    async getCustomer(id) {
+        return this.request("GET", `/customer/${encodeURIComponent(id)}`);
+    }
+    async createCustomer(customerData) {
+        return this.request("POST", "/customer", customerData);
+    }
+    async updateCustomer(id, updates) {
+        return this.request("PATCH", `/customer/${encodeURIComponent(id)}`, updates);
+    }
+    // ==================== Payment Method Operations ====================
+    async getPaymentMethod(id) {
+        return this.request("GET", `/payment-method/${encodeURIComponent(id)}`);
+    }
+    async getPaymentMethodCustomer(id) {
+        return this.request("GET", `/payment-method/${encodeURIComponent(id)}/customer`);
+    }
+    async getPaymentMethodGatewayAccount(id) {
+        return this.request("GET", `/payment-method/${encodeURIComponent(id)}/gateway-account`);
+    }
+    async createPaymentMethodToken(paymentData) {
+        return this.request("POST", "/payment-method-token", {
+            creditCard: {
+                cardNumber: paymentData.cardNumber,
+                expirationDate: paymentData.expirationDate,
+                cvv: paymentData.cvv,
+                cardholderName: paymentData.cardholderName,
+            },
+        });
+    }
+    async addPaymentMethodToCustomer(customerId, token) {
+        return this.request("POST", `/customer/${encodeURIComponent(customerId)}/payment-method`, { token });
+    }
+    // ==================== Subscription Operations ====================
+    async getSubscription(id) {
+        return this.request("GET", `/subscription/${encodeURIComponent(id)}`);
+    }
+    async getSubscriptionCustomer(id) {
+        return this.request("GET", `/subscription/${encodeURIComponent(id)}/customer`);
+    }
+    async getSubscriptionPlan(id) {
+        return this.request("GET", `/subscription/${encodeURIComponent(id)}/plan`);
+    }
+    async getSubscriptionPaymentMethod(id) {
+        return this.request("GET", `/subscription/${encodeURIComponent(id)}/payment-method`);
+    }
+    async deleteSubscriptionPromotion(customerId) {
+        await this.request("DELETE", `/customer/${encodeURIComponent(customerId)}/subscription/promotion`);
+    }
+    // ==================== Product Operations ====================
+    async getProduct() {
+        return this.request("GET", "/product");
+    }
+    // ==================== Plan Operations ====================
+    async getPlan(id) {
+        return this.request("GET", `/plan/${encodeURIComponent(id)}`);
+    }
+    // ==================== Gateway Account Operations ====================
+    async getGatewayAccount(id) {
+        return this.request("GET", `/gateway-account/${encodeURIComponent(id)}`);
+    }
+    // ==================== Health Check ====================
+    async ping() {
+        return this.request("GET", "/ping");
+    }
+}
+//# sourceMappingURL=cheddar-client.js.map

package/dist/lib/cheddar-client.js.map

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

package/dist/tools/checkout.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/tools/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,aAAa,EAAE,IAAI,EA0I/B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,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,CAsK7D"}