finanzas-mcp
Servidor MCP (Model Context Protocol) de calculadoras financieras genéricas, en español, para usar con Claude Desktop, Claude Code o cualquier cliente MCP.
25 herramientas de cálculo puro: todas operan sobre los datos que tú entregas — el servidor no se conecta a internet, a bases de datos ni guarda estado. Sirve para cualquier empresa, en cualquier moneda.
Finance calculators as an MCP server (Spanish-first): ratios, DuPont, Altman Z-Score, Piotroski F-Score, WACC, CAPM, DCF, multiples, NPV/IRR, break-even, valued cash conversion cycle ($ per day, multi-country), AR aging, depreciation, loan amortization, indirect cash flow, and Chilean tax helpers (VAT, corporate tax, monetary correction). Pure computation, no external connections.
Herramientas
| Módulo | Tools |
|---|---|
| Ratios y diagnóstico | ratios_liquidez · ratios_rentabilidad · ratios_eficiencia (DIO/DSO/DPO/CCC) · ciclo_caja (CCC valorizado: $ por día + multipaís) · ratios_endeudamiento · dupont (3 y 5 factores) · altman_z_score (3 variantes) · piotroski_f_score · working_capital (NOF) |
| Valoración | capm_costo_equity (con beta Hamada) · wacc · dcf (con sensibilidad WACC×g) · valoracion_multiplos · van_tir (VAN, TIR, payback) |
| Operación | punto_equilibrio · variacion (Δ, %, CAGR) · aging_cartera · depreciacion (lineal/acelerada/suma dígitos) · amortizacion_credito (francés/alemán) · interes_compuesto · flujo_caja_indirecto |
| Tributario (Chile, parametrizable) | iva · impuesto_empresa (14A/14D3/custom) · correccion_monetaria · escudo_fiscal · ppm_calculo |
Convenciones: tasas en decimales (0.10 = 10 %), montos en la moneda que uses, resultados con interpretación incluida donde aporta.
Instalación
Claude Desktop / Claude Code (con uv)
{
"mcpServers": {
"finanzas": {
"command": "uvx",
"args": ["finanzas-mcp"]
}
}
}
En Claude Code basta:
claude mcp add finanzas -- uvx finanzas-mcp
Desde el código clonado
git clone https://github.com/MITDEVPRO/finanzas-mcp
cd finanzas-mcp
uv run finanzas-mcp # o: pip install -e . && finanzas-mcp
Ejemplos de uso (en tu cliente MCP)
- "Calcula la liquidez con activo corriente 850M, pasivo corriente 260M, inventario 420M"
- "Valoriza por DCF: FCF 1.200, 1.350, 1.500; WACC 11%; g 2,5%; deuda neta 2.000"
- "¿Cuál es el Z-Score? Activos 10.000M, pasivos 6.000M, WC 1.800M, utilidades retenidas 2.500M, EBIT 900M, patrimonio 4.000M"
- "Tabla de un crédito de 50M a 60 cuotas, 1,1% mensual, sistema francés"
- "Aging de estas facturas: [{monto: 12M, dias_vencido: 45, cliente: 'ACME'}, …]"
¿Quieres ver las salidas completas? En examples/ hay 4 casos resueltos de una misma empresa — WACC → DCF con sensibilidad → Z-Score → punto de equilibrio — con los outputs reales de cada tool.
¿Te sirvió?
Si finanzas-mcp te ahorró un cálculo (o una discusión de comité), la mejor forma de apoyarlo es una ⭐ en este repo — es lo que hace que más gente lo encuentre. Y si te falta una calculadora, abre un issue: las nuevas tools salen de ahí.
English
finanzas-mcp is an MCP (Model Context Protocol) server with 25 pure-computation finance calculators, Spanish-first with self-describing schemas. It runs locally over stdio: no internet, no databases, no state — it only computes on the numbers you provide, so it works for any company and any currency.
Tools: liquidity/profitability/efficiency/leverage ratios · DuPont (3 & 5 factor) · Altman Z-Score (3 variants) · Piotroski F-Score · working capital · CAPM (with Hamada beta) · WACC · DCF with sensitivity · valuation multiples · NPV/IRR/payback · break-even · valued cash conversion cycle ($/day per lever, multi-country) · AR aging · depreciation · loan amortization (French/German) · compound interest · indirect cash flow · Chilean tax helpers (VAT, corporate tax, monetary correction, tax shield — all parameterizable).
Install (Claude Desktop / Claude Code, requires uv):
claude mcp add finanzas -- uvx finanzas-mcp
Try prompts like: "Compute WACC: equity 60%, cost of equity 12%, cost of debt 6%, tax rate 27%" or "DCF this: FCF 1200, 1350, 1500; WACC 11%; g 2.5%; net debt 2000". Tool descriptions are in Spanish, but Claude bridges languages transparently — ask in English and it just works.
If it saves you a calculation, a ⭐ star helps others find it. Missing a calculator? Open an issue.
Desarrollo
uv run --group dev pytest # 20 tests de la matemática financiera
Estructura: src/finanzas_mcp/ — app.py (instancia FastMCP) + 4 módulos de tools + server.py (entry point stdio). SDK oficial mcp.
Disclaimer
Los resultados son referenciales y educativos: no constituyen asesoría financiera, tributaria ni de inversión. Las tasas tributarias chilenas (IVA 19 %, 14A 27 %, 14D3 25 %) son las vigentes al momento de publicar y son parametrizables en cada tool.
Licencia
mcp-name: io.github.MITDEVPRO/finanzas-mcp