The Real Cost

therealcost-mcp

AI エージェント向けの無料マネー計算ツール。The Real Cost 提供。

NoBanks Nearby の The Real Cost は、計算過程を表示する米国向けの無料マネー計算ツール集です。クレジットカードの返済、債務の一本化、返済期間別のローン費用、暗号資産の取引手数料、緊急資金を計算できます。 この MCP サーバーを使うと、Claude などの AI アシスタントがこれらとまったく同じ計算ツールを実行し、入力した数字があらかじめ反映されたサイト上の計算ツールへのリンクをユーザーに渡せるため、ユーザーは計算を確認し、数値を調整し続けることができます。

• サイト：https://therealcost.nohumannearby.com
• すべての計算ツール：https://therealcost.nohumannearby.com/calculators/
• ガイド：https://therealcost.nohumannearby.com/books/

教育目的のみです。金融アドバイスではありません。 結果は入力された数値に基づく推定値です。

各計算結果に含まれる内容

各計算ツールは、次の内容を含む JSON を返します。

キー	内容
result	数値（期間、利息合計、支払額、費用）
summary	結果を平易な文章でまとめたもの
formula	数値がどのように算出されたかをユーザーが確認できる、言葉で説明した計算式
calculator_url	入力内容があらかじめ反映された、therealcost.nohumannearby.com 上の対応するページ
warnings	返済が完了しない場合や目標に到達しない場合に表示
go_deeper	ガイドと各章、およびガイドへのリンク
source	"The Real Cost by NoBanks Nearby, https://therealcost.nohumannearby.com"
disclaimer	"Education only. Not financial advice."

計算ロジックは、サイト独自の計算ツールのコードを一行ずつ移植したもので、テストスイートではサイトで手動検証されたケースを再利用しています。そのため、このサーバーの数値はサイト上の数値と一致します。 ネットワーク呼び出しも、API キーも、トラッキングもありません。

ガイド

The Real Cost では、個々の計算を超えて詳しく解説する、平易な英語で書かれた10冊のガイドも発行しています。すべての数値を段階ごとに計算しています（PDF および EPUB）。

ガイド	ページ数	関連する計算
クレジットカードの負債にかかる本当のコスト	112	クレジットカードの返済、債務の一本化
ローンと高額購入にかかる本当のコスト	110	返済期間別のローン費用、債務の一本化
日常の支出にかかる本当のコスト	123	緊急資金
暗号資産の手数料と税金にかかる本当のコスト	110	暗号資産の取引費用
信用情報レポートとスコアにかかる本当のコスト	115	返済期間別のローン費用
給与と税金にかかる本当のコスト	109
退職金口座にかかる本当のコスト	117
学生ローンにかかる本当のコスト	115
賃貸と住宅購入にかかる本当のコスト	125	返済期間別のローン費用
詐欺と不正行為にかかる本当のコスト	103

1冊あたり$4.99。https://therealcost.nohumannearby.com/books/ で購入できます。10冊すべてをまとめた完全セットは$24.95です（5冊分の価格で10冊）。ガイド1～3は、スターターパックとしても$9.98で購入できます（2冊分の価格で3冊）。スターターパックにはガイド4～10は含まれません。

無料サンプル章（各ガイドの第1章、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

サーバーは、接続しているエージェントに指示の中で各ガイドについて伝えます。また、各計算ツールの結果には、該当するガイドと関連する章、無料サンプル章が、落ち着いた一行のgo_deeperブロック内に記載されます。計算ツールは無料で、それだけで必要な内容がすべてそろっています。

インストール

Python 3.10以降が必要です。最も簡単に実行する方法はuvです。

Claude Code

claude mcp add therealcost -- uvx --from git+https://github.com/NoBanks/therealcost-mcp therealcost-mcp

Claude Desktop

claude_desktop_config.jsonに以下を追加し（Settings、Developer、Edit Config）、Claude Desktopを再起動します。

{
  "mcpServers": {
    "therealcost": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/NoBanks/therealcost-mcp", "therealcost-mcp"]
    }
  }
}

ローカルクローンから

git clone https://github.com/NoBanks/therealcost-mcp
cd therealcost-mcp
pip install -e .
therealcost-mcp   # speaks MCP over stdio

次に、クライアントでtherealcost-mcpコマンドを指定します（Claude Codeの場合：claude mcp add therealcost -- therealcost-mcp）。

ツール

credit_card_payoff

最低額のみを支払う場合と、毎月の固定額を支払う場合について、カード残高の完済までの月数と支払う利息の合計を計算します。

入力	型	デフォルト	備考
balance	number	必須	ドル
apr	number	必須	パーセント。24は24%を意味します
payment	number	なし	比較する固定の月々の支払額
min_pct	number	1	最低支払額＝残高のこの割合（%）
min_floor	number	25	最低支払額の下限（ドル）
min_plus_interest	boolean	true	最低支払額にその月の利息も含めます

{"name": "credit_card_payoff", "arguments": {"balance": 5000, "apr": 24, "payment": 200}}

結果（抜粋）：最低額のみの場合は234か月で、利息は$8,886.95。毎月$200を支払う場合は36か月で、利息は$2,000.56。リンク： https://therealcost.nohumannearby.com/calculators/credit-card-payoff/?balance=5000&apr=24&minPct=1&minFloor=25&plusInterest=1&fixedPayment=200

debt_consolidation

借り換え前の現在の債務と、1件の借り換えローンを比較します。借入手数料も含まれます（ローンから差し引かれるため、借入額は合計額 ÷ (1 - 手数料率) に調整されます）。

入力	型	デフォルト	備考
debts	array	必須	{balance, apr, payment, name?} の項目を1～10個
loan_apr	number	必須	パーセント
loan_term_months	integer	必須	1～600
origination_fee_pct	number	0	パーセント

{"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

複数の返済期間について、1件のローンの月々の返済額、利息総額、支払総額を計算します。

入力	型	デフォルト	備考
principal	number	必須	ドル
apr	number	必須	パーセント
terms	integer array	[36, 48, 60, 72, 84]	月数。最初の2つがサイトに初期入力されます

{"name": "loan_cost_by_term", "arguments": {"principal": 25000, "apr": 8, "terms": [36, 60]}}

結果（一部）：36か月では月額$783.41、60か月では月額$506.91です。

crypto_trade_cost

同じ価格で購入後に売却する場合の取引手数料、スプレッド、ネットワーク手数料、損益分岐に必要な価格上昇率、および定期購入の年間コストを計算します。

入力	型	デフォルト	備考
amount	number	必須	購入額（ドル）
fee_pct	number	必須	1回の取引あたりの取引手数料（パーセント）
spread_pct	number	必須	1回の取引あたりのスプレッド（パーセント）
network_fee_buy	number	0	購入後に発生する定額手数料（ドル）
network_fee_sell	number	0	売却のためにコインを戻す際の定額手数料（ドル）
weekly_buy	number	なし	定期購入額。年間コストを追加します
buys_per_year	integer	52	週1回なら52、隔週なら26、毎月なら12
flat_fee_per_buy	number	0	少額購入に一部のプラットフォームが加算する定額手数料

{"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

目標額 = 月々の支出 × 備える月数。目標額に達するまでの月数と、目標月数までに達成するために必要な月額を計算します。

入力	型	デフォルト	備考
monthly_expenses	number	必須	毎月必ず支払う必要がある支出
months_covered	integer	必須	1～60
saved	number	0	すでに貯蓄済みの金額
monthly_add	number	0	毎月の積立額
apy	number	0	預金のAPY（パーセント）
target_months	integer	12	この月数以内に目標を達成します
target_date	string	なし	target_months の代わりに指定する YYYY-MM または YYYY-MM-DD

{"name": "emergency_fund", "arguments": {"monthly_expenses": 2500, "months_covered": 3,
  "saved": 500, "monthly_add": 300, "target_date": "2027-10"}}

結果（一部）：目標額は$7,500.00です。月額$300なら24か月で達成し、12か月で達成するには月額$583.33が必要です。

list_guides

入力はありません。10冊のガイド（タイトル、副題、ページ数、それぞれの内容、価格）、全冊セット（10冊すべてで$24.95、5冊分の価格で10冊）、スターターパックの価格（ガイド1～3のみ）、およびガイドへのリンクを返します。

{"name": "list_guides", "arguments": {}}

エラー

不正な入力があってもサーバーはクラッシュしません。次の内容を返します。

{"error": {"type": "validation_error", "message": "Invalid input for credit_card_payoff.",
  "details": [{"field": "apr", "message": "Field required"}]},
 "disclaimer": "Education only. Not financial advice."}

電卓のリンクパラメーター（サイト用）

calculator_url では、サイト独自のフォームフィールド ID をクエリパラメーターとして使用するため、サイトは ?name=value を読み取り、各フォームの ID に一致するフィールドに値を事前入力できます。数値はそのままの形式（5000、24.99）、ブール値は 1 または 0 です。

電卓ページ	パラメーター
/calculators/credit-card-payoff/	balance、apr、minPct、minFloor、plusInterest、fixedPayment
/calculators/debt-consolidation/	d1b、d1r、d1p、d2b、d2r、d2p、d3b、d3r、d3p（債務ごとの残高、APR、支払額）、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

注：未使用の債務行は dNb=0 として送信されるため、フォームのサンプル行は計算に含まれません。債務が 3 件を超える場合、リンク先は通常のページになります（フォームには 3 行あります）。結果にはその旨が表示されます。サイトの一部のフィールドはドロップダウンです（ローン期間、補填月数、目標、頻度）。ドロップダウンの選択肢にない値を指定する場合は、サイト側でその選択肢を追加するか、デフォルト値にフォールバックする必要があります。

開発

pip install -e ".[dev]"
pytest

tests/test_calc.py はサイトの site/tests/calc-math.test.js を移植したもので（手動で確認済みの同じケースと、同じ相互検証を含みます）、tests/test_server.py は list_tools と call_tool を直接 await します。

ライセンス

MIT。NoBanks Nearby による The Real Cost。