Skip to main content
Glama
finanzas-mcp

finanzas-mcp

by MITDEVPRO

finanzas-mcp

CI PyPI

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.

Demo: Claude calculando un WACC con finanzas-mcp

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.

Related MCP server: cvm-mcp

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

MIT


mcp-name: io.github.MITDEVPRO/finanzas-mcp

Available Tools

25 tools
aging_carteraA
Read-onlyIdempotent

Aging de cartera en tramos estándar (por vencer / 1-30 / 31-60 / 61-90 / 91-180 / +180) con concentración por cliente.

Inputs: documentos (required).

altman_z_scoreB
Read-onlyIdempotent

Altman Z-Score de riesgo de insolvencia, en sus 3 variantes (pública, privada, servicios).

Inputs: ebit (required), patrimonio (required), activos_totales (required), capital_trabajo (required), +4 more.

amortizacion_creditoB
Read-onlyIdempotent

Tabla de amortización de un crédito en sistema francés (cuota fija) o alemán (amortización constante).

Inputs: principal (required), num_cuotas (required), tasa_periodo (required), sistema, +1 more.

capm_costo_equityA
Read-onlyIdempotent

Costo del patrimonio (Ke) vía CAPM, con opción de reapalancar una beta de industria (Hamada).

Inputs: beta (required), tasa_libre_riesgo (required), premio_riesgo_mercado (required), riesgo_pais, +3 more.

correccion_monetariaA
Read-onlyIdempotent

Corrección monetaria de un monto por variación de un índice (IPC/UF): monto corregido y ajuste.

Inputs: monto (required), indice_final (required), indice_inicial (required).

dcfA
Read-onlyIdempotent

Valoración por flujos de caja descontados: valor presente de FCFs + valor terminal (Gordon), EV y valor del equity.

Inputs: tasa_descuento (required), flujos_caja_libre (required), deuda_neta, sensibilidad, +1 more.

depreciacionB
Read-onlyIdempotent

Tabla de depreciación anual por método lineal, acelerada (vida útil ÷ 3) o suma de dígitos.

Inputs: valor_activo (required), vida_util_anios (required), metodo, valor_residual.

dupontA
Read-onlyIdempotent

Descomposición DuPont del ROE en 3 factores (margen × rotación × apalancamiento); 5 factores si se entrega EBIT y UAI.

Inputs: ventas (required), patrimonio (required), utilidad_neta (required), activos_totales (required), +2 more.

escudo_fiscalA
Read-onlyIdempotent

Escudo fiscal: ahorro de impuesto que genera un gasto deducible (gasto × tasa).

Inputs: gasto_deducible (required), tasa_impuesto.

flujo_caja_indirectoA
Read-onlyIdempotent

Flujo de caja por método indirecto: FCO, FCI, FCF (flujo libre) y flujo neto del período.

Inputs: delta_cxc (required), delta_cxp (required), utilidad_neta (required), delta_inventario (required), +6 more.

impuesto_empresaA
Read-onlyIdempotent

Impuesto de primera categoría (Chile): 14A 27%, 14 D N°3 pyme 25%, o tasa configurable; saldo contra PPM.

Inputs: base_imponible (required), regimen, ppm_pagados, tasa_custom.

interes_compuestoA
Read-onlyIdempotent

Interés compuesto: valor futuro o presente, con aportes periódicos opcionales.

Inputs: capital (required), periodos (required), tasa_periodo (required), calcular, +1 more.

ivaA
Read-onlyIdempotent

Agrega o extrae IVA de un monto (Chile 19% por defecto, tasa configurable).

Inputs: monto (required), tasa, operacion.

piotroski_f_scoreA
Read-onlyIdempotent

Piotroski F-Score (0-9) de calidad/fortaleza financiera comparando dos ejercicios.

Inputs: actual (required), anterior (required).

ppm_calculoA
Read-onlyIdempotent

Pago provisional mensual (PPM) sobre ingresos brutos con tasa configurable.

Inputs: ingresos_brutos_mes (required), tasa_ppm.

punto_equilibrioA
Read-onlyIdempotent

Punto de equilibrio en unidades y en monto, con margen de contribución y margen de seguridad.

Inputs: costos_fijos (required), precio_unitario (required), costo_variable_unitario (required), ventas_actuales_unidades.

ratios_eficienciaB
Read-onlyIdempotent

Rotaciones y ciclo de conversión de caja: DIO, DSO, DPO y CCC en días.

Inputs: ventas (required), costo_ventas (required), cxc_promedio (required), cxp_promedio (required), +2 more.

ratios_endeudamientoB
Read-onlyIdempotent

Apalancamiento: leverage, endeudamiento sobre activos, deuda/EBITDA y cobertura de intereses.

Inputs: patrimonio (required), activos_totales (required), pasivos_totales (required), ebit, +3 more.

ratios_liquidezA
Read-onlyIdempotent

Ratios de liquidez: corriente, ácida (quick), de caja y capital de trabajo.

Inputs: activo_corriente (required), pasivo_corriente (required), efectivo, inventario.

ratios_rentabilidadA
Read-onlyIdempotent

Márgenes (bruto, operacional, neto) y retornos ROA / ROE, en porcentaje.

Inputs: ventas (required), patrimonio (required), utilidad_neta (required), utilidad_bruta (required), +2 more.

valoracion_multiplosB
Read-onlyIdempotent

Valoración por múltiplos de comparables (EV/EBITDA, P/E, EV/Ventas) con rango y promedio.

Inputs: ebitda, ventas, deuda_neta, multiplo_pe, +3 more.

van_tirA
Read-onlyIdempotent

Evaluación de proyecto: VAN, TIR, payback simple y descontado, e índice de rentabilidad.

Inputs: flujos (required), tasa_descuento (required), inversion_inicial (required).

variacionA
Read-onlyIdempotent

Variación absoluta y porcentual entre dos valores; CAGR si hay más de un período.

Inputs: valor_actual (required), valor_anterior (required), periodos.

waccC
Read-onlyIdempotent

WACC — costo promedio ponderado de capital, con escudo fiscal de la deuda.

Inputs: costo_deuda (required), valor_deuda (required), costo_equity (required), valor_equity (required), +1 more.

working_capitalA
Read-onlyIdempotent

Capital de trabajo contable y necesidad operativa de fondos (NOF = CxC + inventario - CxP).

Inputs: cxc (required), cxp (required), inventario (required), ventas_anuales, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 25 tools

    Disambiguation5/5

    All 25 tools address distinct financial concepts (breakeven, ratios, valuation, etc.) with no ambiguity. Each tool's description clearly separates it from others, making misselection unlikely.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern using descriptive Spanish nouns (e.g., punto_equilibrio, ratios_liquidez, van_tir). No mix of conventions or unclear abbreviations.

    Tool Count4/5

    With 25 tools, the server is slightly above the typical 3-15 range but justifiable given the breadth of corporate finance topics covered. Each tool serves a unique purpose without redundancy.

    Completeness4/5

    The tool set covers a wide range of financial analyses: ratios, valuation, capital budgeting, taxes, depreciation, working capital, and risk assessment. Minor gaps (e.g., scenario analysis) exist but do not hinder core finance workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Spanish accounting for freelancers and SMEs, enabling AI agents to issue invoices, OCR expense PDFs, reconcile bank transactions, and prepare quarterly VAT (Modelo 303).
      23
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server that fetches Brazilian financial data from the CVM open data portal and exposes tools for LLM clients to query companies and calculate financial indicators from published financial statements.
      4
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      MCP server that provides access to all public data from Chile's Financial Market Commission (CMF), including companies, financial statements, mutual funds, economic indicators, and more, allowing AI agents to connect to official financial regulator information without cost or API keys.
      86
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides deterministic, high-precision business, finance, and operational calculations such as SaaS metrics, currency conversion, business days, and financial formulas, returning structured JSON results.
      11
      41 npm
      MIT