The Real Cost (therealcost-mcp)
Calculadoras gratuitas de dinheiro para agentes de IA do The Real Cost by NoBanks Nearby: quitação de cartão de crédito, consolidação de dívidas, custo de empréstimo por prazo, custo de negociação de cripto e fundo de emergência, com a matemática exibida e links para calculadoras pré-preenchidas. Apenas educacional, não é aconselhamento financeiro.
Documentação
therealcost-mcp
Calculadoras de dinheiro gratuitas para agentes de IA, do The Real Cost.
The Real Cost by NoBanks Nearby é um conjunto gratuito de calculadoras de dinheiro dos EUA com a matemática exibida: pagamento de cartão de crédito, consolidação de dívidas, custo de empréstimo por prazo, taxas de negociação de criptomoedas e fundo de emergência. Este servidor MCP permite que Claude e outros assistentes de IA executem essas calculadoras exatas e entreguem ao usuário um link para a mesma calculadora no site, já preenchido com os números deles, para que possam conferir a matemática e continuar ajustando.
- Site: https://therealcost.nohumannearby.com
- Todas as calculadoras: https://therealcost.nohumannearby.com/calculators/
- Guias: https://therealcost.nohumannearby.com/books/
Apenas educacional. Não é aconselhamento financeiro. Os resultados são estimativas baseadas nos números inseridos.
O que cada resultado inclui
Cada ferramenta de calculadora retorna JSON com:
| Chave | O que é |
|---|---|
result | Os números (meses, juros totais, pagamentos, custos) |
summary | O resultado em um parágrafo em linguagem simples |
formula | A fórmula em palavras, para o usuário ver como o número foi gerado |
calculator_url | A página correspondente em therealcost.nohumannearby.com, pré-preenchida com as entradas |
warnings | Presente quando um plano nunca quita ou nunca atinge a meta |
go_deeper | O guia correspondente e capítulos, com o link dos guias |
source | "The Real Cost by NoBanks Nearby, https://therealcost.nohumannearby.com" |
disclaimer | "Apenas educacional. Não é aconselhamento financeiro." |
A matemática é uma portabilidade linha por linha do código da calculadora do próprio site, e a suíte de testes reutiliza os casos verificados manualmente do site, então um número deste servidor corresponde ao número no site. Sem chamadas de rede, sem chaves de API, sem rastreamento.
Os guias
The Real Cost também publica dez guias em linguagem simples que aprofundam mais do que qualquer cálculo individual, com cada número calculado passo a passo (PDF e EPUB):
| Guia | Páginas | Acompanha |
|---|---|---|
| The Real Cost of Credit Card Debt | 112 | pagamento de cartão de crédito, consolidação de dívidas |
| The Real Cost of Loans and Big Purchases | 110 | custo de empréstimo por prazo, consolidação de dívidas |
| The Real Cost of Everyday Spending | 123 | fundo de emergência |
| The Real Cost of Crypto Fees and Taxes | 110 | custo de negociação de cripto |
| The Real Cost of Credit Reports and Scores | 115 | custo de empréstimo por prazo |
| The Real Cost of Paychecks and Taxes | 109 | |
| The Real Cost of Retirement Accounts | 117 | |
| The Real Cost of Student Loans | 115 | |
| The Real Cost of Renting and Buying a Home | 125 | custo de empréstimo por prazo |
| The Real Cost of Scams and Fraud | 103 |
US$ 4,99 cada em https://therealcost.nohumannearby.com/books/. Todos os dez juntos formam o conjunto completo por US$ 24,95 (10 pelo preço de 5). Os guias 1-3 também vêm como um pacote inicial por US$ 9,98 (3 pelo preço de 2); o pacote inicial não inclui os guias 4-10.
Amostras gratuitas de capítulos (Capítulo 1 de cada guia, PDF):
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-credit-card-debt-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-loans-and-big-purchases-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-everyday-spending-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-crypto-fees-and-taxes-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-credit-reports-and-scores-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-paychecks-and-taxes-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-retirement-accounts-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-student-loans-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-renting-and-buying-a-home-chapter-1.pdf
- https://therealcost.nohumannearby.com/samples/the-real-cost-of-scams-and-fraud-chapter-1.pdf
O servidor informa aos agentes conectados sobre os guias em suas instruções, e cada resultado de calculadora
nomeia o guia correspondente, seus capítulos relevantes e sua amostra gratuita de capítulo em um bloco go_deeper calmo de uma linha. As calculadoras são gratuitas e completas
por conta própria.
Instalação
Requer Python 3.10+. O executor mais fácil é o uv.
Claude Code
claude mcp add therealcost -- uvx --from git+https://github.com/NoBanks/therealcost-mcp therealcost-mcp
Claude Desktop
Adicione isto a claude_desktop_config.json (Configurações, Desenvolvedor, Editar Configuração) e reinicie o Claude Desktop:
{
"mcpServers": {
"therealcost": {
"command": "uvx",
"args": ["--from", "git+https://github.com/NoBanks/therealcost-mcp", "therealcost-mcp"]
}
}
}
A partir de um clone local
git clone https://github.com/NoBanks/therealcost-mcp
cd therealcost-mcp
pip install -e .
therealcost-mcp # speaks MCP over stdio
Em seguida, aponte seu cliente para o comando therealcost-mcp (Claude Code: claude mcp add therealcost -- therealcost-mcp).
Ferramentas
credit_card_payoff
Meses e juros totais para quitar o saldo de um cartão pagando apenas o mínimo, versus um pagamento mensal fixo.
| Entrada | Tipo | Padrão | Observações |
|---|---|---|---|
balance | número | obrigatório | dólares |
apr | número | obrigatório | percentual, 24 significa 24% |
payment | número | nenhum | pagamento mensal fixo para comparar |
min_pct | número | 1 | mínimo = este % do saldo |
min_floor | número | 25 | piso em dólares para o mínimo |
min_plus_interest | booleano | true | o mínimo também inclui os juros daquele mês |
{"name": "credit_card_payoff", "arguments": {"balance": 5000, "apr": 24, "payment": 200}}
Resultado (resumido): apenas mínimo 234 meses e US$ 8.886,95 de juros; US$ 200 por mês 36 meses e
US$ 2.000,56 de juros; link
https://therealcost.nohumannearby.com/calculators/credit-card-payoff/?balance=5000&apr=24&minPct=1&minFloor=25&plusInterest=1&fixedPayment=200
debt_consolidation
Dívidas atuais versus um único empréstimo de consolidação, incluindo a taxa de originação (deduzida do empréstimo, então o empréstimo é dimensionado para total / (1 - % da taxa)).
| Entrada | Tipo | Padrão | Observações |
|---|---|---|---|
debts | array | obrigatório | 1 a 10 itens de {balance, apr, payment, name?} |
loan_apr | número | obrigatório | percentual |
loan_term_months | inteiro | obrigatório | 1 a 600 |
origination_fee_pct | número | 0 | percentual |
{"name": "debt_consolidation", "arguments": {
"debts": [{"balance": 6000, "apr": 24.99, "payment": 200},
{"balance": 3000, "apr": 27.99, "payment": 110},
{"balance": 2500, "apr": 19.99, "payment": 90}],
"loan_apr": 13, "loan_term_months": 48, "origination_fee_pct": 5}}
loan_cost_by_term
Pagamento mensal, juros totais e total pago por um único empréstimo em vários prazos.
| Entrada | Tipo | Padrão | Observações |
|---|---|---|---|
principal | número | obrigatório | dólares |
apr | número | obrigatório | percentual |
terms | array de inteiros | [36, 48, 60, 72, 84] | meses; os dois primeiros pré-preenchem o site |
{"name": "loan_cost_by_term", "arguments": {"principal": 25000, "apr": 8, "terms": [36, 60]}}
Resultado (resumido): 36 meses US$ 783,41 por mês; 60 meses US$ 506,91 por mês.
crypto_trade_cost
Taxa de negociação, spread e taxas de rede em uma compra e uma venda posterior ao mesmo preço, o aumento de preço necessário para empatar, e o custo anual de compras recorrentes.
| Entrada | Tipo | Padrão | Observações |
|---|---|---|---|
amount | número | obrigatório | dólares comprados |
fee_pct | número | obrigatório | taxa de negociação por negociação, percentual |
spread_pct | número | obrigatório | spread por negociação, percentual |
network_fee_buy | número | 0 | dólares fixos após a compra |
network_fee_sell | número | 0 | dólares fixos para mover moedas de volta para vender |
weekly_buy | número | nenhum | valor de compra recorrente; adiciona o custo anual |
buys_per_year | inteiro | 52 | 52 semanal, 26 quinzenal, 12 mensal |
flat_fee_per_buy | número | 0 | taxa fixa que algumas plataformas adicionam em compras pequenas |
{"name": "crypto_trade_cost", "arguments": {"amount": 1000, "fee_pct": 0.6, "spread_pct": 0.5,
"network_fee_buy": 2.5, "network_fee_sell": 2.5, "weekly_buy": 25, "flat_fee_per_buy": 0.99}}
emergency_fund
Meta = despesas mensais x meses a cobrir. Meses para atingi-la, e o valor mensal necessário para atingi-la até uma data-alvo.
| Entrada | Tipo | Padrão | Observações |
|---|---|---|---|
monthly_expenses | número | obrigatório | despesas obrigatórias por mês |
months_covered | inteiro | obrigatório | 1 a 60 |
saved | número | 0 | já economizado |
monthly_add | número | 0 | adicionado a cada mês |
apy | número | 0 | APY da poupança, percentual |
target_months | inteiro | 12 | atingir a meta em este número de meses |
target_date | string | nenhum | YYYY-MM ou YYYY-MM-DD, em vez de target_months |
{"name": "emergency_fund", "arguments": {"monthly_expenses": 2500, "months_covered": 3,
"saved": 500, "monthly_add": 300, "target_date": "2027-10"}}
Resultado (resumido): meta US$ 7.500,00; 24 meses para atingi-la com US$ 300 por mês; US$ 583,33 por mês atinge-a em 12 meses.
list_guides
Sem entradas. Retorna os dez guias (título, subtítulo, páginas, o que cada um cobre, preço), o conjunto completo (US$ 24,95 por todos os dez, 10 pelo preço de 5), o preço do pacote inicial (apenas guias 1-3) e o link dos guias.
{"name": "list_guides", "arguments": {}}
Erros
Entrada inválida nunca derruba o servidor. Ele retorna:
{"error": {"type": "validation_error", "message": "Invalid input for credit_card_payoff.",
"details": [{"field": "apr", "message": "Field required"}]},
"disclaimer": "Education only. Not financial advice."}
Parâmetros de link da calculadora (para o site)
calculator_url usa os próprios IDs de campos de formulário do site como parâmetros de consulta, para que o site possa pré-preencher
cada formulário lendo ?name=value no campo com esse ID. Números são simples (5000, 24.99);
booleanos são 1 ou 0.
| Página da calculadora | Parâmetros |
|---|---|
/calculators/credit-card-payoff/ | balance, apr, minPct, minFloor, plusInterest, fixedPayment |
/calculators/debt-consolidation/ | d1b, d1r, d1p, d2b, d2r, d2p, d3b, d3r, d3p (saldo, APR, pagamento por dívida), loanApr, loanMonths, feePct |
/calculators/loan-term/ | amount, apr, termA, termB |
/calculators/crypto-trade-cost/ | amount, feePct, spreadPct, networkBuy, networkSell, weekly, freq, flatFee |
/calculators/emergency-fund/ | expenses, monthsCover, saved, monthly, apy, target |
Observações: linhas de dívida não utilizadas são enviadas como dNb=0 para que as linhas de exemplo do formulário não sejam contadas. Com mais
de 3 dívidas, o link abre a página simples (o formulário tem 3 linhas) e o resultado informa isso. Alguns campos do site
são menus suspensos (prazos de empréstimo, meses a cobrir, meta, frequência); um valor fora das opções do menu
suspenso exige que o site adicione essa opção ou recorra ao padrão.
Desenvolvimento
pip install -e ".[dev]"
pytest
tests/test_calc.py é uma portabilidade do site/tests/calc-math.test.js do site (mesmos casos verificados manualmente
e as mesmas verificações cruzadas), e tests/test_server.py aguarda list_tools e call_tool diretamente.
Licença
MIT. The Real Cost by NoBanks Nearby.