The Real Cost (therealcost-mcp)
Calculadoras de dinero gratuitas para agentes de IA de The Real Cost de NoBanks Nearby: pago de tarjetas de crédito, consolidación de deudas, costo de préstamos por plazo, costo de operaciones de criptomonedas y fondo de emergencia, con los cálculos mostrados y enlaces a calculadoras prellenadas. Solo con fines educativos, no es asesoramiento financiero.
Documentación
therealcost-mcp
Calculadoras de dinero gratuitas para agentes de IA, de The Real Cost.
The Real Cost de NoBanks Nearby es un conjunto gratuito de calculadoras de dinero de EE. UU. con las matemáticas visibles: pago de tarjetas de crédito, consolidación de deudas, costo de préstamos por plazo, comisiones de trading de criptomonedas y fondo de emergencia. Este servidor MCP permite a Claude y otros asistentes de IA ejecutar esas calculadoras exactas y entregar al usuario un enlace a la misma calculadora en el sitio, ya rellenado con sus números, para que puedan verificar las matemáticas y seguir ajustándolas.
- Sitio: https://therealcost.nohumannearby.com
- Todas las calculadoras: https://therealcost.nohumannearby.com/calculators/
- Guías: https://therealcost.nohumannearby.com/books/
Solo con fines educativos. No es asesoramiento financiero. Los resultados son estimaciones basadas en los números ingresados.
Qué incluye cada resultado
Cada herramienta de calculadora devuelve JSON con:
| Clave | Qué es |
|---|---|
result | Los números (meses, interés total, pagos, costos) |
summary | El resultado en un párrafo en lenguaje sencillo |
formula | La fórmula en palabras, para que el usuario pueda ver cómo se obtuvo el número |
calculator_url | La página correspondiente en therealcost.nohumannearby.com, pre-rellenada con los datos de entrada |
warnings | Presente cuando un plan nunca se liquida o nunca alcanza la meta |
go_deeper | La guía correspondiente y sus capítulos, con el enlace a las guías |
source | "The Real Cost by NoBanks Nearby, https://therealcost.nohumannearby.com" |
disclaimer | "Solo con fines educativos. No es asesoramiento financiero." |
Las matemáticas son un port línea por línea del código de calculadora del propio sitio, y el conjunto de pruebas reutiliza los casos verificados manualmente del sitio, por lo que un número de este servidor coincide con el número del sitio. Sin llamadas de red, sin claves API, sin seguimiento.
Las guías
The Real Cost también publica diez guías en lenguaje sencillo que profundizan más que cualquier cálculo individual, con cada número desarrollado paso a paso (PDF y EPUB):
| Guía | Páginas | Se relaciona con |
|---|---|---|
| The Real Cost of Credit Card Debt | 112 | pago de tarjetas de crédito, consolidación de deudas |
| The Real Cost of Loans and Big Purchases | 110 | costo de préstamos por plazo, consolidación de deudas |
| The Real Cost of Everyday Spending | 123 | fondo de emergencia |
| The Real Cost of Crypto Fees and Taxes | 110 | costo de trading de criptomonedas |
| The Real Cost of Credit Reports and Scores | 115 | costo de préstamos por plazo |
| 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 | costo de préstamos por plazo |
| The Real Cost of Scams and Fraud | 103 |
$4.99 cada una en https://therealcost.nohumannearby.com/books/. Las diez juntas forman el conjunto completo por $24.95 (10 por el precio de 5). Las guías 1-3 también están disponibles como paquete inicial por $9.98 (3 por el precio de 2); el paquete inicial no incluye las guías 4-10.
Capítulos de muestra gratuitos (Capítulo 1 de cada guía, 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
El servidor informa a los agentes conectados sobre las guías en sus instrucciones, y cada resultado de calculadora
nombra la guía correspondiente, sus capítulos relevantes y su capítulo de muestra gratuito en un bloque go_deeper de una línea y tono calmado. Las calculadoras son gratuitas y completas
por sí solas.
Instalación
Requiere Python 3.10+. El ejecutor más sencillo es uv.
Claude Code
claude mcp add therealcost -- uvx --from git+https://github.com/NoBanks/therealcost-mcp therealcost-mcp
Claude Desktop
Agrega esto a claude_desktop_config.json (Configuración, Desarrollador, Editar configuración) y luego reinicia Claude Desktop:
{
"mcpServers": {
"therealcost": {
"command": "uvx",
"args": ["--from", "git+https://github.com/NoBanks/therealcost-mcp", "therealcost-mcp"]
}
}
}
Desde un clon local
git clone https://github.com/NoBanks/therealcost-mcp
cd therealcost-mcp
pip install -e .
therealcost-mcp # speaks MCP over stdio
Luego apunta tu cliente al comando therealcost-mcp (Claude Code: claude mcp add therealcost -- therealcost-mcp).
Herramientas
credit_card_payoff
Meses e interés total para liquidar el saldo de una tarjeta pagando solo el mínimo, en comparación con un pago mensual fijo.
| Entrada | Tipo | Predeterminado | Notas |
|---|---|---|---|
balance | número | obligatorio | dólares |
apr | número | obligatorio | porcentaje, 24 significa 24% |
payment | número | ninguno | pago mensual fijo para comparar |
min_pct | número | 1 | mínimo = este % del saldo |
min_floor | número | 25 | piso en dólares para el mínimo |
min_plus_interest | booleano | true | el mínimo también incluye el interés de ese mes |
{"name": "credit_card_payoff", "arguments": {"balance": 5000, "apr": 24, "payment": 200}}
Resultado (resumido): solo mínimo 234 meses y $8,886.95 de interés; $200 al mes 36 meses y
$2,000.56 de interés; enlace
https://therealcost.nohumannearby.com/calculators/credit-card-payoff/?balance=5000&apr=24&minPct=1&minFloor=25&plusInterest=1&fixedPayment=200
debt_consolidation
Deudas actuales frente a un préstamo de consolidación, incluida la comisión de originación (descontada del préstamo, por lo que el préstamo se ajusta al alza hasta total / (1 - % de comisión)).
| Entrada | Tipo | Predeterminado | Notas |
|---|---|---|---|
debts | matriz | obligatorio | de 1 a 10 elementos de {balance, apr, payment, name?} |
loan_apr | número | obligatorio | porcentaje |
loan_term_months | entero | obligatorio | de 1 a 600 |
origination_fee_pct | número | 0 | porcentaje |
{"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
Pago mensual, interés total y total pagado por un préstamo en varios plazos.
| Entrada | Tipo | Predeterminado | Notas |
|---|---|---|---|
principal | número | obligatorio | dólares |
apr | número | obligatorio | porcentaje |
terms | matriz de enteros | [36, 48, 60, 72, 84] | meses; los dos primeros rellenan previamente el sitio |
{"name": "loan_cost_by_term", "arguments": {"principal": 25000, "apr": 8, "terms": [36, 60]}}
Resultado (resumido): 36 meses $783.41 al mes; 60 meses $506.91 al mes.
crypto_trade_cost
Comisión de trading, diferencial y comisiones de red en una compra y una venta posterior al mismo precio, el aumento de precio necesario para alcanzar el punto de equilibrio y el costo anual de compras recurrentes.
| Entrada | Tipo | Predeterminado | Notas |
|---|---|---|---|
amount | número | obligatorio | dólares comprados |
fee_pct | número | obligatorio | comisión de trading por operación, porcentaje |
spread_pct | número | obligatorio | diferencial por operación, porcentaje |
network_fee_buy | número | 0 | dólares fijos después de la compra |
network_fee_sell | número | 0 | dólares fijos para mover las monedas de vuelta para vender |
weekly_buy | número | ninguno | monto de compra recurrente; agrega el costo anual |
buys_per_year | entero | 52 | 52 semanal, 26 quincenal, 12 mensual |
flat_fee_per_buy | número | 0 | comisión fija que algunas plataformas agregan en compras pequeñas |
{"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 = gastos mensuales x meses a cubrir. Meses para alcanzarla y el monto mensual necesario para alcanzarla en una fecha objetivo.
| Entrada | Tipo | Predeterminado | Notas |
|---|---|---|---|
monthly_expenses | número | obligatorio | gastos imprescindibles por mes |
months_covered | entero | obligatorio | de 1 a 60 |
saved | número | 0 | ya ahorrado |
monthly_add | número | 0 | agregado cada mes |
apy | número | 0 | APY de ahorro, porcentaje |
target_months | entero | 12 | alcanzar la meta en este número de meses |
target_date | cadena | ninguno | YYYY-MM o YYYY-MM-DD, en lugar 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 $7,500.00; 24 meses para alcanzarla con $300 al mes; $583.33 al mes la alcanza en 12 meses.
list_guides
Sin entradas. Devuelve las diez guías (título, subtítulo, páginas, qué cubre cada una, precio), el conjunto completo ($24.95 por las diez, 10 por el precio de 5), el precio del paquete inicial (solo guías 1-3) y el enlace a las guías.
{"name": "list_guides", "arguments": {}}
Errores
Una entrada incorrecta nunca bloquea el servidor. Devuelve:
{"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 enlace de calculadora (para el sitio)
calculator_url usa los propios ids de campos de formulario del sitio como parámetros de consulta, para que el sitio pueda rellenar previamente
cada formulario leyendo ?name=value en el campo con ese id. Los números son simples (5000, 24.99);
los booleanos son 1 o 0.
| Página de 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, pago por deuda), 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 |
Notas: las filas de deuda no utilizadas se envían como dNb=0 para que las filas de ejemplo del formulario no se cuenten. Con más
de 3 deudas, el enlace abre la página simple (el formulario tiene 3 filas) y el resultado lo indica. Algunos campos del sitio
son listas desplegables (plazos de préstamo, meses a cubrir, objetivo, frecuencia); un valor fuera de las opciones de la lista
requiere que el sitio agregue esa opción o recurra a su valor predeterminado.
Desarrollo
pip install -e ".[dev]"
pytest
tests/test_calc.py es un port del site/tests/calc-math.test.js del sitio (los mismos casos verificados manualmente
y las mismas verificaciones cruzadas), y tests/test_server.py espera a list_tools y call_tool directamente.
Licencia
MIT. The Real Cost by NoBanks Nearby.