@elyonar/einvoice-mcp 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { HttpClient } from './client/http-client.js';
+import { InvoiceClient } from './client/invoice-client.js';
+import { BillingClient } from './client/billing-client.js';
+export declare function createServer(config?: {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}): {
+    server: McpServer;
+    httpClient: HttpClient;
+    invoiceClient: InvoiceClient;
+    billingClient: BillingClient;
+};
+//# 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":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AA2B3D,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;;;;;EAmEA"}

package/dist/index.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const http_client_js_1 = require("./client/http-client.js");
+const invoice_client_js_1 = require("./client/invoice-client.js");
+const billing_client_js_1 = require("./client/billing-client.js");
+const index_js_1 = require("./tools/index.js");
+// ─── Config ──────────────────────────────────────────────
+function getConfig() {
+    const apiKey = process.env.EINVOICE_API_KEY;
+    if (!apiKey) {
+        console.error('Error: EINVOICE_API_KEY environment variable is required');
+        process.exit(1);
+    }
+    return {
+        apiKey,
+        baseUrl: process.env.EINVOICE_BASE_URL ?? 'https://api.einvoice.ng',
+        timeout: parseInt(process.env.EINVOICE_REQUEST_TIMEOUT ?? '30000', 10),
+        maxRetries: parseInt(process.env.EINVOICE_RETRY_ATTEMPTS ?? '3', 10),
+    };
+}
+// ─── Server Setup ────────────────────────────────────────
+function createServer(config) {
+    const cfg = config ?? getConfig();
+    const httpClient = new http_client_js_1.HttpClient({
+        baseUrl: cfg.baseUrl ?? 'https://api.einvoice.ng',
+        apiKey: cfg.apiKey,
+        timeout: cfg.timeout,
+        maxRetries: cfg.maxRetries,
+    });
+    const invoiceClient = new invoice_client_js_1.InvoiceClient(httpClient);
+    const billingClient = new billing_client_js_1.BillingClient(httpClient);
+    // Collect all tool definitions
+    const allTools = [
+        ...index_js_1.invoiceToolDefinitions,
+        ...index_js_1.sellerToolDefinitions,
+        ...index_js_1.buyerToolDefinitions,
+        ...index_js_1.billingToolDefinitions,
+    ];
+    const invoiceToolNames = new Set(index_js_1.invoiceToolDefinitions.map((t) => t.name));
+    const sellerToolNames = new Set(index_js_1.sellerToolDefinitions.map((t) => t.name));
+    const buyerToolNames = new Set(index_js_1.buyerToolDefinitions.map((t) => t.name));
+    const billingToolNames = new Set(index_js_1.billingToolDefinitions.map((t) => t.name));
+    // Create MCP server
+    const server = new mcp_js_1.McpServer({
+        name: 'einvoice',
+        version: '1.0.0',
+    });
+    // Register tools using the low-level server
+    const rawServer = server.server;
+    rawServer.setRequestHandler({ method: 'tools/list' }, async () => ({ tools: allTools }));
+    rawServer.setRequestHandler({ method: 'tools/call' }, async (request) => {
+        const { name, arguments: args } = request.params;
+        const toolArgs = (args ?? {});
+        if (invoiceToolNames.has(name)) {
+            return (0, index_js_1.handleInvoiceTool)(name, toolArgs, invoiceClient);
+        }
+        if (sellerToolNames.has(name)) {
+            return (0, index_js_1.handleSellerTool)(name, toolArgs, invoiceClient);
+        }
+        if (buyerToolNames.has(name)) {
+            return (0, index_js_1.handleBuyerTool)(name, toolArgs, invoiceClient);
+        }
+        if (billingToolNames.has(name)) {
+            return (0, index_js_1.handleBillingTool)(name, toolArgs, billingClient);
+        }
+        return {
+            content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+            isError: true,
+        };
+    });
+    return { server, httpClient, invoiceClient, billingClient };
+}
+// ─── Main ────────────────────────────────────────────────
+async function main() {
+    const { server } = createServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Fatal:', 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/tools/billing-tools.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BillingClient } from '../client/billing-client.js';
+export declare const billingToolDefinitions: Tool[];
+export declare function handleBillingTool(name: string, args: Record<string, unknown>, client: BillingClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=billing-tools.d.ts.map

package/dist/tools/billing-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-tools.d.ts","sourceRoot":"","sources":["../../src/tools/billing-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,eAAO,MAAM,sBAAsB,EAAE,IAAI,EA+HxC,CAAC;AAIF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAwEhF"}

package/dist/tools/billing-tools.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.billingToolDefinitions = void 0;
+exports.handleBillingTool = handleBillingTool;
+const format_js_1 = require("../utils/format.js");
+exports.billingToolDefinitions = [
+    {
+        name: 'get_billing_account',
+        description: 'Get the current organization billing account: credit balance, billing mode, status, and thresholds.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'check_balance',
+        description: 'Check if the account has sufficient credits for a given number of operations (e.g., before batch submitting invoices).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                credits: { type: 'number', minimum: 1, description: 'Number of credits to check against balance' },
+            },
+            required: ['credits'],
+        },
+    },
+    {
+        name: 'get_billing_setup',
+        description: 'Get comprehensive billing overview: account, active subscription, usage summary, and available plans.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_subscription_plans',
+        description: 'List available subscription plans with pricing. Use to compare plans before subscribing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                currency: { type: 'string', enum: ['NGN', 'USD', 'EUR', 'GBP'], description: 'Filter prices by currency' },
+                interval: { type: 'string', enum: ['MONTHLY', 'YEARLY'], description: 'Filter by billing interval' },
+            },
+        },
+    },
+    {
+        name: 'get_credit_packages',
+        description: 'List available credit packages for pay-as-you-go purchases, with pricing and bonus credits.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                currency: { type: 'string', enum: ['NGN', 'USD', 'EUR', 'GBP'], description: 'Filter prices by currency' },
+                featured: { type: 'boolean', description: 'Only show featured packages' },
+            },
+        },
+    },
+    {
+        name: 'get_active_subscription',
+        description: 'Get the current active subscription details: plan, credits per period, billing dates, and status.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_subscription_history',
+        description: 'Get the history of all subscriptions for the organization.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'purchase_credits',
+        description: 'Initiate a credit package purchase. Returns a checkout URL for payment completion.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                packageId: { type: 'string', description: 'Credit package ID (from get_credit_packages)' },
+                currency: { type: 'string', enum: ['NGN', 'USD', 'EUR', 'GBP'], description: 'Payment currency' },
+                successUrl: { type: 'string', description: 'Redirect URL after successful payment' },
+                cancelUrl: { type: 'string', description: 'Redirect URL if payment is cancelled' },
+            },
+            required: ['packageId', 'currency'],
+        },
+    },
+    {
+        name: 'get_payment_history',
+        description: 'Get payment transaction history with optional filtering.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: { type: 'integer', minimum: 1, description: 'Page number' },
+                limit: { type: 'integer', minimum: 1, maximum: 100, description: 'Results per page' },
+                status: { type: 'string', enum: ['PENDING', 'PROCESSING', 'SUCCEEDED', 'FAILED', 'CANCELLED', 'REFUNDED'] },
+            },
+        },
+    },
+    {
+        name: 'get_transaction_history',
+        description: 'Get credit transaction ledger: purchases, consumption, refunds, bonuses. Filterable by type and date.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: { type: 'integer', minimum: 1 },
+                limit: { type: 'integer', minimum: 1, maximum: 100 },
+                type: { type: 'string', enum: ['PURCHASE', 'CONSUMPTION', 'REFUND', 'BONUS', 'MANUAL', 'SUBSCRIPTION'], description: 'Filter by transaction type' },
+                creditPool: { type: 'string', enum: ['subscription', 'payg'], description: 'Filter by credit pool' },
+                startDate: { type: 'string', description: 'From date (YYYY-MM-DD)' },
+                endDate: { type: 'string', description: 'To date (YYYY-MM-DD)' },
+            },
+        },
+    },
+    {
+        name: 'get_usage_analytics',
+        description: 'Get usage analytics: total submissions, credits used, cost per submission, daily breakdown.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                startDate: { type: 'string', description: 'Period start (YYYY-MM-DD)' },
+                endDate: { type: 'string', description: 'Period end (YYYY-MM-DD)' },
+                period: { type: 'string', enum: ['day', 'week', 'month'], description: 'Grouping period' },
+            },
+        },
+    },
+    {
+        name: 'get_consumption_breakdown',
+        description: 'Get credit consumption breakdown by API endpoint/service. Shows which operations consume the most credits.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+// ─── Tool Handler ────────────────────────────────────────
+async function handleBillingTool(name, args, client) {
+    try {
+        switch (name) {
+            case 'get_billing_account': {
+                const res = await client.getBillingAccount();
+                const bal = res.data.creditBalance;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `Balance: ${bal} credits (${res.data.status}).`) }] };
+            }
+            case 'check_balance': {
+                const credits = Number((0, format_js_1.requiredParam)(args, 'credits'));
+                const res = await client.checkBalance(credits);
+                const msg = res.data.sufficient
+                    ? `Sufficient balance: ${res.data.currentBalance} credits available (need ${credits}).`
+                    : `Insufficient balance: ${res.data.currentBalance} credits available, need ${credits} (deficit: ${res.data.deficit}).`;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, msg) }] };
+            }
+            case 'get_billing_setup': {
+                const res = await client.getBillingSetup();
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res) }] };
+            }
+            case 'get_subscription_plans': {
+                const res = await client.getSubscriptionPlans(args);
+                const count = Array.isArray(res.data) ? res.data.length : 0;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `${count} subscription plans available.`) }] };
+            }
+            case 'get_credit_packages': {
+                const res = await client.getCreditPackages(args);
+                const count = Array.isArray(res.data) ? res.data.length : 0;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `${count} credit packages available.`) }] };
+            }
+            case 'get_active_subscription': {
+                const res = await client.getActiveSubscription();
+                const sub = res.data;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `Plan: ${sub.planName} (${sub.status}), ${sub.creditsPerPeriod} credits/${sub.interval.toLowerCase()}.`) }] };
+            }
+            case 'get_subscription_history': {
+                const res = await client.getSubscriptionHistory();
+                const count = Array.isArray(res.data) ? res.data.length : 0;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `${count} subscriptions in history.`) }] };
+            }
+            case 'purchase_credits': {
+                const body = { ...args };
+                const res = await client.purchaseCredits(body);
+                const msg = res.data.checkoutUrl
+                    ? `Payment initiated. Checkout URL: ${res.data.checkoutUrl}`
+                    : `Purchase completed. Credits granted: ${res.data.creditsGranted}.`;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, msg) }] };
+            }
+            case 'get_payment_history': {
+                const res = await client.getPaymentHistory(args);
+                const count = Array.isArray(res.data) ? res.data.length : 0;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `${count} payments found.`) }] };
+            }
+            case 'get_transaction_history': {
+                const res = await client.getTransactionHistory(args);
+                const count = Array.isArray(res.data) ? res.data.length : 0;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `${count} transactions found.`) }] };
+            }
+            case 'get_usage_analytics': {
+                const res = await client.getUsageAnalytics(args);
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `Submissions: ${res.data.totalSubmissions}, Credits used: ${res.data.creditsUsed}.`) }] };
+            }
+            case 'get_consumption_breakdown': {
+                const res = await client.getConsumptionBreakdown();
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res) }] };
+            }
+            default:
+                return { content: [{ type: 'text', text: `Unknown billing tool: ${name}` }], isError: true };
+        }
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: (0, format_js_1.formatError)(error) }], isError: true };
+    }
+}
+//# sourceMappingURL=billing-tools.js.map

package/dist/tools/billing-tools.js.map

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

package/dist/tools/buyer-tools.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { InvoiceClient } from '../client/invoice-client.js';
+export declare const buyerToolDefinitions: Tool[];
+export declare function handleBuyerTool(name: string, args: Record<string, unknown>, client: InvoiceClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=buyer-tools.d.ts.map

package/dist/tools/buyer-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer-tools.d.ts","sourceRoot":"","sources":["../../src/tools/buyer-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,eAAO,MAAM,oBAAoB,EAAE,IAAI,EA+FtC,CAAC;AAEF,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA4ChF"}

package/dist/tools/buyer-tools.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buyerToolDefinitions = void 0;
+exports.handleBuyerTool = handleBuyerTool;
+const format_js_1 = require("../utils/format.js");
+exports.buyerToolDefinitions = [
+    {
+        name: 'create_buyer',
+        description: 'Register a new buyer entity. Buyers must be registered before creating invoices.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                companyName: { type: 'string', description: 'Business name' },
+                tin: { type: 'string', description: 'Tax ID (format: XXXXXXXX-XXXX)' },
+                email: { type: 'string', description: 'Contact email' },
+                phoneNumber: { type: 'string', description: 'Phone (international format, starts with +)' },
+                postalAddress: {
+                    type: 'object',
+                    properties: {
+                        streetName: { type: 'string' },
+                        cityName: { type: 'string' },
+                        countrySubentity: { type: 'string', description: 'State/Province' },
+                        postalZone: { type: 'string' },
+                        countryCode: { type: 'string', description: 'ISO 3166-1 alpha-2' },
+                    },
+                    required: ['streetName', 'cityName', 'countrySubentity', 'countryCode'],
+                },
+                tradingName: { type: 'string' },
+                registrationNumber: { type: 'string' },
+                buyerType: { type: 'string', enum: ['COMPANY', 'INDIVIDUAL', 'OTHER'] },
+            },
+            required: ['companyName', 'tin', 'email', 'phoneNumber', 'postalAddress'],
+        },
+    },
+    {
+        name: 'get_buyer',
+        description: 'Get full details of a buyer by ID.',
+        inputSchema: {
+            type: 'object',
+            properties: { buyerId: { type: 'string', description: 'Buyer ID' } },
+            required: ['buyerId'],
+        },
+    },
+    {
+        name: 'list_buyers',
+        description: 'List buyers with optional filtering and search.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: { type: 'integer', minimum: 1 },
+                limit: { type: 'integer', minimum: 1, maximum: 100 },
+                status: { type: 'string', enum: ['PENDING_VERIFICATION', 'ACTIVE', 'SUSPENDED', 'INACTIVE'] },
+                search: { type: 'string', description: 'Search by name or TIN' },
+                buyerType: { type: 'string', enum: ['COMPANY', 'INDIVIDUAL', 'OTHER'] },
+            },
+        },
+    },
+    {
+        name: 'update_buyer',
+        description: 'Update a buyer. TIN cannot be changed after creation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                buyerId: { type: 'string', description: 'Buyer ID to update' },
+                companyName: { type: 'string' },
+                email: { type: 'string' },
+                phoneNumber: { type: 'string' },
+                postalAddress: { type: 'object' },
+                registrationNumber: { type: 'string' },
+            },
+            required: ['buyerId'],
+        },
+    },
+    {
+        name: 'delete_buyer',
+        description: 'Delete a buyer that has no invoices.',
+        inputSchema: {
+            type: 'object',
+            properties: { buyerId: { type: 'string', description: 'Buyer ID to delete' } },
+            required: ['buyerId'],
+        },
+    },
+    {
+        name: 'verify_buyer_tin',
+        description: 'Trigger TIN verification for a buyer with FIRS.',
+        inputSchema: {
+            type: 'object',
+            properties: { buyerId: { type: 'string', description: 'Buyer ID' } },
+            required: ['buyerId'],
+        },
+    },
+    {
+        name: 'get_buyer_verification_status',
+        description: 'Check the TIN verification status of a buyer.',
+        inputSchema: {
+            type: 'object',
+            properties: { buyerId: { type: 'string', description: 'Buyer ID' } },
+            required: ['buyerId'],
+        },
+    },
+];
+async function handleBuyerTool(name, args, client) {
+    try {
+        switch (name) {
+            case 'create_buyer': {
+                const res = await client.createBuyer(args);
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `Buyer "${res.data.partyName}" created (${res.data.tinVerificationStatus}).`) }] };
+            }
+            case 'get_buyer': {
+                const id = (0, format_js_1.requiredParam)(args, 'buyerId');
+                const res = await client.getBuyer(id);
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res) }] };
+            }
+            case 'list_buyers': {
+                const res = await client.listBuyers(args);
+                const count = Array.isArray(res.data) ? res.data.length : 0;
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `Found ${res.meta.pagination?.total ?? count} buyers.`) }] };
+            }
+            case 'update_buyer': {
+                const id = (0, format_js_1.requiredParam)(args, 'buyerId');
+                const { buyerId: _, ...body } = args;
+                const res = await client.updateBuyer(id, body);
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `Buyer "${res.data.partyName}" updated.`) }] };
+            }
+            case 'delete_buyer': {
+                const id = (0, format_js_1.requiredParam)(args, 'buyerId');
+                const res = await client.deleteBuyer(id);
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, 'Buyer deleted.') }] };
+            }
+            case 'verify_buyer_tin': {
+                const id = (0, format_js_1.requiredParam)(args, 'buyerId');
+                const res = await client.verifyBuyerTin(id);
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `TIN verification: ${res.data.tinVerificationStatus}`) }] };
+            }
+            case 'get_buyer_verification_status': {
+                const id = (0, format_js_1.requiredParam)(args, 'buyerId');
+                const res = await client.getBuyerVerificationStatus(id);
+                return { content: [{ type: 'text', text: (0, format_js_1.formatSuccess)(res, `TIN status: ${res.data.tinVerificationStatus}`) }] };
+            }
+            default:
+                return { content: [{ type: 'text', text: `Unknown buyer tool: ${name}` }], isError: true };
+        }
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: (0, format_js_1.formatError)(error) }], isError: true };
+    }
+}
+//# sourceMappingURL=buyer-tools.js.map

package/dist/tools/buyer-tools.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+export { invoiceToolDefinitions, handleInvoiceTool } from './invoice-tools.js';
+export { sellerToolDefinitions, handleSellerTool } from './seller-tools.js';
+export { buyerToolDefinitions, handleBuyerTool } from './buyer-tools.js';
+export { billingToolDefinitions, handleBillingTool } from './billing-tools.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBillingTool = exports.billingToolDefinitions = exports.handleBuyerTool = exports.buyerToolDefinitions = exports.handleSellerTool = exports.sellerToolDefinitions = exports.handleInvoiceTool = exports.invoiceToolDefinitions = void 0;
+var invoice_tools_js_1 = require("./invoice-tools.js");
+Object.defineProperty(exports, "invoiceToolDefinitions", { enumerable: true, get: function () { return invoice_tools_js_1.invoiceToolDefinitions; } });
+Object.defineProperty(exports, "handleInvoiceTool", { enumerable: true, get: function () { return invoice_tools_js_1.handleInvoiceTool; } });
+var seller_tools_js_1 = require("./seller-tools.js");
+Object.defineProperty(exports, "sellerToolDefinitions", { enumerable: true, get: function () { return seller_tools_js_1.sellerToolDefinitions; } });
+Object.defineProperty(exports, "handleSellerTool", { enumerable: true, get: function () { return seller_tools_js_1.handleSellerTool; } });
+var buyer_tools_js_1 = require("./buyer-tools.js");
+Object.defineProperty(exports, "buyerToolDefinitions", { enumerable: true, get: function () { return buyer_tools_js_1.buyerToolDefinitions; } });
+Object.defineProperty(exports, "handleBuyerTool", { enumerable: true, get: function () { return buyer_tools_js_1.handleBuyerTool; } });
+var billing_tools_js_1 = require("./billing-tools.js");
+Object.defineProperty(exports, "billingToolDefinitions", { enumerable: true, get: function () { return billing_tools_js_1.billingToolDefinitions; } });
+Object.defineProperty(exports, "handleBillingTool", { enumerable: true, get: function () { return billing_tools_js_1.handleBillingTool; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,uDAA+E;AAAtE,0HAAA,sBAAsB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAClD,qDAA4E;AAAnE,wHAAA,qBAAqB,OAAA;AAAE,mHAAA,gBAAgB,OAAA;AAChD,mDAAyE;AAAhE,sHAAA,oBAAoB,OAAA;AAAE,iHAAA,eAAe,OAAA;AAC9C,uDAA+E;AAAtE,0HAAA,sBAAsB,OAAA;AAAE,qHAAA,iBAAiB,OAAA"}

package/dist/tools/invoice-tools.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { InvoiceClient } from '../client/invoice-client.js';
+export declare const invoiceToolDefinitions: Tool[];
+export declare function handleInvoiceTool(name: string, args: Record<string, unknown>, client: InvoiceClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=invoice-tools.d.ts.map

package/dist/tools/invoice-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-tools.d.ts","sourceRoot":"","sources":["../../src/tools/invoice-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAKjE,eAAO,MAAM,sBAAsB,EAAE,IAAI,EA0NxC,CAAC;AAIF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyFhF"}