{
  "markdown": "# finanzas-mcp\n\n[![CI](https://github.com/MITDEVPRO/finanzas-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/MITDEVPRO/finanzas-mcp/actions/workflows/ci.yml) [![PyPI](https://img.shields.io/pypi/v/finanzas-mcp)](https://pypi.org/project/finanzas-mcp/)\n\nServidor **MCP** (Model Context Protocol) de **calculadoras financieras genéricas**, en español, para usar con Claude Desktop, Claude Code o cualquier cliente MCP.\n\n**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.\n\n> *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.*\n\n![Demo: Claude calculando un WACC con finanzas-mcp](docs/demo.png)\n\n## Herramientas\n\n| Módulo | Tools |\n|---|---|\n| **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) |\n| **Valoración** | `capm_costo_equity` (con beta Hamada) · `wacc` · `dcf` (con sensibilidad WACC×g) · `valoracion_multiplos` · `van_tir` (VAN, TIR, payback) |\n| **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` |\n| **Tributario (Chile, parametrizable)** | `iva` · `impuesto_empresa` (14A/14D3/custom) · `correccion_monetaria` · `escudo_fiscal` · `ppm_calculo` |\n\nConvenciones: **tasas en decimales** (`0.10` = 10 %), montos en la moneda que uses, resultados con interpretación incluida donde aporta.\n\n## Instalación\n\n### Claude Desktop / Claude Code (con [uv](https://docs.astral.sh/uv/))\n\n```json\n{\n  \"mcpServers\": {\n    \"finanzas\": {\n      \"command\": \"uvx\",\n      \"args\": [\"finanzas-mcp\"]\n    }\n  }\n}\n```\n\nEn Claude Code basta:\n\n```bash\nclaude mcp add finanzas -- uvx finanzas-mcp\n```\n\n### Desde el código clonado\n\n```bash\ngit clone https://github.com/MITDEVPRO/finanzas-mcp\ncd finanzas-mcp\nuv run finanzas-mcp        # o: pip install -e . && finanzas-mcp\n```\n\n## Ejemplos de uso (en tu cliente MCP)\n\n- *\"Calcula la liquidez con activo corriente 850M, pasivo corriente 260M, inventario 420M\"*\n- *\"Valoriza por DCF: FCF 1.200, 1.350, 1.500; WACC 11%; g 2,5%; deuda neta 2.000\"*\n- *\"¿Cuál es el Z-Score? Activos 10.000M, pasivos 6.000M, WC 1.800M, utilidades retenidas 2.500M, EBIT 900M, patrimonio 4.000M\"*\n- *\"Tabla de un crédito de 50M a 60 cuotas, 1,1% mensual, sistema francés\"*\n- *\"Aging de estas facturas: [{monto: 12M, dias_vencido: 45, cliente: 'ACME'}, …]\"*\n\n¿Quieres ver las salidas completas? En [`examples/`](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.\n\n## ¿Te sirvió?\n\nSi 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](https://github.com/MITDEVPRO/finanzas-mcp/issues): las nuevas tools salen de ahí.\n\n## English\n\n**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.\n\n**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).\n\n**Install** (Claude Desktop / Claude Code, requires [uv](https://docs.astral.sh/uv/)):\n\n```bash\nclaude mcp add finanzas -- uvx finanzas-mcp\n```\n\n**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.\n\nIf it saves you a calculation, a **⭐ star** helps others find it. Missing a calculator? [Open an issue](https://github.com/MITDEVPRO/finanzas-mcp/issues).\n\n## Desarrollo\n\n```bash\nuv run --group dev pytest        # 20 tests de la matemática financiera\n```\n\nEstructura: `src/finanzas_mcp/` — `app.py` (instancia FastMCP) + 4 módulos de tools + `server.py` (entry point stdio). SDK oficial [`mcp`](https://github.com/modelcontextprotocol/python-sdk).\n\n## Disclaimer\n\nLos 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.\n\n## Licencia\n\n[MIT](LICENSE)\n\n---\n\n`mcp-name: io.github.MITDEVPRO/finanzas-mcp`\n",
  "bytes": 5696,
  "sha": "b3be807aba214adca62fa7ccc7df5a7cac2faffcab3c1c3f6eb2aaa698e68027",
  "repo_slug": "mitdevpro/finanzas-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mitdevpro_finanzas_mcp_a1cf0e16/readme"
}