@fullqueso/mcp-bc-gastos 1.10.0 → 1.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "MCP server for Business Central operational expense analysis, bank reconciliation, POS reconciliation, accounts receivable/payable, and multi-payment draft visibility - Full Queso franchise stores",
   "main": "server.js",
   "bin": {

package/server.js

@@ -32,6 +32,7 @@ import { expenseDetailsTool, handleExpenseDetails } from './tools/expense-detail
 import { accountTransactionsTool, handleAccountTransactions } from './tools/account-transactions.js';
 import { vendorTransactionsTool, handleVendorTransactions } from './tools/vendor-transactions.js';
 import { listVendorsTool, handleListVendors } from './tools/list-vendors.js';
+import { exchangeRateTool, handleGetExchangeRate } from './tools/get-exchange-rate.js';
 
 // Auditoria tools (bank reconciliation)
 import { listBankAccountsTool, handleListBankAccounts } from './tools/auditoria/list-bank-accounts.js';
@@ -86,6 +87,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       accountTransactionsTool,
       vendorTransactionsTool,
       listVendorsTool,
+      exchangeRateTool,
       // Auditoria (bank reconciliation)
       listBankAccountsTool,
       reconciliationStatusTool,
@@ -145,6 +147,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'list_vendors':
         result = await handleListVendors(bcClient, args);
         break;
+      case 'get_exchange_rate':
+        result = await handleGetExchangeRate(bcClient, args);
+        break;
       // Auditoria (bank reconciliation)
       case 'list_bank_accounts':
         result = await handleListBankAccounts(bcClient, args);

package/tools/get-exchange-rate.js

@@ -0,0 +1,112 @@
+import { resolveStores } from '../config/company-config.js';
+import { round2 } from '../utils/currency-converter.js';
+
+export const exchangeRateTool = {
+  name: 'get_exchange_rate',
+  description:
+    'Obtiene la tasa de cambio USD → VES desde Business Central. Modo fecha: retorna la tasa vigente para una fecha específica. Modo rango: retorna el historial de tasas en un período.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      store: {
+        type: 'string',
+        enum: ['FQ01', 'FQ28', 'FQ88'],
+        description: 'Tienda a consultar.',
+      },
+      date: {
+        type: 'string',
+        description:
+          'Fecha específica (YYYY-MM-DD). Retorna la tasa vigente (más reciente en o antes de esa fecha). Si no se indica fecha ni rango, usa hoy.',
+      },
+      start_date: {
+        type: 'string',
+        description:
+          'Inicio del rango (YYYY-MM-DD). Usar junto con end_date para obtener historial de tasas.',
+      },
+      end_date: {
+        type: 'string',
+        description:
+          'Fin del rango (YYYY-MM-DD). Usar junto con start_date para obtener historial de tasas.',
+      },
+    },
+    required: ['store'],
+  },
+};
+
+export async function handleGetExchangeRate(bcClient, args) {
+  const store = args.store;
+  if (!store) throw new Error('Parámetro requerido: store');
+
+  const stores = resolveStores([store]);
+  const storeInfo = stores[0];
+
+  const rates = await bcClient.getExchangeRates(store);
+
+  if (!rates || rates.length === 0) {
+    return {
+      store,
+      store_name: storeInfo.name,
+      error: 'No se encontraron tasas de cambio VES en Business Central.',
+    };
+  }
+
+  // Range mode
+  if (args.start_date && args.end_date) {
+    const filtered = rates.filter(
+      (r) => r.startingDate >= args.start_date && r.startingDate <= args.end_date
+    );
+
+    const rateList = filtered.map((r) => {
+      const rate = round2(r.exchangeRateAmount / r.relationalExchangeRateAmount);
+      return {
+        starting_date: r.startingDate,
+        rate,
+        label: `1 USD = ${rate} VES`,
+      };
+    });
+
+    // Also get the rate applicable at start_date (may be before the range)
+    const rateAtStart = bcClient.getExchangeRateForDate(rates, args.start_date);
+
+    return {
+      store,
+      store_name: storeInfo.name,
+      start_date: args.start_date,
+      end_date: args.end_date,
+      rate_at_start: rateAtStart
+        ? {
+            rate: round2(rateAtStart.rate),
+            starting_date: rateAtStart.startingDate,
+            label: `1 USD = ${round2(rateAtStart.rate)} VES`,
+          }
+        : null,
+      rates_in_range: rateList,
+      count: rateList.length,
+    };
+  }
+
+  // Single date mode (default: today)
+  const targetDate = args.date || new Date().toISOString().slice(0, 10);
+  const found = bcClient.getExchangeRateForDate(rates, targetDate);
+
+  if (!found) {
+    return {
+      store,
+      store_name: storeInfo.name,
+      date: targetDate,
+      exchange_rate: null,
+      message: 'No se encontró tasa de cambio para la fecha indicada.',
+    };
+  }
+
+  return {
+    store,
+    store_name: storeInfo.name,
+    date: targetDate,
+    exchange_rate: {
+      rate: round2(found.rate),
+      starting_date: found.startingDate,
+      label: `1 USD = ${round2(found.rate)} VES`,
+    },
+  };
+}