TreePod Financial MCP Agent

Instructions

Implementation Reference

• server.js:262-302 (registration)

  MCP tool registration for 'optimize_pricing', including schema, title, description, and thin handler that validates input and delegates to businessCalculator.optimizePricing
  server.registerTool( 'optimize_pricing', { title: 'Optimizar precios', description: 'Sugiere optimizaciones de precios basado en competencia y ocupación usando datos reales', inputSchema: z.object({ strategy: z.string().default('maximize_revenue'), }), }, async ({ strategy = 'maximize_revenue' }) => { validator.log('info', `Iniciando optimización de precios con estrategia: ${strategy}`); try { // Validar parámetros de entrada const inputValidation = validator.validateUserInput({ strategy }, { strategy: { required: true, type: 'string', enum: ['maximize_revenue', 'maximize_occupancy', 'balanced', 'competitive'] } }); if (!inputValidation.valid) { return validator.generateInsufficientDataResponse( 'estrategia de optimización', `Errores: ${inputValidation.errors.join(', ')}` ); } const result = await businessCalculator.optimizePricing(strategy); validator.log('info', 'Optimización de precios completada exitosamente'); return result; } catch (error) { validator.log('error', `Error crítico en optimización de precios: ${error.message}`); return validator.generateInsufficientDataResponse( 'optimización de precios', 'Error interno del sistema. Contacta al administrador.' ); } } );
• server.js:267-270 (schema)

  Input schema using Zod: strategy string defaulting to 'maximize_revenue'
  inputSchema: z.object({ strategy: z.string().default('maximize_revenue'), }), },
• src/business/calculator.js:1111-1149 (handler)

  Core handler logic in BusinessCalculator.optimizePricing: loads real data sources, computes pricing optimization based on strategy, formats response
  async optimizePricing(strategy) { validator.log('info', `Iniciando optimización de precios con estrategia: ${strategy}`); try { // Cargar datos reales necesarios const financialData = await dataLoader.loadFinancialData(); const businessData = await dataLoader.loadBusinessStatus(); const competitionData = await dataLoader.loadCompetitionData(); // Validar que tenemos datos suficientes if (!financialData && !businessData) { return validator.generateInsufficientDataResponse( 'datos para optimización de precios', 'No se pudo acceder a los datos financieros ni de estado del negocio' ); } const optimization = this.calculatePricingOptimization( strategy, financialData, businessData, competitionData ); return { content: [{ type: 'text', text: this.formatPricingOptimization(optimization, strategy) }] }; } catch (error) { validator.log('error', `Error en optimización de precios: ${error.message}`); return validator.generateInsufficientDataResponse( 'optimización de precios', 'Error interno en el análisis. Contacta al administrador.' ); } }
• src/business/calculator.js:1151-1195 (helper)

  Helper that performs the pricing optimization calculation based on strategy and loaded data, populates recommendation structure
  calculatePricingOptimization(strategy, financialData, businessData, competitionData) { const currentOccupancy = financialData?.ocupacion_promedio || businessData?.occupancy || 0; const currentRevenue = financialData?.ingresos_total || 0; const averageRate = currentRevenue > 0 && financialData?.reservas_totales > 0 ? Math.round(currentRevenue / financialData.reservas_totales) : 0; const optimization = { strategy, current_metrics: { occupancy: currentOccupancy, revenue: currentRevenue, average_rate: averageRate }, recommendations: [], price_adjustments: [], expected_impact: {}, implementation_steps: [], monitoring_kpis: [] }; // Análisis por estrategia switch (strategy) { case 'maximize_revenue': this.addRevenueMaximizationStrategy(optimization, currentOccupancy); break; case 'maximize_occupancy': this.addOccupancyMaximizationStrategy(optimization, currentOccupancy); break; case 'balanced': this.addBalancedStrategy(optimization, currentOccupancy); break; case 'competitive': this.addCompetitiveStrategy(optimization, competitionData); break; default: optimization.recommendations.push('Estrategia no reconocida, aplicando estrategia balanceada'); this.addBalancedStrategy(optimization, currentOccupancy); } // Agregar consideraciones generales this.addGeneralPricingConsiderations(optimization); return optimization; }
• src/business/calculator.js:1275-1343 (helper)

  Helper to format the pricing optimization results into a structured text report for MCP response
  formatPricingOptimization(optimization, strategy) { const strategyNames = { maximize_revenue: 'Maximizar Ingresos', maximize_occupancy: 'Maximizar Ocupación', balanced: 'Estrategia Balanceada', competitive: 'Estrategia Competitiva' }; let report = `💰 **OPTIMIZACIÓN DE PRECIOS TREEPOD**\n\n`; report += `🎯 **Estrategia:** ${strategyNames[strategy] || strategy}\n\n`; // Métricas actuales report += `📊 **MÉTRICAS ACTUALES:**\n`; report += `• Ocupación: ${optimization.current_metrics.occupancy}%\n`; if (optimization.current_metrics.revenue > 0) { report += `• Ingresos: ${this.formatCurrency(optimization.current_metrics.revenue)}\n`; } if (optimization.current_metrics.average_rate > 0) { report += `• Tarifa promedio: ${this.formatCurrency(optimization.current_metrics.average_rate)}\n`; } report += `\n`; // Recomendaciones report += `🎯 **RECOMENDACIONES:**\n`; optimization.recommendations.forEach(rec => { report += `• ${rec}\n`; }); report += `\n`; // Ajustes de precios if (optimization.price_adjustments.length > 0) { report += `💲 **AJUSTES SUGERIDOS:**\n`; optimization.price_adjustments.forEach(adj => { report += `• ${adj}\n`; }); report += `\n`; } // Impacto esperado if (Object.keys(optimization.expected_impact).length > 0) { report += `📈 **IMPACTO ESPERADO:**\n`; if (optimization.expected_impact.revenue) { report += `• Ingresos: ${optimization.expected_impact.revenue}\n`; } if (optimization.expected_impact.occupancy) { report += `• Ocupación: ${optimization.expected_impact.occupancy}\n`; } report += `\n`; } // Pasos de implementación if (optimization.implementation_steps.length > 0) { report += `🔧 **IMPLEMENTACIÓN:**\n`; optimization.implementation_steps.forEach((step, index) => { report += `${index + 1}. ${step}\n`; }); report += `\n`; } // KPIs de monitoreo if (optimization.monitoring_kpis.length > 0) { report += `📊 **KPIS A MONITOREAR:**\n`; optimization.monitoring_kpis.forEach(kpi => { report += `• ${kpi}\n`; }); } return report; }