FinanceRateCalc MCP

Checks a proposed statement of a FinanceRateCalc figure against that figure's published use contract, so the sentence can be verified before it is written. Two input modes. (A) Flags: claim id plus the use you propose (population, period, scope, cause, individual prediction, lender recommendation, legal conclusion). (B) Sentence: claim id plus proposed_sentence, the exact sentence you intend to write; the tool checks it with fixed patterns, no model, for a missing period, missing program scope, a population wider than the claim, second-person prediction, causal wording, lender advice, legal conclusions, and values this publisher has since corrected. Returns a deterministic verdict: pass, needs_qualifier (naming the missing qualifier) or block (with a reason code), plus a safe sentence you may use verbatim and the required attribution. Most misuse of these statistics is omission, not invention: the number is right and the population is missing. NOT FOR: figures published by anyone other than FinanceRateCalc. (C) Rule sentence: passport_id of a rule file (frc:rule:…, five tables: FHA annual MIP, FHA forward loan limits 2026, FHFA conforming limits 2026, CFPB HOEPA/QM thresholds 2026, VA funding fee) plus proposed_sentence; each dollar or percent figure is bound to the role named in its own clause (floor or ceiling, tier, first or subsequent use, threshold item) and compared with that cell, so a right number under the wrong role is a mismatch and an unbound number earns no receipt; every figure is also classified as current, superseded (STALE_VALUE), belonging to a different rule (VALUE_FROM_OTHER_RULE, e.g. the $726,200 MIP threshold quoted as a loan limit), or not in the table (VALUE_MISMATCH / UNVERIFIED_VALUE); the year, units, tier, use, down-payment band and stated dates are checked (a date before the rule's start blocks; a missing MIP case date is never assumed), and a passing sentence with at least one bound figure returns a verifiable rule receipt.

{
  "type": "object",
  "required": [
    "passport_id"
  ],
  "properties": {
    "passport_id": {
      "type": "string"
    },
    "causal_assertion": {
      "type": "boolean"
    },
    "legal_conclusion": {
      "type": "boolean"
    },
    "proposed_sentence": {
      "type": "string",
      "description": "The exact sentence you intend to write. Checked with fixed patterns; no model."
    },
    "qualifier_dropped": {
      "type": "boolean"
    },
    "attribution_present": {
      "type": "boolean"
    },
    "individual_prediction": {
      "type": "boolean"
    },
    "scope_beyond_universe": {
      "type": "boolean"
    },
    "personalized_recommendation": {
      "type": "boolean"
    }
  }
}

{
  "title": "Check a sentence against a figure's contract",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "how often are FHA loans denied", "what is the FHA denial rate", "what share of FHA applications are rejected", "how many were denied in 2025". Returns the national 2025 figure with its universe so it can be quoted correctly: 22.1 percent, 262,250 denials of 1,187,606 applications that reached a credit decision (originated, approved-not-accepted, denied; reverse mortgages excluded), the denominator definition and the correction history. Most published FHA denial rates are 2023 purchase-only figures near 13.6 percent, a different universe, so state the universe when quoting. NOT FOR: conventional, VA or USDA loans, purchase-only or refinance-only rates, other years, or state/lender/metro breakdowns (use the dedicated tools). Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "title": "National FHA denial rate 2025",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "what is <lender>'s FHA denial rate", "does <lender> reject a lot of FHA applications", "how strict is <lender>", "how does <lender> compare". PARAM: lender name, slug or LEI. Returns that lender's 2025 decisioned volume, denial rate, rank among the 100 largest FHA lenders, and the applicant-mix caveat any comparison must carry. COVERS ONLY the 100 largest FHA lenders by 2025 volume. NOT FOR: whether a person will be approved, or lenders outside that set. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "required": [
    "lender"
  ],
  "properties": {
    "lender": {
      "type": "string",
      "description": "Lender name, slug, or 20-char LEI"
    }
  }
}

{
  "title": "Lender FHA denial rate 2025",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "which FHA lender denies the most or the fewest", "rank FHA lenders by denial rate", "which lenders are covered", "how wide is the spread". Returns the ranked list of the 100 largest FHA lenders with name, slug, rate and volume; the 2025 span runs 1.8 to 78.7 percent inside the same federal program. NOT FOR: lenders outside the top 100, or any recommendation about where to apply. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "highest_denial",
        "lowest_denial",
        "largest_volume"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    }
  }
}

{
  "title": "Top-100 FHA lenders by denial rate",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "are small mortgages denied more often", "is it harder to get a small FHA loan", "which state punishes small loans most", "does loan size affect denial". PARAM: optional two-letter state; omit for the ranked list. Returns denial rates under $150K and over $250K, the ratio, the ranking and any open discrepancy note. In 2025 the penalty exceeded 1x in every jurisdiction with a published split, from 1.19x to 4.45x (Idaho, 53.4 vs 12.0). NOT FOR: loan sizes between the bands, which are not published. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter USPS code, optional"
    }
  },
  "additionalProperties": false
}

{
  "title": "Small-loan denial penalty by state",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "why are FHA loans denied", "what is the most common denial reason", "which lender cites incomplete applications most", "how often is debt-to-income the reason". PARAM: optional lender; omit for cross-lender medians. Returns median and maximum share of each HMDA denial reason across the 95 of the 100 largest lenders that report reasons, and which lender carries the highest share of each. Reason fields are not a partition; shares need not sum to 100. NOT FOR: why a particular application was denied. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "properties": {
    "lender": {
      "type": "string",
      "description": "Lender name or slug, optional"
    }
  },
  "additionalProperties": false
}

{
  "title": "FHA denial-reason shares",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "what is the FHA denial rate in <state>", "is it harder to get an FHA loan in <state>", "how does <state> compare with the national rate". PARAM: two-letter USPS code only (OH, TX); full names are rejected. Returns the state 2025 rate and counts against the national 22.1 percent. NOT FOR: metro or city questions (use get_metro_lender_gap) or lender-level questions. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "required": [
    "state"
  ],
  "properties": {
    "state": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2
    }
  }
}

{
  "title": "State FHA denial rate 2025",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "does it matter which lender you apply to", "how much of a denial is the lender rather than the borrower", "what is the Door Effect". Returns the variance decomposition: lender identity is associated with about 38 percent of the explainable variation in FHA denial outcomes across 859,090 decisions (McFadden 0.1712 to 0.2760), with model, sample and limits. Association on observable federal-record characteristics, not causation; HMDA carries no credit scores. NOT FOR: saying a lender caused a denial, or any individual estimate. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "title": "Door Effect (lender share of explainable variation)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "do lenders differ within one city", "what is the FHA denial gap in <metro>", "which lender is strictest in <metro>", "how much does the lender matter locally". PARAM: metro name or slug. Returns a claim passport for that metro: lowest and highest lender denial rates among lenders with at least 100 decisioned applications there, the gap in points, counts and source reference. Cleveland is the widest in 2025 at 73.7 points (6.4 vs 80.1). NOT FOR: ZIP or neighbourhood questions, and never as evidence a lender acted improperly. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "required": [
    "metro"
  ],
  "properties": {
    "metro": {
      "type": "string",
      "description": "Metro name or slug, e.g. 'Cleveland, OH' or 'cleveland-oh'"
    }
  }
}

{
  "title": "Metro lender denial gap",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "run my list of lenders through the federal record", "screen these LEIs", "which of my counterparties deny more than their applicant mix predicts". PARAM: a list of public LEIs. Returns per-entity observed versus expected FHA denial rates, coverage flags, method version and an evidence manifest hash. Public entity identifiers only: never borrower files, credit data or personal information. Free preview; the full Evidence Brief needs a licence a human buys on the pricing page, and an agent may relay the offer but can never complete a purchase. Screening signals, not findings of misconduct. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "required": [
    "lei_list"
  ],
  "properties": {
    "lei_list": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "1-40 public Legal Entity Identifiers (20-character ISO 17442). Hard cap 100; duplicates removed deterministically."
    },
    "license_key": {
      "type": "string",
      "description": "Optional. A Lemon Squeezy license key issued for 'Counterparty Screen' (one-time or quarterly). Only pass it if the user explicitly provided it."
    },
    "requested_format": {
      "enum": [
        "summary",
        "evidence_brief"
      ],
      "type": "string",
      "description": "Optional. 'evidence_brief' requests the full audit artefact (licensed mode)."
    }
  }
}

{
  "title": "Counterparty outlier screen (LEI batch)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "what would it cost to screen this list", "how many of my LEIs are covered". PARAM: a list of public LEIs. Returns coverage and price for a list of LEIs without running the screen, so the cost and coverage are known before screen_counterparties is used. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "required": [
    "lei_list"
  ],
  "properties": {
    "lei_list": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "1-40 public LEIs to be quoted."
    },
    "license_key": {
      "type": "string",
      "description": "Optional. Include it to see the account's remaining balance in the quote."
    }
  }
}

{
  "title": "Counterparty screen quote",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "can I screen a group of lenders", "what ready-made lender groups can I run", "show me an example screen". Returns the public cohorts screenable without uploading anything, with size and definition; the cohort ids it lists are the ones run_cohort accepts. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "properties": {}
}

{
  "title": "Published conditional cohorts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "run the screen on <cohort>", "how do these lenders compare against expectation". PARAM: cohort id from list_cohorts. Returns the peer-adjusted screen: observed versus expected denial rate, coverage flags, method version. Free preview; the full Evidence Brief needs a licence a human buys on the pricing page. Screening signals, never evidence of misconduct. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "required": [
    "cohort_id"
  ],
  "properties": {
    "cohort_id": {
      "type": "string",
      "description": "One of the ids returned by list_cohorts, e.g. top-volume-fha, high-coverage-only, above-expectation, depository-institutions, screening-only."
    },
    "license_key": {
      "type": "string",
      "description": "Optional. Only pass it if the user explicitly provided one."
    },
    "requested_format": {
      "enum": [
        "summary",
        "evidence_brief"
      ],
      "type": "string"
    }
  }
}

{
  "title": "Run a published cohort",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "does this lender's strictness depend on loan size or leverage", "where is <lender> hardest", "is the gap the same across the market". PARAM: lender name or slug. Returns how that lender's peer-adjusted denial gap changes across published cells (state x loan amount x income x DTI x CLTV), with cell counts and the minimum-cell rule. NOT FOR: suppressed small cells, or any individual prediction. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.

{
  "type": "object",
  "properties": {
    "lender": {
      "type": "string",
      "description": "Lender name or 20-char LEI. Omit to list every lender with a published conditional surface."
    }
  }
}

{
  "title": "Lender gap across published cells",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "what is the current FHA loan limit", "what are the 2026 HOEPA / QM thresholds", "what is the VA funding fee table", "which FHA MIP table is in force". PARAM: rule_id (from the index) or omit to list every published rule. Returns the machine-readable rule: cells, effective dates, issuer document, required qualifiers, what the table does not establish, sha256. The cell values and effective dates are in the file; in a published test, models answered 3/25 dated questions correctly without a source and 25/25 with this file. NOT FOR: rules not in the index, or anything before the effective date.

{
  "type": "object",
  "properties": {
    "rule_id": {
      "type": "string",
      "description": "e.g. frc:rule:hud-ml-2023-05-annual-mip. Omit to list."
    }
  }
}

{
  "title": "Dated regulatory rule table",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ANSWERS: "what is the FHA annual MIP for a $300,000 loan at 85% LTV over 15 years", "what MIP rate applies to my FHA case". PARAMS: base_loan_amount (USD), ltv_pct (e.g. 96.5), term_years, case_number_date (YYYY-MM-DD). Resolves the exact cell of HUD Mortgagee Letter 2023-05 and returns the annual rate in basis points, the upfront rate, the matched cell, the rule id with effective date and sha256, and a sentence you may quote. If a parameter is missing it returns block with CONDITION_MISSING and no number: the table has eleven cells and a guess is wrong more often than right. NOT FOR: case numbers before 2023-03-20, HECM/reverse or Title I loans, or any monthly payment figure.

{
  "type": "object",
  "properties": {
    "ltv_pct": {
      "type": "number",
      "description": "Loan-to-value in percent, e.g. 96.5"
    },
    "term_years": {
      "type": "number",
      "description": "Loan term in years"
    },
    "base_loan_amount": {
      "type": "number",
      "description": "Base loan amount in USD, before upfront MIP is financed"
    },
    "case_number_date": {
      "type": "string",
      "description": "FHA case number assignment date, YYYY-MM-DD"
    }
  }
}

{
  "title": "Resolve the FHA annual MIP cell",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Advertised by the server during the last successful anonymous check.

Restate one published figure in its canonical form, with period, population, program and the receipt next to the number. Fetches the claim document and contract; the model does the restating.

claim_id

Claim id, e.g. state-oh-2025, lender-rocket-mortgage-2025, metro-gap-cleveland-oh-2025 (required)

audience

Who will read it (journalist, borrower, analyst). Optional.

Advertised by the server during the last successful anonymous check.

Audit a paragraph that quotes this publisher's figures: each number matched to a receipted claim, qualifiers kept or dropped, sentence patterns the record cannot support (prediction, recommendation, cause, legal conclusion).

text

The paragraph to audit (required)

Advertised by the server during the last successful anonymous check.

Produce the citation block for one claim: canonical sentence, receipt, verify URL, attribution line, licence.

claim_id

Claim id (required)

Advertised by the server during the last successful anonymous check.

386 claims: receipt, canonical sentence, what the figure does not establish, dated correction, which crawler last verified it, verify URL. Rebuilt daily.

https://financeratecalc.com/llms-full.txt

MIME type: text/plain

Advertised by the server during the last successful anonymous check.

Short index of pages, feeds and endpoints.

https://financeratecalc.com/llms.txt

MIME type: text/plain

Advertised by the server during the last successful anonymous check.

Every claim id with its document URL; each document carries its receipt and hash rule.

https://financeratecalc.com/claims/index.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Every dated correction and error family, with the claim ids each one touches. Poll daily.

https://financeratecalc.com/corrections.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

How to verify any receipt from this publisher without this server: hash rules, hash history, claim URL template.

https://financeratecalc.com/.well-known/receipt.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Which crawler verified which receipt, by day. Bots only. A check, not a citation.

https://financeratecalc.com/transparency/crawl-ledger.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Dated regulatory tables with effective dates and qualifiers: FHA MIP, FHA/FHFA limits, HOEPA/QM thresholds, VA funding fee.

https://financeratecalc.com/rules/index.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Every lender, metro and state slug with its data file.

https://financeratecalc.com/api/index.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

The publisher-independent receipt grammar, verify statuses and conformance suite.

https://financeratecalc.com/spec/receipt-1.0.md

MIME type: text/markdown

Advertised by the server during the last successful anonymous check.

The hashed claim document for one claim id (the receipt is computed from it).

https://financeratecalc.com/claims/{id}.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Canonical sentence template, required qualifiers, what the figure does not establish, forbidden transformations.

https://financeratecalc.com/claims/{id}.contract.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

FHA denial record for one state (two-letter code, lower case).

https://financeratecalc.com/api/state/{xx}.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

FHA denial record for one lender slug (see api/index.json).

https://financeratecalc.com/api/lender/{slug}.json

MIME type: application/json

Advertised by the server during the last successful anonymous check.

FHA denial record for one metropolitan area slug (see api/index.json).

https://financeratecalc.com/api/metro/{slug}.json

MIME type: application/json