# falazuki-finance-br

MCP server com calculadoras financeiras e dados econômicos do Brasil.

**25 tools** para cálculos financeiros, trabalhistas, tributários e planejamento financeiro.

## Tools

### Calculadoras Financeiras (9)
| Tool | Descrição |
|------|-----------|
| `calculate_net_salary` | Salário líquido CLT (INSS + IRRF) |
| `calculate_compound_interest` | Juros compostos com aportes mensais |
| `calculate_installment` | Parcelas de financiamento (Price) |
| `calculate_financing` | Financiamento imobiliário SAC vs Price |
| `calculate_investment_return` | Rendimento renda fixa (CDB, LCI, Tesouro, Poupança) |
| `calculate_budget` | Orçamento pela regra 50/30/20 |
| `calculate_opportunity_cost` | Quanto um gasto recorrente viraria investido |
| `calculate_inflation_adjustment` | Correção de valor pela inflação (IPCA) |
| `calculate_real_salary` | Salário real vs inflação |

### Calculadoras Trabalhistas (5)
| Tool | Descrição |
|------|-----------|
| `calculate_severance` | Rescisão trabalhista CLT completa |
| `calculate_overtime` | Horas extras CLT (50% e 100%) |
| `calculate_vacation_pay` | Férias CLT + 1/3 + abono |
| `calculate_thirteenth_salary` | 13º salário com descontos |
| `calculate_mei_tax` | DAS MEI mensal |

### Planejamento Financeiro (4)
| Tool | Descrição |
|------|-----------|
| `calculate_financial_independence` | Quanto precisa para viver de renda |
| `calculate_emergency_fund` | Reserva de emergência ideal |
| `calculate_debt_payoff` | Plano de quitação (avalanche vs bola de neve) |
| `compare_clt_vs_pj` | Comparação CLT vs PJ |

### Dados de Referência (5)
| Tool | Descrição |
|------|-----------|
| `get_cost_of_living` | Custo de vida por cidade brasileira (15 cidades) |
| `get_average_salary` | Salário médio por profissão (25 profissões) |
| `get_current_rates` | Selic, CDI, IPCA, IGP-M, dólar, euro |
| `get_inss_table` | Tabela INSS 2026 |
| `get_irpf_table` | Tabela IRPF 2026 |

### Recursos (2)
| Tool | Descrição |
|------|-----------|
| `search_calculator` | Busca calculadora por tema |
| `get_falazuki_info` | Informações sobre o Fala, Zuki! |

## Uso com Claude Desktop

```json
{
  "mcpServers": {
    "falazuki-finance-br": {
      "command": "npx",
      "args": ["-y", "falazuki-finance-br"]
    }
  }
}
```

## Arquitetura

```
src/
├── index.ts                    — Entry point (stdio)
├── server.ts                   — Server setup
├── lib/                        — Shared utilities
│   ├── brazilian-tax.ts        — INSS, IRRF, IR investimentos
│   ├── constants.ts            — URLs, brand
│   ├── math.ts                 — round, pmt, rate conversions
│   ├── format.ts               — Response formatters
│   └── search.ts               — Fuzzy matching
├── calculators/                — 1 arquivo por calculadora (18)
├── data-tools/                 — Consultas de dados (5)
├── resources/                  — Busca e info (2)
└── data/                       — JSON datasets
    ├── cities.json             — 15 cidades
    ├── professions.json        — 25 profissões
    ├── rates.json              — Taxas econômicas
    ├── inss-table.json         — Tabela INSS 2026
    └── irpf-table.json         — Tabela IRPF 2026
```

## Dados

Fontes: IBGE, CAGED, Banco Central do Brasil, Receita Federal.

## Licença

MIT

---

Por [Fala, Zuki!](https://www.falazuki.com) — Assistente financeiro pessoal no WhatsApp.