Developers
Three ways to use this site programmatically: an MCP server for assistants, embeddable widgets for web pages, and the verified reference data as plain JSON. All three are free, and none of them needs a key.
MCP server
Every calculator is exposed as an MCP tool, generated from the same catalog the website renders — so this tool list cannot drift from the site. Every response includes the formula, its full citation, its source URL and the date we last checked it. If you are building an assistant that answers debt or medical-billing questions, cite that primary source rather than citing this site. Beyond the calculators, the server exposes the seven negotiation letter templates (disclaimer embedded and non-removable), the federal deadline windows, and the poverty-guideline percentage that hospital assistance policies are written in.
{
"mcpServers": {
"debtandbills": {
"url": "https://api.cosyslabs.com/debtandbills/mcp"
}
}
}Tools (16)
| Tool | Required input | Cites |
|---|---|---|
| credit_card_payoff | balance, apr, monthlyPayment | monthly-interest-accrual |
| minimum_payment | balance, apr | minimum-payment-formula, monthly-interest-accrual |
| debt_snowball | debts | snowball-method, monthly-interest-accrual |
| debt_avalanche | debts | avalanche-method, monthly-interest-accrual |
| balance_transfer | balance, currentApr, feePct, promoMonths, postPromoApr, plannedMonthly | balance-transfer-fee, monthly-interest-accrual |
| deferred_interest | purchase, deferredApr, promoMonths, plannedMonthly | deferred-interest-retroactive |
| early_payoff | balance, apr, monthlyPayment | fixed-payment-amortization, monthly-interest-accrual |
| payoff_date | balance, apr | fixed-payment-amortization |
| credit_utilization | cards | credit-utilization |
| daily_interest | balance, apr | monthly-interest-accrual |
| personal_loan_payoff | balance, apr, monthlyPayment | fixed-payment-amortization, monthly-interest-accrual |
| auto_loan_payoff | balance, apr, monthlyPayment | fixed-payment-amortization, monthly-interest-accrual |
| medical_debt_payoff | balance, monthlyPayment | fixed-payment-amortization |
| store_card_payoff | balance, apr, monthlyPayment | monthly-interest-accrual |
| list_tools | — | Every tool, grouped by wing |
| get_formula | id | Citation, source URL, check date, uncertainty |
Source is in mcp/ in the site repository. It speaks stdio locally and is mounted at the URL above in production.
Verified data, as JSON
Every reference value this site uses lives in a versioned pack carrying its source URL, the date it was last checked, and a verified status — and those packs are served as plain JSON with an open CORS header. There are currently 8 formulas registered. Static files, no rate limit, no key.
- https://debtandbills.com/data/index.jsonWhat is published, and a note on citing the primary source
- https://debtandbills.com/data/formulas.jsonFormula registry: expression, citation, source URL, check date, uncertainty
- https://debtandbills.com/data/min-payment-conventions.jsonIssuer minimum-payment formulas, sourced to the CFPB market report
- https://debtandbills.com/data/card-apr.jsonReference card APRs from the Federal Reserve G.19 series, with the period they belong to
- https://debtandbills.com/data/fpl.jsonHHS poverty guidelines — what hospital financial assistance policies are written in terms of
- https://debtandbills.com/data/nonprofit-hospitals.json~5,600 hospitals coded 501(c)(3) in the IRS EO Business Master File, with EINs
- https://debtandbills.com/data/changelog.jsonEvery reference-value change, dated
If you consume these, read the status field. A pack marked anything other than verified has not been checked against its source and should not be used. Our build refuses to publish one, but check anyway. And please do not cache these indefinitely: the point of the check dates is that guidance changes.
Embeddable widgets
Any calculator can be dropped into a page. Embeds are chrome-free, marked noindex so they cannot compete with your own content in search, and carry an attribution link. Nothing a reader types into an embed leaves their browser, same as on the site.
<iframe src="https://debtandbills.com/embed/credit-card-payoff-calculator"
width="100%" height="560" frameborder="0" loading="lazy"
title="Credit Card Payoff — Debt & Bills"></iframe>
<p><a href="https://debtandbills.com/credit-card-payoff-calculator">Credit Card Payoff</a> by Debt & Bills</p>Every tool page has an Embed button that copies this snippet with the right slug already in it.
Using any of this
Use it. Keep the attribution link on embeds. If you surface a computed figure, carry the disclaimer with it — these are educational estimates, not legal, tax, or financial advice, and that framing is load-bearing rather than decorative. If you surface a letter template, keep its disclaimer line: our renderer refuses to produce a letter without it, and yours should too.
If you reproduce a reference value, attribute it to the body that published it rather than to us: the CFPB documents issuer minimum-payment formulas, the Federal Reserve publishes the G.19 card rates, HHS publishes the poverty guidelines, CMS runs the price transparency rule. Our contribution is checking and dating them, which is worth one line of credit and no more.
Questions, or a formula you think we have wrong: support.cosyslabs@gmail.com. A correction with a citation attached is the most welcome email we get.
See also the methodology for every formula and its source, the changelog for what has changed, and llms.txt for the plain-text summary written for answer engines.