Skip to main content
Glama
MattHenri

calc-financeira-br

by MattHenri

calc-financeira-br

CI Licença: MIT

🇧🇷 Português · 🇺🇸 English

Servidor MCP open source que dá ao Claude (e a qualquer cliente MCP) cálculos financeiros brasileiros exatos e explicados: renda fixa, comparação de investimentos, taxas equivalentes e financiamentos.

LLMs erram contas com juros compostos, dias úteis e faixas de imposto. Este servidor faz a conta de forma determinística e devolve a memória de cálculo passo a passo; o modelo cuida da conversa.

⚠️ Em desenvolvimento (pré-alfa). Ainda não publicado no PyPI.

Diferenciais

  • Precisão de mercado: CDI na base 252 dias úteis com calendário de feriados (ANBIMA), IOF dia a dia e Decimal em vez de float.

  • Memória de cálculo: cada resultado mostra taxa diária, IOF, base do IR e a alíquota aplicada.

  • Regras versionadas: alíquotas e tabelas ficam em arquivos de configuração, com a fonte oficial citada.

  • Validação pública: testes comparados com calculadoras de referência.

Related MCP server: genpark-black-scholes-merton-greeks-engine-skill

Tools

Tool

Status

obter_indicadores

🚧 planejada

simular_renda_fixa

🚧 planejada

comparar_investimentos

🚧 planejada

taxa_equivalente

🚧 planejada

simular_financiamento

🚧 planejada

Todas as respostas são simulações, não recomendação de investimento.

Desenvolvimento

Requer uv e Python 3.12+.

uv sync                      # instala dependências
uv run pytest                # testes (sem rede)
uv run pytest --rede         # inclui testes que acessam APIs reais
uv run ruff check .          # lint
uv run ruff format .         # formatação
uv run mypy                  # tipos
uv run calc-financeira-br    # sobe o servidor (stdio)
npx @modelcontextprotocol/inspector uv run calc-financeira-br   # MCP Inspector

Licença

MIT


English

Open source MCP server that gives Claude (and any MCP client) exact, explained Brazilian financial calculations: fixed income (CDB, LCI/LCA, Tesouro, savings), investment comparison, equivalent rates and loans (SAC/Price).

Every result includes a step-by-step calculation trail and the assumptions used. Results are simulations, not investment advice.

⚠️ Work in progress (pre-alpha). Not yet published on PyPI. Tool names and descriptions are in Portuguese.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    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
    32 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables users to compute European option prices and sensitivity metrics, run Monte Carlo GBM simulations, calculate historical/parametric VaR/CVaR, evaluate bond duration and convexity, and interpolate Nelson-Siegel yield curves through MCP.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables analytical pricing of European options and calculation of first- and second-order Greeks including Delta, Gamma, Vega, Theta, and Rho through MCP. It also supports related quantitative finance analytics such as Monte Carlo simulations, VaR/CVaR, bond duration, and yield curve interpolation.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables quantitative portfolio tail-risk analysis, option Greeks, Monte Carlo stochastic simulations, fixed-income duration/convexity, and Nelson-Siegel yield-curve interpolation through MCP tools.
    7
    MIT