Skip to main content
Glama
MattHenri

calc-financeira-br

by MattHenri
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

✅ Selic, CDI, IPCA (mĂȘs e 12 meses) e TR do Banco Central

simular_renda_fixa

✅ CDB, LC, LCI e LCA (pĂłs-fixados em % do CDI ou prefixados), Tesouro Selic com custĂłdia da B3 e poupança, com IR, IOF e dias Ășteis

comparar_investimentos

✅ Ranking de 2 a 10 opçÔes pelo valor lĂ­quido, com a diferença em reais e em pontos percentuais

taxa_equivalente

✅ Entre perĂ­odos (a.m., a.a., dia Ăștil...), nominal × real e isento × tributado exato no prazo

simular_financiamento

✅ SAC e Price com seguros, tarifas, amortizaçÔes extras (prazo ou parcela) e CET pela Resolução CMN 4.881/2020

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

PrĂłximos passos

  • Conferir os casos de referĂȘncia com calculadoras externas.

  • Publicar a v1 no PyPI.

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.

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • precisioncalc-mcp

    inity13
    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
    19 npm
    MIT
  • genpark-black-scholes-merton-greeks-engine-skill by Alpha-Park

    genpark-black-scholes-mertonofficial

    Alpha-Park
    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

  • genpark-bond-convexity

    alphaparkinc
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables users to compute fixed-income bond prices, cash flow present values, Macaulay and modified duration, and price convexity through an MCP-compatible quantitative finance engine.
    7
    MIT
  • genpark-yield-curve-nelson-siegel-interpolator-skill by alphaparkinc

    genpark-yield-curve-nelsonofficial

    alphaparkinc
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables users to perform zero-dependency quantitative finance and risk analytics through MCP, including Nelson-Siegel yield curve interpolation, option Greeks, Monte Carlo simulations, VaR/CVaR, and bond duration/convexity calculations. It supports natural-language financial modeling and hedging strategy generation in MCP-compatible clients.
    7
    MIT