TreePod Financial MCP Agent

Instructions

Implementation Reference

• server.js:62-91 (registration)

  Registration of the 'calculate_tariff' tool with MCP server, including input schema, title, description, and a thin async handler that delegates to businessCalculator.calculateTariff with logging and error handling.

  server.registerTool(
    'calculate_tariff',
    {
      title: 'Calcular tarifa',
      description: 'Calcula tarifas para reservas según temporada, personas y canal basado en configuración real',
      inputSchema: z.object({
        checkin_date: z.string(),
        checkout_date: z.string(),
        guests: z.number().min(1).max(4),
        channel: z.string().optional().default('directo'),
      }),
    },
    async ({ checkin_date, checkout_date, guests, channel = 'directo' }) => {
      validator.log('info', `Iniciando cálculo de tarifa: ${guests} huéspedes, ${checkin_date} a ${checkout_date}, canal ${channel}`);
      
      try {
        // Usar módulo de cálculo sin hardcodeo
        const result = await businessCalculator.calculateTariff(checkin_date, checkout_date, guests, channel);
        
        validator.log('info', 'Cálculo de tarifa completado exitosamente');
        return result;
        
      } catch (error) {
        validator.log('error', `Error crítico en cálculo de tarifa: ${error.message}`);
        return validator.generateInsufficientDataResponse(
          'cálculo de tarifa',
          'Error interno del sistema. Contacta al administrador.'
        );
      }
    }

• src/business/calculator.js:15-113 (handler)

  Core implementation of the tariff calculation: validates inputs and dates, loads financial configuration data, determines season, calculates base tariff and commission based on channel, computes total, and formats response.

  async calculateTariff(checkinDate, checkoutDate, guests, channel = 'directo') {
    // Validar parámetros de entrada
    const inputValidation = validator.validateUserInput({
      checkin_date: checkinDate,
      checkout_date: checkoutDate,
      guests: guests,
      channel: channel
    }, {
      checkin_date: { required: true, type: 'string' },
      checkout_date: { required: true, type: 'string' },
      guests: { required: true, type: 'number', min: 1, max: 4 },
      channel: { required: false, type: 'string', enum: ['directo', 'airbnb', 'booking', 'whatsapp'] }
    });
  
    if (!inputValidation.valid) {
      return validator.generateInsufficientDataResponse(
        'parámetros de tarifa', 
        `Errores: ${inputValidation.errors.join(', ')}`
      );
    }
  
    // Validar fechas
    const dateValidation = validator.validateDateRange(checkinDate, checkoutDate);
    if (!dateValidation.valid) {
      return validator.generateInsufficientDataResponse(
        'fechas de reserva',
        dateValidation.error
      );
    }
  
    // Cargar configuración de tarifas desde datos reales
    const financialData = await dataLoader.loadFinancialData();
    if (!financialData || !financialData.configuracion_negocio) {
      return validator.generateInsufficientDataResponse(
        'configuración de tarifas',
        'No se pudo acceder a la configuración de precios del sistema'
      );
    }
  
    const config = financialData.configuracion_negocio;
    
    // Verificar que existen las tarifas por temporada
    if (!config.tarifas_temporada) {
      return validator.generateInsufficientDataResponse(
        'tarifas por temporada',
        'La configuración no incluye tarifas por temporada'
      );
    }
  
    try {
      const season = this.determineSeason(dateValidation.checkin, config);
      const seasonData = config.tarifas_temporada[season];
      
      if (!seasonData) {
        return validator.generateInsufficientDataResponse(
          `tarifas para temporada ${season}`,
          'No se encontraron tarifas para la temporada solicitada'
        );
      }
  
      // Calcular tarifa base según número de huéspedes
      const baseTariff = this.calculateBaseTariff(guests, seasonData);
      const nights = dateValidation.nights;
      const subtotal = baseTariff * nights;
      
      // Calcular comisión según canal
      const commissionRate = this.getCommissionRate(channel, config);
      const commission = Math.round(subtotal * commissionRate);
      const total = subtotal + commission;
  
      validator.log('info', `Tarifa calculada: ${guests} huéspedes, ${nights} noches, temporada ${season}, canal ${channel}`);
  
      return {
        content: [{
          type: 'text',
          text: this.formatTariffResponse({
            checkinDate,
            checkoutDate,
            guests,
            channel,
            season,
            nights,
            baseTariff,
            subtotal,
            commissionRate: commissionRate * 100,
            commission,
            total
          })
        }]
      };
  
    } catch (error) {
      validator.log('error', `Error calculando tarifa: ${error.message}`);
      return validator.generateInsufficientDataResponse(
        'cálculo de tarifa',
        'Error interno en el cálculo. Contacta al administrador.'
      );
    }
  }

• src/business/calculator.js:118-141 (helper)

  Helper method to determine the season (alta, media, etc.) for the given check-in date using business configuration or fallback logic.

  determineSeason(date, config) {
    if (!config.temporadas) {
      validator.log('warning', 'Configuración de temporadas no encontrada, usando lógica por defecto');
      // Lógica básica si no hay configuración
      const month = date.getMonth() + 1;
      if (month >= 12 || month <= 2) return 'alta';
      if (month >= 6 && month <= 8) return 'alta';
      return 'media';
    }
  
    // Usar configuración real de temporadas
    const month = date.getMonth() + 1;
    const day = date.getDate();
    
    for (const [seasonName, periods] of Object.entries(config.temporadas)) {
      for (const period of periods) {
        if (this.isDateInPeriod(month, day, period)) {
          return seasonName;
        }
      }
    }
    
    return 'media'; // temporada por defecto
  }

• src/business/calculator.js:171-182 (helper)

  Helper method to compute the base nightly tariff based on number of guests and season data configuration.

  calculateBaseTariff(guests, seasonData) {
    if (seasonData.por_huesped && seasonData.tarifa_base_por_persona) {
      return seasonData.tarifa_base_por_persona * guests;
    }
    
    if (seasonData.tarifas_por_ocupacion) {
      const guestKey = `${guests}_personas`;
      return seasonData.tarifas_por_ocupacion[guestKey] || seasonData.tarifa_base || 80000;
    }
    
    return seasonData.tarifa_base || 80000;
  }

• src/business/calculator.js:187-200 (helper)

  Helper method to get the commission rate for the booking channel from configuration or defaults.

  getCommissionRate(channel, config) {
    if (!config.comisiones_canal) {
      validator.log('warning', 'Configuración de comisiones no encontrada, usando valores por defecto');
      const defaultRates = {
        'directo': 0,
        'airbnb': 0.15,
        'booking': 0.18,
        'whatsapp': 0.05
      };
      return defaultRates[channel] || 0;
    }
    
    return config.comisiones_canal[channel] || 0;
  }