API Tools
rateapi.dev
Provides APIs for querying credit union mortgage rates, obtaining personalized financing recommendations, and monitoring rate changes via webhooks.
ENDPOINT 1
https://mcp.rateapi.dev/mcp
Known tools 62
get_financing_decisionRECOMMENDED: Get personalized financing recommendations for ANY loan or credit product.
list_credit_unionsReference tool: List all credit unions grouped by state with rate availability info.
get_credit_unionReference tool: Get detailed info and all mortgage rates for a specific credit union by state and slug.
create_monitorCreate a new decision monitor that watches for rate changes and sends webhook notifications when conditions are met.
create_competitor_monitorSubscribe a monitor to a SPECIFIC named credit union's published rate and alert via webhook when that CU changes its rate (vs the aggregate market-best decision).
list_monitorsList all monitors associated with your API key.
get_monitorGet detailed information about a specific monitor by its ID.
update_monitorUpdate an existing monitor.
delete_monitorPermanently delete a monitor.
simulate_monitorTest a monitor with a simulated rate change to see if it would trigger.
deliver_test_webhookSend a test webhook for a monitor using a simulated rate change.
list_webhook_deliveriesOrg-scoped webhook delivery observability for the authenticated API key.
get_extraction_statsGet data extraction statistics showing the scale and health of rate data collection.
get_benchmarksGet rate benchmark statistics (min/median/max APR) across all institutions.
compare_productsCompare the best real rates across MULTIPLE lending products in a single call — e.g.
refinance_break_evenTell a borrower whether refinancing is worth it.
optimize_buydownGiven a discount-points / lender-credit tradeoff menu for a candidate loan, returns break-even months, lifetime savings, and the optimal point-spend.
max_loanEstimate the largest loan a borrower can afford from income and a target debt-to-income (DTI) ratio.
estimate_affordabilityBorrower-facing home affordability estimate: given gross income, existing monthly debts, down payment, and front-end/back-end DTI caps, compute the max monthly payment, max loan amount, and max home price.
estimate_monthly_costTotal monthly housing cost (PITI): principal+interest plus property tax, homeowners insurance, PMI, and HOA, so affordability reflects real monthly outlay.
analyze_rent_vs_buyCompare projected cost of renting vs buying a home over a holding period, anchored to LIVE market mortgage rates.
project_pmi_removalFor low-down-payment borrowers (LTV > 80%): projects when private mortgage insurance (PMI) drops off, the total PMI paid until then, and how much extra monthly principal cancels PMI sooner.
get_usageCheck the calling account's API usage and remaining quota for this month (tier, used, remaining, limit, reset date).
get_monitor_statsGet rollup stats for the account's rate monitors: total, active, and webhooks sent.
save_scenarioSave a rate comparison for a named client so it can be recalled later (a lightweight CRM for loan officers).
list_scenariosList saved client scenarios for the account, newest first.
get_scenarioGet a single saved scenario by id (inputs + stored comparison).
delete_scenarioDelete a saved scenario by id.
list_decision_logsRecall past financing decisions made on this account (audit log).
generate_client_reportProduce a clean, client-facing markdown rate comparison report a loan officer can share with a buyer.
rate_sanity_checkCheck whether an externally-sourced loan quote is realistic against the LIVE market distribution.
get_coverageIntrospect what mortgage/loan data the API covers BEFORE scanning — which states, lenders, and product types are present, row counts per segment, and last-updated freshness per segment.
check_competitive_positionLender-facing 'is my offer competitive' check — input your OWN published rate for a state+product, get the market percentile, bps vs the state median, and a leading/competitive/overpriced verdict.
scan_savingsScan a list of existing debts and find, for EACH debt, the best qualifying market refinance offer.
get_league_tableLoan-officer competitive-landscape report: ranked roster of the top N lenders publishing a given mortgage product in a state today — per-lender rows (name, best APR/rate, product, position, bps above the leader) — plus the market min/median/max.
get_deposit_benchmarksBest/median/spread credit-union deposit APY (savings, CD, share-certificate, money-market, IRA-CD) by product, term, and state, with per-CU peer ranking.
get_deposit_betaDeposit beta (repricing sensitivity) = change in deposit APY per 100bps change in a benchmark/market rate — the core credit-union/bank ALM & interest-rate-risk (IRR) model input.
explain_rankingExplain WHY each top lender ranked where it did for a financing decision.
simulate_decisionRun a what-if sweep over a financing decision.
build_amortization_scheduleBuild a year-by-year amortization / payoff schedule for a loan: total lifetime interest, principal/interest split per period, and a what-if extra-payment accelerator showing months saved and interest saved.
compare_total_costApples-to-apples multi-lender ranking by TOTAL cost of a loan (upfront origination/lender fees + lifetime interest over the holding period), not just the headline rate.
batch_decisionsScore an array of inline financing scenarios in one stateless call; returns ranked decisions and top offers per item — no persisted cohorts, no per-borrower HTTP loops.
get_rate_deltaCompare the LIVE market rate distribution now vs ~1/2/4 weeks ago for a product and state.
list_ratesList and filter raw rate rows (the core data primitive) by product, state, lender, and term with limit/offset pagination.
get_rate_historyHistorical rate time-series: a date-ranged array of {date, min/median/max APR, count} points per product/state for dashboards, charts, backtests, and timing confidence — bounded by data retention.
assess_buy_timingFrame a buy/refi-now vs wait recommendation.
assess_rate_lockLock-window-aware lock-vs-float-down recommendation for a deal already in the pipeline.
check_advice_guardrailsRun compliance/suitability guardrails over a financing scenario and an optional recommendation.
save_cohortSave a named cohort ("book of business") — a list of borrower scenarios you want to track and re-scan over time.
list_cohortsList saved cohorts for the account (newest first).
get_cohortGet a single saved cohort by id, including all members and the last scan snapshot (triage list).
delete_cohortPermanently delete a saved cohort by id.
scan_portfolioRe-scan every member of a saved cohort against the live decision engine to find each member's current best offer.
generate_share_linkTurn a saved client scenario into a public, branded, shareable URL (https://app.rateapi.dev/r/TOKEN) that anyone can view without logging in.
list_sharesList all hosted shareable report links for the account, newest first.
revoke_shareRevoke a hosted shareable report link by its token.
schedule_digestSet up a recurring digest: on a cadence (default weekly), automatically re-scan a saved cohort and EMAIL the loan officer a triage of which clients have a new opportunity (best lender changed, crossed a threshold).
list_digestsList the account's scheduled digests (cohort, email, cadence, enabled, last run).
delete_digestDelete a scheduled digest by id.
subscribe_rate_alertSubscribe a consumer to an EMAIL rate alert: notify them when the live market meets their target (rate/apr/monthly_payment crossing a threshold).
list_rate_alertsList the rate alerts subscribed for a given email (status, product, state, intent, target, last notified).
unsubscribe_rate_alertOne-click unsubscribe via the per-alert token embedded in every email.