finanzas MCP server
✓ VerifiedPerforms complex financial computations including ratios, DCF, WACC, and Chilean tax calculations using user-provided data.
Also known as MITDEVPRO/finanzas-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- 155
- Latest version
- 0.1.3
- Last commit
- Aug 5, 2026
- License
- MIT
What is finanzas MCP?
finanzas performs complex financial computations including ratios, DCF, WACC, and Chilean tax calculations using user-provided data.
Summary generated from the project's README
About finanzas MCP server
Performing complex financial modeling and tax calculations from within Claude Desktop or Claude Code is what finanzas-mcp enables. This server provides 25 specialized tools for pure computation, allowing users to process financial data without the server connecting to the internet, external databases, or storing any state. Because it operates solely on the numbers you provide, it remains compatible with any currency or company structure.
Developers and financial analysts can use this local tool via stdio to execute tasks ranging from liquidity and profitability ratios to advanced valuation models like DCF with WACC sensitivity and CAPM using Hamada beta. It also includes operational tools for loan amortization using French or German systems, depreciation schedules, and AR aging. For those working with Chilean regulations, the server includes parameterizable helpers for VAT, corporate tax, and monetary correction. Setup is straightforward using uvx for Claude Desktop or Claude Code, ensuring a private and local environment for sensitive financial math.
What you can do with it
- 1Financial health diagnosticsCalculate the Altman Z-Score to assess the probability of bankruptcy using specific balance sheet figures.
- 2Loan and debt managementGenerate a complete amortization table for a loan using the French repayment system.
- 3Chilean tax complianceCalculate corporate taxes or VAT based on specific Chilean tax regimes.
Written from the project's README. Every use case is checked against a quote from it.
How to install finanzas MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall finanzas MCP in Claude Code
$ claude mcp add finanzas-mcp -- uvx finanzas-mcpInstall finanzas MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"finanzas-mcp": {
"command": "uvx",
"args": [
"finanzas-mcp"
]
}
}
}Install finanzas MCP in VS Code
.vscode/mcp.json
{
"servers": {
"finanzas-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"finanzas-mcp"
]
}
}
}Install finanzas MCP in VS Code CLI
$ code --add-mcp '{"name":"finanzas-mcp","type":"stdio","command":"uvx","args":["finanzas-mcp"]}'Install finanzas MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"finanzas-mcp": {
"command": "uvx",
"args": [
"finanzas-mcp"
]
}
}
}Install finanzas MCP in Codex
$ codex mcp add finanzas-mcp -- uvx finanzas-mcpInstall finanzas MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.finanzas-mcp] command = "uvx" args = ["finanzas-mcp"]
Install finanzas MCP in Gemini CLI
$ gemini mcp add -s user finanzas-mcp uvx -- finanzas-mcpInstall finanzas MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"finanzas-mcp": {
"command": "uvx",
"args": [
"finanzas-mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablemitdevpro/finanzas-mcp is public and reachablegithub.com/mitdevpro/finanzas-mcp ↗Pass
- Package names this repository as its sourcefinanzas-mcp names mitdevpro/finanzas-mcp as sourcepypi.org/project/finanzas-mcp/ ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-05github.com/mitdevpro/finanzas-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from finanzas-mcpPass
- No critical advisory in the package or its dependencies29 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubfinanzas-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
finanzas MCP questions
How do I add finanzas MCP to Claude Code?
Run claude mcp add finanzas-mcp -- uvx finanzas-mcp in your terminal. Add --scope user to make it available in every project.
How do I add finanzas MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can I use this for currencies other than Chilean Pesos?
Yes, the server is designed to work for any company and in any currency.
Are the Chilean tax rates fixed?
No, the Chilean tax rates provided are parameterizable within each tool.