@epicai/legion 1.0.0

package/dist/mcp-servers/bigredcloud.js

@@ -0,0 +1,1063 @@
+/**
+ * Big Red Cloud MCP Adapter
+ * Built on the Epic AI® Intelligence Platform
+ * Copyright 2026 protectNIL Inc. Apache-2.0
+ */
+import { MCPAdapterBase } from './base.js';
+export class BigRedCloudMCPServer extends MCPAdapterBase {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        super();
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? 'https://app.bigredcloud.com/api';
+    }
+    static catalog() {
+        return {
+            name: 'bigredcloud',
+            displayName: 'Big Red Cloud',
+            version: '1.0.0',
+            category: 'finance',
+            keywords: [
+                'bigredcloud', 'big red cloud', 'accounting', 'bookkeeping', 'ireland', 'vat',
+                'invoice', 'sales invoice', 'purchase', 'customer', 'supplier', 'bank account',
+                'cash payment', 'cash receipt', 'product', 'quote', 'credit note', 'sales rep',
+                'financial', 'small business', 'cloud accounting',
+            ],
+            toolNames: [
+                'list_accounts', 'list_analysis_categories', 'list_bank_accounts', 'get_bank_account',
+                'create_bank_account', 'update_bank_account', 'delete_bank_account',
+                'list_customers', 'get_customer', 'create_customer', 'update_customer', 'delete_customer',
+                'list_customer_transactions', 'list_customer_quotes',
+                'list_suppliers', 'get_supplier', 'create_supplier', 'update_supplier', 'delete_supplier',
+                'list_supplier_transactions',
+                'list_sales_invoices', 'get_sales_invoice', 'create_sales_invoice',
+                'list_purchases', 'get_purchase', 'create_purchase',
+                'list_payments', 'get_payment', 'create_payment',
+                'list_cash_payments', 'get_cash_payment', 'create_cash_payment',
+                'list_cash_receipts', 'get_cash_receipt', 'create_cash_receipt',
+                'list_products', 'get_product', 'create_product', 'update_product', 'delete_product',
+                'list_quotes', 'get_quote', 'create_quote',
+                'list_sales_credit_notes', 'get_sales_credit_note', 'create_sales_credit_note',
+                'list_vat_rates', 'list_vat_categories', 'list_vat_types',
+                'get_company_settings', 'list_sales_reps',
+            ],
+            description: 'Manage Big Red Cloud accounting: customers, suppliers, sales invoices, purchases, payments, products, quotes, and VAT via the Big Red Cloud REST API.',
+            author: 'protectnil',
+        };
+    }
+    get tools() {
+        return [
+            // ── Accounts ──────────────────────────────────────────────────────────
+            {
+                name: 'list_accounts',
+                description: 'List chart of accounts for the Big Red Cloud company. Supports OData ordering by id and code.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of accounts to return (OData $top)' },
+                        skip: { type: 'number', description: 'Number of accounts to skip for pagination (OData $skip)' },
+                        orderby: { type: 'string', description: 'Order results by field: id or code (e.g. "code asc")' },
+                    },
+                },
+            },
+            // ── Analysis Categories ────────────────────────────────────────────────
+            {
+                name: 'list_analysis_categories',
+                description: 'List analysis categories. Supports OData filtering by categoryTypeId and ordering by id or orderIndex.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        category_type_id: { type: 'number', description: 'Filter by category type ID' },
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            // ── Bank Accounts ──────────────────────────────────────────────────────
+            {
+                name: 'list_bank_accounts',
+                description: 'List all bank accounts for the company. Supports OData ordering by id or acCode.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            {
+                name: 'get_bank_account',
+                description: 'Retrieve a single bank account by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Bank account ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_bank_account',
+                description: 'Create a new bank account record in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Account code (required)' },
+                        accountName: { type: 'string', description: 'Account name' },
+                        accountNumber: { type: 'string', description: 'Bank account number' },
+                        sortCode: { type: 'string', description: 'Bank sort code' },
+                        internationalBankAccountNumber: { type: 'string', description: 'IBAN' },
+                        businessIdentifierCodes: { type: 'string', description: 'BIC/SWIFT code' },
+                        nominalAcCode: { type: 'string', description: 'Nominal account code' },
+                    },
+                    required: ['acCode'],
+                },
+            },
+            {
+                name: 'update_bank_account',
+                description: 'Update an existing bank account by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Bank account ID to update (required)' },
+                        accountName: { type: 'string', description: 'Updated account name' },
+                        accountNumber: { type: 'string', description: 'Updated account number' },
+                        sortCode: { type: 'string', description: 'Updated sort code' },
+                        internationalBankAccountNumber: { type: 'string', description: 'Updated IBAN' },
+                        businessIdentifierCodes: { type: 'string', description: 'Updated BIC/SWIFT' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'delete_bank_account',
+                description: 'Delete a bank account by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Bank account ID to delete' },
+                        timestamp: { type: 'string', description: 'Concurrency timestamp (base64 encoded) from the GET response' },
+                    },
+                    required: ['id', 'timestamp'],
+                },
+            },
+            // ── Customers ─────────────────────────────────────────────────────────
+            {
+                name: 'list_customers',
+                description: 'List all customers. Supports OData ordering by id and code.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                        orderby: { type: 'string', description: 'Order by field: id or code' },
+                    },
+                },
+            },
+            {
+                name: 'get_customer',
+                description: 'Retrieve a single customer by their ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Customer ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_customer',
+                description: 'Create a new customer record in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        code: { type: 'string', description: 'Customer code (required)' },
+                        name: { type: 'string', description: 'Customer name (required)' },
+                        email: { type: 'string', description: 'Customer email address' },
+                        phone: { type: 'string', description: 'Customer phone number' },
+                        vatReg: { type: 'string', description: 'VAT registration number' },
+                        address: { type: 'array', items: { type: 'string' }, description: 'Address lines (up to 5)' },
+                        currencyId: { type: 'number', description: 'Currency ID for the customer' },
+                    },
+                    required: ['code', 'name'],
+                },
+            },
+            {
+                name: 'update_customer',
+                description: 'Update an existing customer by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Customer ID to update (required)' },
+                        name: { type: 'string', description: 'Updated name' },
+                        email: { type: 'string', description: 'Updated email' },
+                        phone: { type: 'string', description: 'Updated phone' },
+                        vatReg: { type: 'string', description: 'Updated VAT registration number' },
+                        address: { type: 'array', items: { type: 'string' }, description: 'Updated address lines' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'delete_customer',
+                description: 'Delete a customer by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Customer ID to delete' },
+                        timestamp: { type: 'string', description: 'Concurrency timestamp from the GET response' },
+                    },
+                    required: ['id', 'timestamp'],
+                },
+            },
+            {
+                name: 'list_customer_transactions',
+                description: 'List all account transactions for a specific customer.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        customer_id: { type: 'number', description: 'Customer ID (required)' },
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                    required: ['customer_id'],
+                },
+            },
+            {
+                name: 'list_customer_quotes',
+                description: 'List all quotes associated with a specific customer.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        customer_id: { type: 'number', description: 'Customer ID (required)' },
+                    },
+                    required: ['customer_id'],
+                },
+            },
+            // ── Suppliers ─────────────────────────────────────────────────────────
+            {
+                name: 'list_suppliers',
+                description: 'List all suppliers. Supports OData ordering by id and code.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                        orderby: { type: 'string', description: 'Order by field: id or code' },
+                    },
+                },
+            },
+            {
+                name: 'get_supplier',
+                description: 'Retrieve a single supplier by their ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Supplier ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_supplier',
+                description: 'Create a new supplier record in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        code: { type: 'string', description: 'Supplier code (required)' },
+                        name: { type: 'string', description: 'Supplier name (required)' },
+                        email: { type: 'string', description: 'Supplier email address' },
+                        phone: { type: 'string', description: 'Supplier phone number' },
+                        vatReg: { type: 'string', description: 'VAT registration number' },
+                        address: { type: 'array', items: { type: 'string' }, description: 'Address lines (up to 5)' },
+                    },
+                    required: ['code', 'name'],
+                },
+            },
+            {
+                name: 'update_supplier',
+                description: 'Update an existing supplier by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Supplier ID to update (required)' },
+                        name: { type: 'string', description: 'Updated name' },
+                        email: { type: 'string', description: 'Updated email' },
+                        phone: { type: 'string', description: 'Updated phone' },
+                        address: { type: 'array', items: { type: 'string' }, description: 'Updated address lines' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'delete_supplier',
+                description: 'Delete a supplier by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Supplier ID to delete' },
+                        timestamp: { type: 'string', description: 'Concurrency timestamp from the GET response' },
+                    },
+                    required: ['id', 'timestamp'],
+                },
+            },
+            {
+                name: 'list_supplier_transactions',
+                description: 'List all account transactions for a specific supplier.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        supplier_id: { type: 'number', description: 'Supplier ID (required)' },
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                    required: ['supplier_id'],
+                },
+            },
+            // ── Sales Invoices ────────────────────────────────────────────────────
+            {
+                name: 'list_sales_invoices',
+                description: 'List sales invoices. Supports OData ordering by id and entryDate.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                        orderby: { type: 'string', description: 'Order by field: id or entryDate' },
+                    },
+                },
+            },
+            {
+                name: 'get_sales_invoice',
+                description: 'Retrieve a single sales invoice by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Sales invoice ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_sales_invoice',
+                description: 'Create a new sales invoice in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Customer account code (required)' },
+                        entryDate: { type: 'string', description: 'Invoice date in YYYY-MM-DD format (required)' },
+                        reference: { type: 'string', description: 'Invoice reference number' },
+                        details: {
+                            type: 'array',
+                            description: 'Invoice line items',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    productCode: { type: 'string', description: 'Product code' },
+                                    description: { type: 'string', description: 'Line description' },
+                                    quantity: { type: 'number', description: 'Quantity' },
+                                    unitPrice: { type: 'number', description: 'Unit price' },
+                                    vatRateId: { type: 'number', description: 'VAT rate ID' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['acCode', 'entryDate'],
+                },
+            },
+            // ── Purchases ─────────────────────────────────────────────────────────
+            {
+                name: 'list_purchases',
+                description: 'List purchase invoices. Supports OData ordering by id and entryDate.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                        orderby: { type: 'string', description: 'Order by field: id or entryDate' },
+                    },
+                },
+            },
+            {
+                name: 'get_purchase',
+                description: 'Retrieve a single purchase invoice by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Purchase invoice ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_purchase',
+                description: 'Create a new purchase invoice in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Supplier account code (required)' },
+                        entryDate: { type: 'string', description: 'Purchase date in YYYY-MM-DD format (required)' },
+                        reference: { type: 'string', description: 'Supplier invoice reference' },
+                        details: {
+                            type: 'array',
+                            description: 'Purchase line items',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    productCode: { type: 'string', description: 'Product code' },
+                                    description: { type: 'string', description: 'Line description' },
+                                    quantity: { type: 'number', description: 'Quantity' },
+                                    unitPrice: { type: 'number', description: 'Unit price' },
+                                    vatRateId: { type: 'number', description: 'VAT rate ID' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['acCode', 'entryDate'],
+                },
+            },
+            // ── Payments ──────────────────────────────────────────────────────────
+            {
+                name: 'list_payments',
+                description: 'List payment records. Supports OData ordering by id and entryDate.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            {
+                name: 'get_payment',
+                description: 'Retrieve a single payment by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Payment ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_payment',
+                description: 'Create a new payment (supplier payment) in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Supplier account code (required)' },
+                        bankAccountId: { type: 'number', description: 'Bank account ID to pay from (required)' },
+                        entryDate: { type: 'string', description: 'Payment date in YYYY-MM-DD format (required)' },
+                        amount: { type: 'number', description: 'Payment amount (required)' },
+                        reference: { type: 'string', description: 'Payment reference' },
+                    },
+                    required: ['acCode', 'bankAccountId', 'entryDate', 'amount'],
+                },
+            },
+            // ── Cash Payments ──────────────────────────────────────────────────────
+            {
+                name: 'list_cash_payments',
+                description: 'List cash payment records.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            {
+                name: 'get_cash_payment',
+                description: 'Retrieve a single cash payment by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Cash payment ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_cash_payment',
+                description: 'Create a new cash payment record in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Account code (required)' },
+                        entryDate: { type: 'string', description: 'Payment date in YYYY-MM-DD format (required)' },
+                        amount: { type: 'number', description: 'Payment amount (required)' },
+                        reference: { type: 'string', description: 'Payment reference' },
+                        details: {
+                            type: 'array',
+                            description: 'Cash payment line items',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    accountCode: { type: 'string', description: 'Nominal account code' },
+                                    netAmount: { type: 'number', description: 'Net amount for this line' },
+                                    vatRateId: { type: 'number', description: 'VAT rate ID' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['acCode', 'entryDate', 'amount'],
+                },
+            },
+            // ── Cash Receipts ──────────────────────────────────────────────────────
+            {
+                name: 'list_cash_receipts',
+                description: 'List cash receipt records.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            {
+                name: 'get_cash_receipt',
+                description: 'Retrieve a single cash receipt by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Cash receipt ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_cash_receipt',
+                description: 'Create a new cash receipt record in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Customer account code (required)' },
+                        entryDate: { type: 'string', description: 'Receipt date in YYYY-MM-DD format (required)' },
+                        amount: { type: 'number', description: 'Receipt amount (required)' },
+                        reference: { type: 'string', description: 'Receipt reference' },
+                        details: {
+                            type: 'array',
+                            description: 'Cash receipt line items',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    accountCode: { type: 'string', description: 'Nominal account code' },
+                                    netAmount: { type: 'number', description: 'Net amount for this line' },
+                                    vatRateId: { type: 'number', description: 'VAT rate ID' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['acCode', 'entryDate', 'amount'],
+                },
+            },
+            // ── Products ──────────────────────────────────────────────────────────
+            {
+                name: 'list_products',
+                description: 'List products/services catalog. Supports OData ordering by id and code.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                        orderby: { type: 'string', description: 'Order by field: id or code' },
+                    },
+                },
+            },
+            {
+                name: 'get_product',
+                description: 'Retrieve a single product by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Product ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_product',
+                description: 'Create a new product or service in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        code: { type: 'string', description: 'Product code (required)' },
+                        description: { type: 'string', description: 'Product description (required)' },
+                        salePrice: { type: 'number', description: 'Default sale price' },
+                        purchasePrice: { type: 'number', description: 'Default purchase price' },
+                        vatRateId: { type: 'number', description: 'Default VAT rate ID' },
+                        accountCode: { type: 'string', description: 'Nominal account code for this product' },
+                    },
+                    required: ['code', 'description'],
+                },
+            },
+            {
+                name: 'update_product',
+                description: 'Update an existing product by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Product ID to update (required)' },
+                        description: { type: 'string', description: 'Updated description' },
+                        salePrice: { type: 'number', description: 'Updated sale price' },
+                        purchasePrice: { type: 'number', description: 'Updated purchase price' },
+                        vatRateId: { type: 'number', description: 'Updated VAT rate ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'delete_product',
+                description: 'Delete a product by ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Product ID to delete' },
+                        timestamp: { type: 'string', description: 'Concurrency timestamp from the GET response' },
+                    },
+                    required: ['id', 'timestamp'],
+                },
+            },
+            // ── Quotes ────────────────────────────────────────────────────────────
+            {
+                name: 'list_quotes',
+                description: 'List quotes/estimates. Supports OData ordering by id and entryDate.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            {
+                name: 'get_quote',
+                description: 'Retrieve a single quote by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Quote ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_quote',
+                description: 'Create a new quote/estimate in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Customer account code (required)' },
+                        entryDate: { type: 'string', description: 'Quote date in YYYY-MM-DD format (required)' },
+                        reference: { type: 'string', description: 'Quote reference' },
+                        details: {
+                            type: 'array',
+                            description: 'Quote line items',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    productCode: { type: 'string', description: 'Product code' },
+                                    description: { type: 'string', description: 'Line description' },
+                                    quantity: { type: 'number', description: 'Quantity' },
+                                    unitPrice: { type: 'number', description: 'Unit price' },
+                                    vatRateId: { type: 'number', description: 'VAT rate ID' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['acCode', 'entryDate'],
+                },
+            },
+            // ── Sales Credit Notes ─────────────────────────────────────────────────
+            {
+                name: 'list_sales_credit_notes',
+                description: 'List sales credit notes.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            {
+                name: 'get_sales_credit_note',
+                description: 'Retrieve a single sales credit note by its ID.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Sales credit note ID' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'create_sales_credit_note',
+                description: 'Create a new sales credit note in Big Red Cloud.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        acCode: { type: 'string', description: 'Customer account code (required)' },
+                        entryDate: { type: 'string', description: 'Credit note date in YYYY-MM-DD format (required)' },
+                        reference: { type: 'string', description: 'Credit note reference' },
+                        details: {
+                            type: 'array',
+                            description: 'Credit note line items',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    productCode: { type: 'string', description: 'Product code' },
+                                    description: { type: 'string', description: 'Line description' },
+                                    quantity: { type: 'number', description: 'Quantity' },
+                                    unitPrice: { type: 'number', description: 'Unit price' },
+                                    vatRateId: { type: 'number', description: 'VAT rate ID' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['acCode', 'entryDate'],
+                },
+            },
+            // ── VAT ───────────────────────────────────────────────────────────────
+            {
+                name: 'list_vat_rates',
+                description: 'List all VAT rates configured in the company.',
+                inputSchema: { type: 'object', properties: {} },
+            },
+            {
+                name: 'list_vat_categories',
+                description: 'List VAT categories and their associated VAT rates.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+            {
+                name: 'list_vat_types',
+                description: 'List all VAT types available in the system.',
+                inputSchema: { type: 'object', properties: {} },
+            },
+            // ── Company ───────────────────────────────────────────────────────────
+            {
+                name: 'get_company_settings',
+                description: 'Retrieve company-level settings such as name, address, VAT registration, and financial year.',
+                inputSchema: { type: 'object', properties: {} },
+            },
+            // ── Sales Reps ────────────────────────────────────────────────────────
+            {
+                name: 'list_sales_reps',
+                description: 'List all sales representatives in the company.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        top: { type: 'number', description: 'Maximum number of results (OData $top)' },
+                        skip: { type: 'number', description: 'Number to skip for pagination (OData $skip)' },
+                    },
+                },
+            },
+        ];
+    }
+    async callTool(name, args) {
+        try {
+            switch (name) {
+                case 'list_accounts': return await this.listAccounts(args);
+                case 'list_analysis_categories': return await this.listAnalysisCategories(args);
+                case 'list_bank_accounts': return await this.listBankAccounts(args);
+                case 'get_bank_account': return await this.getBankAccount(args);
+                case 'create_bank_account': return await this.createBankAccount(args);
+                case 'update_bank_account': return await this.updateBankAccount(args);
+                case 'delete_bank_account': return await this.deleteBankAccount(args);
+                case 'list_customers': return await this.listCustomers(args);
+                case 'get_customer': return await this.getCustomer(args);
+                case 'create_customer': return await this.createCustomer(args);
+                case 'update_customer': return await this.updateCustomer(args);
+                case 'delete_customer': return await this.deleteCustomer(args);
+                case 'list_customer_transactions': return await this.listCustomerTransactions(args);
+                case 'list_customer_quotes': return await this.listCustomerQuotes(args);
+                case 'list_suppliers': return await this.listSuppliers(args);
+                case 'get_supplier': return await this.getSupplier(args);
+                case 'create_supplier': return await this.createSupplier(args);
+                case 'update_supplier': return await this.updateSupplier(args);
+                case 'delete_supplier': return await this.deleteSupplier(args);
+                case 'list_supplier_transactions': return await this.listSupplierTransactions(args);
+                case 'list_sales_invoices': return await this.listSalesInvoices(args);
+                case 'get_sales_invoice': return await this.getSalesInvoice(args);
+                case 'create_sales_invoice': return await this.createSalesInvoice(args);
+                case 'list_purchases': return await this.listPurchases(args);
+                case 'get_purchase': return await this.getPurchase(args);
+                case 'create_purchase': return await this.createPurchase(args);
+                case 'list_payments': return await this.listPayments(args);
+                case 'get_payment': return await this.getPayment(args);
+                case 'create_payment': return await this.createPayment(args);
+                case 'list_cash_payments': return await this.listCashPayments(args);
+                case 'get_cash_payment': return await this.getCashPayment(args);
+                case 'create_cash_payment': return await this.createCashPayment(args);
+                case 'list_cash_receipts': return await this.listCashReceipts(args);
+                case 'get_cash_receipt': return await this.getCashReceipt(args);
+                case 'create_cash_receipt': return await this.createCashReceipt(args);
+                case 'list_products': return await this.listProducts(args);
+                case 'get_product': return await this.getProduct(args);
+                case 'create_product': return await this.createProduct(args);
+                case 'update_product': return await this.updateProduct(args);
+                case 'delete_product': return await this.deleteProduct(args);
+                case 'list_quotes': return await this.listQuotes(args);
+                case 'get_quote': return await this.getQuote(args);
+                case 'create_quote': return await this.createQuote(args);
+                case 'list_sales_credit_notes': return await this.listSalesCreditNotes(args);
+                case 'get_sales_credit_note': return await this.getSalesCreditNote(args);
+                case 'create_sales_credit_note': return await this.createSalesCreditNote(args);
+                case 'list_vat_rates': return await this.listVatRates();
+                case 'list_vat_categories': return await this.listVatCategories(args);
+                case 'list_vat_types': return await this.listVatTypes();
+                case 'get_company_settings': return await this.getCompanySettings();
+                case 'list_sales_reps': return await this.listSalesReps(args);
+                default:
+                    return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+            }
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Tool execution failed: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    buildUrl(path, extraParams) {
+        const params = new URLSearchParams({ apiKey: this.apiKey, ...extraParams });
+        return `${this.baseUrl}${path}?${params.toString()}`;
+    }
+    buildODataParams(args) {
+        const params = {};
+        if (args.top !== undefined)
+            params['$top'] = String(args.top);
+        if (args.skip !== undefined)
+            params['$skip'] = String(args.skip);
+        if (args.orderby)
+            params['$orderby'] = args.orderby;
+        return params;
+    }
+    async brcRequest(path, options = {}, extraParams) {
+        const url = this.buildUrl(path, extraParams);
+        const response = await this.fetchWithRetry(url, {
+            ...options,
+            headers: { 'Content-Type': 'application/json', ...options.headers },
+        });
+        if (!response.ok) {
+            let detail = '';
+            try {
+                detail = await response.text();
+            }
+            catch { /* ignore */ }
+            return {
+                content: [{ type: 'text', text: `Big Red Cloud API error ${response.status} ${response.statusText}${detail ? ': ' + detail.slice(0, 400) : ''}` }],
+                isError: true,
+            };
+        }
+        let data;
+        try {
+            data = await response.json();
+        }
+        catch {
+            return { content: [{ type: 'text', text: `Big Red Cloud returned non-JSON response (HTTP ${response.status})` }], isError: true };
+        }
+        const text = JSON.stringify(data, null, 2);
+        const truncated = text.length > 10_000
+            ? text.slice(0, 10_000) + `\n... [truncated, ${text.length} total chars]`
+            : text;
+        return { content: [{ type: 'text', text: truncated }], isError: false };
+    }
+    // ── Accounts ──────────────────────────────────────────────────────────────
+    async listAccounts(args) {
+        return this.brcRequest('/v1/accounts', {}, this.buildODataParams(args));
+    }
+    // ── Analysis Categories ────────────────────────────────────────────────────
+    async listAnalysisCategories(args) {
+        const params = this.buildODataParams(args);
+        if (args.category_type_id !== undefined)
+            params['$filter'] = `categoryTypeId eq ${args.category_type_id}`;
+        return this.brcRequest('/v1/analysisCategories', {}, params);
+    }
+    // ── Bank Accounts ──────────────────────────────────────────────────────────
+    async listBankAccounts(args) {
+        return this.brcRequest('/v1/bankAccounts', {}, this.buildODataParams(args));
+    }
+    async getBankAccount(args) {
+        return this.brcRequest(`/v1/bankAccounts/${encodeURIComponent(String(args.id))}`);
+    }
+    async createBankAccount(args) {
+        return this.brcRequest('/v1/bankAccounts', { method: 'POST', body: JSON.stringify(args) });
+    }
+    async updateBankAccount(args) {
+        const { id, ...body } = args;
+        return this.brcRequest(`/v1/bankAccounts/${encodeURIComponent(String(id))}`, { method: 'PUT', body: JSON.stringify({ id, ...body }) });
+    }
+    async deleteBankAccount(args) {
+        return this.brcRequest(`/v1/bankAccounts/${encodeURIComponent(String(args.id))}`, {
+            method: 'DELETE',
+            body: JSON.stringify({ id: args.id, timestamp: args.timestamp }),
+        });
+    }
+    // ── Customers ─────────────────────────────────────────────────────────────
+    async listCustomers(args) {
+        return this.brcRequest('/v1/customers', {}, this.buildODataParams(args));
+    }
+    async getCustomer(args) {
+        return this.brcRequest(`/v1/customers/${encodeURIComponent(String(args.id))}`);
+    }
+    async createCustomer(args) {
+        return this.brcRequest('/v1/customers', { method: 'POST', body: JSON.stringify(args) });
+    }
+    async updateCustomer(args) {
+        const { id, ...body } = args;
+        return this.brcRequest(`/v1/customers/${encodeURIComponent(String(id))}`, { method: 'PUT', body: JSON.stringify({ id, ...body }) });
+    }
+    async deleteCustomer(args) {
+        return this.brcRequest(`/v1/customers/${encodeURIComponent(String(args.id))}`, {
+            method: 'DELETE',
+            body: JSON.stringify({ id: args.id, timestamp: args.timestamp }),
+        });
+    }
+    async listCustomerTransactions(args) {
+        return this.brcRequest(`/v1/customers/${encodeURIComponent(String(args.customer_id))}/accountTrans`, {}, this.buildODataParams(args));
+    }
+    async listCustomerQuotes(args) {
+        return this.brcRequest(`/v1/customers/${encodeURIComponent(String(args.customer_id))}/quotes`);
+    }
+    // ── Suppliers ─────────────────────────────────────────────────────────────
+    async listSuppliers(args) {
+        return this.brcRequest('/v1/suppliers', {}, this.buildODataParams(args));
+    }
+    async getSupplier(args) {
+        return this.brcRequest(`/v1/suppliers/${encodeURIComponent(String(args.id))}`);
+    }
+    async createSupplier(args) {
+        return this.brcRequest('/v1/suppliers', { method: 'POST', body: JSON.stringify(args) });
+    }
+    async updateSupplier(args) {
+        const { id, ...body } = args;
+        return this.brcRequest(`/v1/suppliers/${encodeURIComponent(String(id))}`, { method: 'PUT', body: JSON.stringify({ id, ...body }) });
+    }
+    async deleteSupplier(args) {
+        return this.brcRequest(`/v1/suppliers/${encodeURIComponent(String(args.id))}`, {
+            method: 'DELETE',
+            body: JSON.stringify({ id: args.id, timestamp: args.timestamp }),
+        });
+    }
+    async listSupplierTransactions(args) {
+        return this.brcRequest(`/v1/suppliers/${encodeURIComponent(String(args.supplier_id))}/accountTrans`, {}, this.buildODataParams(args));
+    }
+    // ── Sales Invoices ────────────────────────────────────────────────────────
+    async listSalesInvoices(args) {
+        return this.brcRequest('/v1/salesInvoices', {}, this.buildODataParams(args));
+    }
+    async getSalesInvoice(args) {
+        return this.brcRequest(`/v1/salesInvoices/${encodeURIComponent(String(args.id))}`);
+    }
+    async createSalesInvoice(args) {
+        return this.brcRequest('/v1/salesInvoices', { method: 'POST', body: JSON.stringify(args) });
+    }
+    // ── Purchases ─────────────────────────────────────────────────────────────
+    async listPurchases(args) {
+        return this.brcRequest('/v1/purchases', {}, this.buildODataParams(args));
+    }
+    async getPurchase(args) {
+        return this.brcRequest(`/v1/purchases/${encodeURIComponent(String(args.id))}`);
+    }
+    async createPurchase(args) {
+        return this.brcRequest('/v1/purchases', { method: 'POST', body: JSON.stringify(args) });
+    }
+    // ── Payments ──────────────────────────────────────────────────────────────
+    async listPayments(args) {
+        return this.brcRequest('/v1/payments', {}, this.buildODataParams(args));
+    }
+    async getPayment(args) {
+        return this.brcRequest(`/v1/payments/${encodeURIComponent(String(args.id))}`);
+    }
+    async createPayment(args) {
+        return this.brcRequest('/v1/payments', { method: 'POST', body: JSON.stringify(args) });
+    }
+    // ── Cash Payments ──────────────────────────────────────────────────────────
+    async listCashPayments(args) {
+        return this.brcRequest('/v1/cashPayments', {}, this.buildODataParams(args));
+    }
+    async getCashPayment(args) {
+        return this.brcRequest(`/v1/cashPayments/${encodeURIComponent(String(args.id))}`);
+    }
+    async createCashPayment(args) {
+        return this.brcRequest('/v1/cashPayments', { method: 'POST', body: JSON.stringify(args) });
+    }
+    // ── Cash Receipts ──────────────────────────────────────────────────────────
+    async listCashReceipts(args) {
+        return this.brcRequest('/v1/cashReceipts', {}, this.buildODataParams(args));
+    }
+    async getCashReceipt(args) {
+        return this.brcRequest(`/v1/cashReceipts/${encodeURIComponent(String(args.id))}`);
+    }
+    async createCashReceipt(args) {
+        return this.brcRequest('/v1/cashReceipts', { method: 'POST', body: JSON.stringify(args) });
+    }
+    // ── Products ──────────────────────────────────────────────────────────────
+    async listProducts(args) {
+        return this.brcRequest('/v1/products', {}, this.buildODataParams(args));
+    }
+    async getProduct(args) {
+        return this.brcRequest(`/v1/products/${encodeURIComponent(String(args.id))}`);
+    }
+    async createProduct(args) {
+        return this.brcRequest('/v1/products', { method: 'POST', body: JSON.stringify(args) });
+    }
+    async updateProduct(args) {
+        const { id, ...body } = args;
+        return this.brcRequest(`/v1/products/${encodeURIComponent(String(id))}`, { method: 'PUT', body: JSON.stringify({ id, ...body }) });
+    }
+    async deleteProduct(args) {
+        return this.brcRequest(`/v1/products/${encodeURIComponent(String(args.id))}`, {
+            method: 'DELETE',
+            body: JSON.stringify({ id: args.id, timestamp: args.timestamp }),
+        });
+    }
+    // ── Quotes ────────────────────────────────────────────────────────────────
+    async listQuotes(args) {
+        return this.brcRequest('/v1/quotes', {}, this.buildODataParams(args));
+    }
+    async getQuote(args) {
+        return this.brcRequest(`/v1/quotes/${encodeURIComponent(String(args.id))}`);
+    }
+    async createQuote(args) {
+        return this.brcRequest('/v1/quotes/createQuoteWithGeneratingReference', { method: 'POST', body: JSON.stringify(args) });
+    }
+    // ── Sales Credit Notes ─────────────────────────────────────────────────────
+    async listSalesCreditNotes(args) {
+        return this.brcRequest('/v1/salesCreditNotes', {}, this.buildODataParams(args));
+    }
+    async getSalesCreditNote(args) {
+        return this.brcRequest(`/v1/salesCreditNotes/${encodeURIComponent(String(args.id))}`);
+    }
+    async createSalesCreditNote(args) {
+        return this.brcRequest('/v1/salesCreditNotes', { method: 'POST', body: JSON.stringify(args) });
+    }
+    // ── VAT ───────────────────────────────────────────────────────────────────
+    async listVatRates() {
+        return this.brcRequest('/v1/vatRates');
+    }
+    async listVatCategories(args) {
+        return this.brcRequest('/v1/vatCategories', {}, this.buildODataParams(args));
+    }
+    async listVatTypes() {
+        return this.brcRequest('/v1/vatTypes');
+    }
+    // ── Company ───────────────────────────────────────────────────────────────
+    async getCompanySettings() {
+        return this.brcRequest('/v1/companySettings');
+    }
+    // ── Sales Reps ────────────────────────────────────────────────────────────
+    async listSalesReps(args) {
+        return this.brcRequest('/v1/salesReps', {}, this.buildODataParams(args));
+    }
+}