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

{
  "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! — Assistente financeiro pessoal no WhatsApp.