io.github.SPFreedom/showrealcost

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Loan-cost math: payments, payoff time, offers with fees, payday loans, Rule of 78s, Fed rates.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "showrealcost": {
      "url": "https://mcp.showrealcost.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• loan_payment read-only

  For a fixed-rate installment loan (personal, auto, any level-payment loan): the monthly payment, total interest, total repaid, how the first payment splits between interest and principal, and optionally how much has been paid and is still owed after a number of payments. Use for "what will this loan cost" and "where did my payments go".

  Parameters:

  • amount (required) — number — Amount borrowed, in dollars
  • annual_rate_pct (required) — number — Annual interest rate in percent, e.g. 6.97
  • months (required) — integer — Number of monthly payments
  • payments_made — integer — Optional: payments already made, to see progress so far

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• payoff_time read-only

  How long a balance (credit card or loan) takes to pay off at a fixed monthly payment, and the interest paid. Use for "how long to pay off my card at $X a month" and for comparing a bigger payment by calling it twice.

  Parameters:

  • balance (required) — number — Balance owed today, in dollars
  • annual_rate_pct (required) — number — Annual interest rate in percent
  • monthly_payment (required) — number — Fixed amount paid each month, in dollars

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compare_loan_offers read-only

  Compare two to four loan offers with different rates and fees fairly: each offer is sized so the borrower receives the same cash, then compared on payment, total cost of borrowing (interest plus fees) and estimated APR. Use for "is a lower rate with an origination fee cheaper than a higher rate with none".

  Parameters:

  • cash_needed (required) — number — Cash the borrower needs to receive, in dollars
  • offers (required) — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• payday_loan_cost read-only

  For a payday loan, title loan, pawn loan, cash-advance app or any loan priced by a fee for a number of days: the fee in dollars, the APR, and what renewing (rolling over) costs. Use for "what is the APR on a $500 payday loan at $15 per $100" and "what does rolling it over cost".

  Parameters:

  • amount (required) — number — Amount borrowed, in dollars
  • term_days (required) — integer — Days until the loan is due
  • flat_fee — number — Any flat fee, tip or instant-transfer fee for one term, in dollars
  • renewals — integer — Times the loan is renewed or rolled over by paying only the fee
  • fee_per_100 — number — Fee per $100 borrowed for one term, in dollars (e.g. 15)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• refinance_check read-only

  Compare keeping a loan against a refinance offer, from today forward: interest remaining on the current loan, interest on the new loan, and what happens if the borrower takes the new rate but keeps paying the old payment. Use for "the new loan has a lower payment, does it actually save money".

  Parameters:

  • balance (required) — number — Balance owed today, in dollars
  • current_rate_pct (required) — number
  • current_payment (required) — number — Current monthly payment, in dollars
  • new_rate_pct (required)
  • new_months (required) — integer — Term of the new loan in months
  • new_loan_fee — number — Any fee added to the new loan, in dollars

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• precomputed_loan_payoff read-only

  For a precomputed or add-on interest loan (common from dealers, finance companies and furniture stores): the payoff after a number of payments under the Rule of 78s and under the actuarial method, and how much more the Rule of 78s keeps. Use for "why is my payoff different from my balance".

  Parameters:

  • amount (required) — number — Amount financed, in dollars
  • annual_rate_pct (required) — number — Contract rate in percent
  • months (required) — integer
  • payments_made (required) — integer — Payments made so far

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• per_diem_interest read-only

  The interest a simple-interest loan adds each day, and over a number of days. Use for reading a payoff letter, for "how much more is my payoff than my statement balance", and for the cost of a skipped or deferred payment.

  Parameters:

  • balance (required) — number — Principal balance, in dollars
  • annual_rate_pct (required) — number
  • days (required) — integer — Days of interest

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• debt_payoff_plan read-only

  Simulate paying off several debts with minimum payments plus an optional extra each month, highest rate first (avalanche) and smallest balance first (snowball), against minimums only. Returns months to debt-free and total interest for each. Use for "avalanche or snowball on my debts" and "what does $200 extra a month do".

  Parameters:

  • debts (required) — array
  • extra_per_month — number — Extra paid each month on top of all minimums, in dollars

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• average_loan_rates read-only

  The latest Federal Reserve (G.19) average interest rates at commercial banks for a 24-month personal loan, 60- and 72-month new car loans, and credit cards, with the change from the previous quarter and from a year earlier. Optionally compares a rate someone was offered with the average and gives the gap in dollars. Averages across banks, never any one lender; quarterly figures bundled with the server, not live quotes. Use for "what is the average car loan rate", "have personal loan rates gone up" and "is 9% high for a car loan".

  Parameters:

  • amount — number — Optional with offered_rate_pct: amount borrowed or card balance, in dollars
  • months — integer — Optional with offered_rate_pct: number of monthly payments
  • loan_type — string — One kind of loan; leave out for all four
  • offered_rate_pct — number — Optional: a rate the person was offered, to compare with the average (needs loan_type)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.