HomeCalc Connector — developer documentation

    Last reviewed: November 2026.

    The HomeCalc Connector is a free, read-only Model Context Protocol (MCP) server for HomeCalc.ca’s Canadian mortgage, tax and real-estate calculators. This page is for developers and anyone wiring it into an MCP client: the endpoint, the protocol details, every tool’s input schema, and real requests with the exact responses they return.

    One of Canada’s most comprehensive mortgage and real-estate MCP connectors: 34 free calculators, with land transfer tax and closing costs for every province and territory.

    Every example on this page is real

    Each request below was sent to https://homecalc.ca/api/mcp on 2026-11-03, and each response is shown exactly as the server returned it. HomeCalc’s automated tests re-run every request against the connector’s code and fail if any response changes.

    Overview

    HomeCalc Connector at a glance
    Value
    Endpointhttps://homecalc.ca/api/mcp
    TransportMCP Streamable HTTP — JSON-RPC 2.0 over POST; responses arrive as text/event-stream
    Protocol revisions2026-07-28, and the 2025-era revisions 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07
    AuthenticationNone — no account, no API key
    SessionsStateless — no mcp-session-id is issued; every request stands alone
    Tools34 calculation tools, all marked readOnlyHint: true and openWorldHint: false
    Serverhomecalc 0.1.0
    Browser clientsCORS allows any origin (Access-Control-Allow-Origin: *)
    PriceFree

    There is no published rate limit, quota or service-level agreement. The tools only compute and return numbers — nothing is created, changed or deleted.

    Health check

    A plain GET on the endpoint answers without an MCP client, so you can check it from a browser:

    Request

    curl -sS https://homecalc.ca/api/mcp

    Response (HTTP 200)

    {"name":"homecalc","status":"ok","transport":"streamable-http","endpoint":"/api/mcp","docs":"https://homecalc.ca/connector"}

    A CORS preflight (OPTIONS) returns HTTP 204 with no body.

    Connect an MCP client

    Claude: open Settings → Connectors, choose Add custom connector, paste https://homecalc.ca/api/mcp and leave authentication set to None. The connector page has the same steps.

    Other MCP clients: clients that support remote Streamable HTTP servers connect with the same URL and no credentials. We test the endpoint with the official MCP TypeScript SDK client in both protocol eras: a client pinned to 2026-07-28 (no initialize handshake) and a default 2025-era client (with initialize). Both list the same 34 tools and return identical results. SDK clients negotiate the protocol version for you.

    Raw HTTP quick start

    You don’t need an SDK. Every request is a JSON-RPC 2.0 body sent with POST and these headers:

    • content-type: application/json
    • accept: application/json, text/event-stream — both are required (see 406)
    • mcp-protocol-version: 2025-06-18 — the revision these examples use

    The response is a single server-sent event: an event: message line followed by a data: line that carries the JSON-RPC response.

    1. initialize (optional on a stateless server)

    A 2025-era client usually starts with initialize. Because the server is stateless, nothing from it has to be sent on later requests.

    Request

    curl -sS https://homecalc.ca/api/mcp \
      -H 'content-type: application/json' \
      -H 'accept: application/json, text/event-stream' \
      -H 'mcp-protocol-version: 2025-06-18' \
      -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0.0"}}}'

    Response

    event: message
    data: {"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"homecalc","version":"0.1.0"},"instructions":"HomeCalc.ca provides accurate, source-backed Canadian mortgage and real-estate calculators. Use these tools to answer Canadian home-buying, mortgage, and tax math questions with 2026 figures: mortgages (payment, amortization, stress test, qualifying, renewal, prepayment, penalty, CMHC, HELOC, reverse), buying and selling costs (land transfer tax, closing costs, commission, property tax), income and capital gains tax, and investing (cap rate, flips, rent vs buy, renovations, development). Every result includes a source link on homecalc.ca and is an estimate, not financial advice — surface both to the user."},"jsonrpc":"2.0","id":1}

    2. tools/list

    Request

    curl -sS https://homecalc.ca/api/mcp \
      -H 'content-type: application/json' \
      -H 'accept: application/json, text/event-stream' \
      -H 'mcp-protocol-version: 2025-06-18' \
      -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

    The response lists all 34 tools with their JSON Schema (2020-12) input schemas. The first entry is shown in full below; the tool reference covers the rest. Default values for optional parameters are included in the live tools/list response — read them from there, because some follow the rates HomeCalc updates weekly.

    First entry of result.tools (defaults omitted)

    {
      "name": "mortgage_payment",
      "title": "Canadian Mortgage Payment Calculator",
      "description": "Periodic payment on a Canadian mortgage. Pass EITHER homePrice + downPayment (CMHC insurance is added under 20% down) OR loanAmount alone when the user gave the mortgage amount (e.g. \"payment on a $500,000 mortgage\"). Never invent a purchase price to reach a loan amount: it shifts the answer and adds a CMHC premium the user may not owe.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "homePrice": {
            "description": "Purchase price in CAD, with downPayment. Omit if the user gave the mortgage amount.",
            "type": "number",
            "exclusiveMinimum": 0
          },
          "loanAmount": {
            "description": "Mortgage amount in CAD, instead of homePrice. No CMHC premium is added.",
            "type": "number",
            "exclusiveMinimum": 0
          },
          "downPayment": {
            "description": "Down payment in CAD, or percent if downPaymentType='percent'. Required with homePrice.",
            "type": "number",
            "minimum": 0
          },
          "annualInterestRatePct": {
            "type": "number",
            "minimum": 0,
            "maximum": 25,
            "description": "Annual interest rate as a percent, e.g. 5.25"
          },
          "amortizationYears": {
            "description": "Amortization in years (max 25 insured, 30 uninsured/first-time new builds)",
            "type": "number",
            "minimum": 1,
            "maximum": 30
          },
          "downPaymentType": {
            "description": "downPayment as dollars or percent of homePrice",
            "type": "string",
            "enum": [
              "amount",
              "percent"
            ]
          },
          "paymentFrequency": {
            "description": "How often payments are made",
            "type": "string",
            "enum": [
              "monthly",
              "semi-monthly",
              "biweekly",
              "accelerated-biweekly",
              "weekly",
              "accelerated-weekly"
            ]
          },
          "rateType": {
            "description": "Fixed or variable rate",
            "type": "string",
            "enum": [
              "fixed",
              "variable"
            ]
          },
          "termYears": {
            "description": "Mortgage term in years",
            "type": "number",
            "minimum": 1,
            "maximum": 10
          },
          "province": {
            "description": "Province name, used only for CMHC PST on the premium",
            "type": "string"
          }
        },
        "required": [
          "annualInterestRatePct"
        ],
        "examples": [
          {
            "homePrice": 650000,
            "downPayment": 65000,
            "annualInterestRatePct": 5.25
          }
        ]
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      }
    }

    3. tools/call

    Request

    curl -sS https://homecalc.ca/api/mcp \
      -H 'content-type: application/json' \
      -H 'accept: application/json, text/event-stream' \
      -H 'mcp-protocol-version: 2025-06-18' \
      -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"mortgage_payment","arguments":{"homePrice":650000,"downPayment":65000,"annualInterestRatePct":5.25,"amortizationYears":25}}}'

    Response

    event: message
    data: {"result":{"content":[{"type":"text","text":"{\n  \"basis\": \"homePrice\",\n  \"monthlyPayment\": 3594.19,\n  \"paymentAmount\": 3594.19,\n  \"paymentLabel\": \"Monthly\",\n  \"mortgagePrincipal\": 585000,\n  \"downPaymentAmount\": 65000,\n  \"downPaymentPercent\": 10,\n  \"cmhcRequired\": true,\n  \"cmhcInsurancePremium\": 18135,\n  \"cmhcInsuranceRate\": 0.031,\n  \"source\": \"https://homecalc.ca/tools/mortgage-payment-calculator\",\n  \"disclaimer\": \"Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA.\"\n}"}],"structuredContent":{"basis":"homePrice","monthlyPayment":3594.19,"paymentAmount":3594.19,"paymentLabel":"Monthly","mortgagePrincipal":585000,"downPaymentAmount":65000,"downPaymentPercent":10,"cmhcRequired":true,"cmhcInsurancePremium":18135,"cmhcInsuranceRate":0.031,"source":"https://homecalc.ca/tools/mortgage-payment-calculator","disclaimer":"Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."}},"jsonrpc":"2.0","id":3}

    Tool reference

    All 34 tools, in the order tools/list returns them:

    mortgage_payment

    Canadian Mortgage Payment Calculator

    Periodic payment on a Canadian mortgage. Pass EITHER homePrice + downPayment (CMHC insurance is added under 20% down) OR loanAmount alone when the user gave the mortgage amount (e.g. "payment on a $500,000 mortgage"). Never invent a purchase price to reach a loan amount: it shifts the answer and adds a CMHC premium the user may not owe.

    Input parameters for mortgage_payment
    ParameterTypeRequiredAllowed valuesDescription
    homePricenumberNo> 0Purchase price in CAD, with downPayment. Omit if the user gave the mortgage amount.
    loanAmountnumberNo> 0Mortgage amount in CAD, instead of homePrice. No CMHC premium is added.
    downPaymentnumberNo≥ 0Down payment in CAD, or percent if downPaymentType='percent'. Required with homePrice.
    annualInterestRatePctnumberYes≥ 0, ≤ 25Annual interest rate as a percent, e.g. 5.25
    amortizationYearsnumberNo≥ 1, ≤ 30Amortization in years (max 25 insured, 30 uninsured/first-time new builds)
    downPaymentTypestringNoamount, percentdownPayment as dollars or percent of homePrice
    paymentFrequencystringNomonthly, semi-monthly, biweekly, accelerated-biweekly, weekly, accelerated-weeklyHow often payments are made
    rateTypestringNofixed, variableFixed or variable rate
    termYearsnumberNo≥ 1, ≤ 10Mortgage term in years
    provincestringNoProvince name, used only for CMHC PST on the premium

    See a live example of mortgage_payment

    minimum_down_payment

    Minimum Down Payment Calculator (Canada)

    Minimum down payment for a Canadian home under the Dec 2024 CMHC rules (5% of the first $500k, 10% of $500k–$1.5M, 20% at/above $1.5M), whether CMHC insurance applies, and the premium rate.

    Input parameters for minimum_down_payment
    ParameterTypeRequiredAllowed valuesDescription
    homePricenumberYes> 0Purchase price in CAD

    See a live example of minimum_down_payment

    land_transfer_tax

    Canadian Land Transfer Tax Calculator

    Estimate land transfer tax on a home purchase in any of the 13 provinces and territories (incl. Toronto MLTT, Montreal welcome tax) with first-time buyer rebates, the transfer registration fee (to register the deed) and the total due at registration. AB, SK, NL and the territories charge no land transfer tax, only the registration fee. The mortgage registration fee is not included.

    Input parameters for land_transfer_tax
    ParameterTypeRequiredAllowed valuesDescription
    pricenumberYes> 0Purchase price in CAD
    provincestringYesOntario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, YukonProvince or territory
    inTorontobooleanNoOntario only: property is within the City of Toronto (adds the municipal LTT)
    isFirstTimeBuyerbooleanNoFirst-time buyer (rebate where one exists)
    quebecMunicipalitystringNomontreal, otherQuebec only: 'montreal' = Montreal's welcome-tax brackets (default); 'other' = provincial base schedule, for municipalities without higher rates above $500,000

    See a live example of land_transfer_tax

    income_tax

    Canadian Income Tax & Take-Home Calculator

    2026 Canadian federal + provincial income tax, CPP/QPP, EI, QPIP (Quebec), Ontario surtax and Health Premium where applicable, and take-home pay, for any province.

    Input parameters for income_tax
    ParameterTypeRequiredAllowed valuesDescription
    annualIncomenumberYes≥ 0Gross annual employment income in CAD
    provincestringYesOntario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, Newfoundland & LabradorProvince of residence
    employmentTypestringNoemployed, self_employedSelf-employed pays both CPP/QPP halves
    rrspContributionnumberNo≥ 0Annual RRSP contribution in CAD

    See a live example of income_tax

    mortgage_penalty

    Mortgage Prepayment Penalty Calculator (IRD)

    Estimate the penalty to break a Canadian mortgage: three months' interest vs the interest rate differential (IRD), incl. the big-bank posted-rate method. Fixed = greater of the two; variable = usually three months' interest. The three optional rate inputs are lender-specific: if omitted, illustrative site defaults are used (the answer can be several times off) and listed in `assumedInputs` — show them to the user and have them confirm with their lender.

    Input parameters for mortgage_penalty
    ParameterTypeRequiredAllowed valuesDescription
    balancenumberYes> 0Outstanding mortgage balance in CAD
    rateTypestringNofixed, variableFixed or variable mortgage
    contractRatePctnumberYes≥ 0, ≤ 25Your contract rate as a percent, e.g. 5.25
    monthsRemainingnumberYes≥ 0, ≤ 120Months remaining in the term
    lenderMethodstringNobig-bank, monolineBig banks use the posted-rate IRD, monolines actual rates. Either can be larger, depending on the original discount vs today's posted rate.
    currentRateForRemainingTermPctnumberNo≥ 0, ≤ 25Monoline method: today's rate for the remaining term (percent). Omit if unknown (assumption is flagged).
    postedAtOriginationPctnumberNo≥ 0, ≤ 25Big-bank method: posted (not discounted) rate when signed, from the mortgage documents. Can change the penalty several-fold. Omit if unknown (assumption is flagged).
    todaysPostedForClosestTermPctnumberNo≥ 0, ≤ 25Big-bank method: the lender's posted rate today for the closest term. Omit if unknown (assumption is flagged).

    See a live example of mortgage_penalty

    bc_home_flipping_tax

    BC Home Flipping Tax Calculator

    Estimate British Columbia's home flipping tax on a property sold within 730 days: 20% tapering to 0% between 366 and 730 days, with a $20,000 primary-residence deduction (only if held at least 365 days).

    Input parameters for bc_home_flipping_tax
    ParameterTypeRequiredAllowed valuesDescription
    taxableIncomenumberYesProceeds minus cost to acquire minus cost to improve (may be negative)
    daysHeldnumberYes≥ 0Days owned before the sale
    isPrimaryResidencebooleanNoLived in it as a primary residence

    See a live example of bc_home_flipping_tax

    rent_increase

    Rent Increase Guideline Calculator (ON / BC / MB)

    ON/BC/MB rent-increase guideline and new rent, floored to the cent. capped:false = exempt unit.

    Input parameters for rent_increase
    ParameterTypeRequiredAllowed valuesDescription
    currentRentnumberYes> 0Current monthly rent in CAD
    provincestringYesOntario, British Columbia, ManitobaProvince whose guideline applies
    yearstringYesGuideline year, e.g. '2026'; unsupported = latest (shown in reply)
    unitExemptbooleanNoON: first occupied on/after 15 Nov 2018. MB: exempt for a non-rent reason

    See a live example of rent_increase

    capital_gains_tax

    Canadian Capital Gains Tax Calculator

    Estimate Canadian capital gains tax on selling real estate, stocks, crypto, a business or a rental. Applies the flat 50% inclusion rate, principal-residence exemption, lifetime capital gains exemption for QSBC shares, capital-loss offsets and rental CCA recapture, then taxes the gain on top of other income at federal + provincial brackets.

    Input parameters for capital_gains_tax
    ParameterTypeRequiredAllowed valuesDescription
    salePricenumberYes≥ 0Gross sale proceeds in CAD
    purchasePricenumberYes≥ 0Original purchase price in CAD
    provincestringNoOntario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, YukonProvince/territory of residence
    annualIncomenumberNo≥ 0Other annual income in CAD; the gain is taxed on top of it
    assetTypestringNoreal-estate, stocks, crypto, business, rental, otherWhat was sold; decides which exemptions apply
    sellingCostsnumberNo≥ 0Commission, legal and other selling costs
    buyingCostsnumberNo≥ 0Land transfer tax, legal and other buying costs
    capitalImprovementsnumberNo≥ 0Capital improvements added to the adjusted cost base
    isPrincipalResidencebooleanNoReal estate only: claim the principal residence exemption
    yearsOwnednumberNo≥ 0Years owned (for principal-residence proration)
    yearsDesignatednumberNo≥ 0Years designated as your principal residence
    isQSBCbooleanNoBusiness only: qualified small business corporation shares (LCGE)
    lcgeRemainingnumberNo≥ 0Remaining lifetime capital gains exemption room in CAD
    capitalLossesnumberNo≥ 0Capital losses (prior or current) to offset the gain
    taxpayerTypestringNoindividual, corporation, trustWho sold the asset
    taxYearnumberNo≥ 2020, ≤ 2035Tax year of the disposition
    landValuenumberNo≥ 0Rental only: land portion of the sale price (splits land vs building gain)
    originalBuildingCostnumberNo≥ 0Rental only: original building cost for CCA recapture
    ccaClaimedToDatenumberNo≥ 0Rental only: total CCA claimed to date

    See a live example of capital_gains_tax

    heloc_second_mortgage

    HELOC & Second Mortgage Calculator (Canada)

    Compare a HELOC with a second mortgage for tapping home equity in Canada: how much you can borrow (revolving HELOC capped at 65% LTV, total secured borrowing to 80% with an A lender), monthly payments, TDS qualification at the OSFI stress-test rate, and the same for B and private lenders.

    Input parameters for heloc_second_mortgage
    ParameterTypeRequiredAllowed valuesDescription
    homeValuenumberYes> 0Current market value of the home in CAD
    outstandingFirstMortgagenumberYes≥ 0Balance remaining on the first mortgage in CAD
    amountToBorrownumberYes≥ 0Amount you want to borrow in CAD
    annualHouseholdIncomenumberYes≥ 0Gross annual household income in CAD
    provincestringNoOntario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, Newfoundland and Labrador, Prince Edward IslandSets the property-tax estimate used in TDS
    existingMonthlyDebtsnumberNo≥ 0Other monthly debt payments (car, cards, loans)
    purposeOfFundsstringNoHome Renovation, Debt Consolidation, Investment Property Down Payment, Education, Emergency Funds, OtherWhat the money is for
    secondMortgageLenderTierstringNoA, B, PrivateA = bank/credit union, B = trust/MIC, Private = individual investor
    helocPrimeRatePctnumberNo≥ 0, ≤ 25Prime rate as a percent; defaults to the site's current prime
    helocSpreadPctnumberNo≥ 0, ≤ 10Lender spread over prime as a percent, e.g. 0.5
    secondMortgageRatePctnumberNo≥ 0, ≤ 30Second mortgage rate as a percent; defaults to the tier's typical rate
    secondMortgageAmortYearsnumberNo≥ 1, ≤ 30Second mortgage amortization in years (not used by interest-only Private)
    secondMortgageTermYearsnumberNo≥ 1, ≤ 10Second mortgage term in years
    extraMonthlyPrincipalnumberNo≥ 0Optional extra principal paid monthly on the HELOC

    See a live example of heloc_second_mortgage

    mortgage_affordability

    Mortgage Affordability Calculator (Canada)

    Maximum home price a Canadian buyer qualifies for: the highest price that keeps GDS (39%) and TDS (44%) within limits at the OSFI stress-test rate, honouring the Dec-2024 minimum down payment tiers and the $1.5M CMHC insurability ceiling. Returns max price, max mortgage, CMHC premium, monthly payment and GDS/TDS.

    Input parameters for mortgage_affordability
    ParameterTypeRequiredAllowed valuesDescription
    annualIncomenumberYes≥ 0Primary applicant gross annual income in CAD
    downPaymentnumberYes≥ 0Down payment — dollars, or a percent if downPaymentMode='percent'
    coApplicantIncomenumberNo≥ 0Co-applicant gross annual income in CAD (0 = none)
    downPaymentModestringNodollar, percentdownPayment as dollars or percent
    monthlyDebtsnumberNo≥ 0Other monthly debt payments (car, cards, student loans)
    annualPropertyTaxnumberNo≥ 0Estimated annual property tax in CAD
    monthlyHeatingnumberNo≥ 0Estimated monthly heating cost in CAD
    propertyTypestringNosingle-family, condo, townhouseType of home being bought
    condoFeesnumberNo≥ 0Monthly condo fees — 50% counts toward GDS/TDS for condos
    provincestringNoProvince of the purchase
    interestRatePctnumberNo≥ 0, ≤ 25Contract mortgage rate as a percent, e.g. 4.79
    amortizationYearsanyNoAmortization: 25 or 30 years

    See a live example of mortgage_affordability

    cap_rate

    Cap Rate & Rental Property Calculator (Canada)

    Canadian rental property analysis: cap rate, net operating income, gross rent multiplier, expense ratio, annual cash flow and cash-on-cash return, with the cap rate compared to typical local yields. Mortgage math uses Canadian semi-annual compounding.

    Input parameters for cap_rate
    ParameterTypeRequiredAllowed valuesDescription
    purchasePricenumberYes> 0Purchase price in CAD
    monthlyGrossRentnumberYes≥ 0Gross monthly rent for all units in CAD
    annualOperatingExpensesnumberYes≥ 0Annual operating expenses in CAD (tax, insurance, management, maintenance, landlord utilities); excludes the mortgage
    downPaymentnumberYes≥ 0Down payment in CAD. Set equal to purchasePrice for an all-cash purchase.
    interestRatePctnumberNo≥ 0, ≤ 25Mortgage rate as a percent, e.g. 5.49
    amortizationYearsnumberNo≥ 1, ≤ 30Mortgage amortization in years
    vacancyRatePctnumberNo≥ 0, ≤ 100Vacancy allowance as a percent of gross rent
    citystringNotoronto, vancouver, calgary, edmonton, ottawa, montreal, halifax, winnipeg, hamilton, kitchener-waterloo, otherCity used for the cap-rate benchmark range
    propertyTypestringNosingle-family, multi-unit, commercial, mixed-useUsed for down payment warnings

    See a live example of cap_rate

    house_flipping

    House Flipping Profit Calculator (Canada)

    Estimate profit on a Canadian house flip: land transfer tax (with first-time buyer rebate), renovation with contingency, holding costs, realtor commission and closing costs, then the tax bill. Flags the CRA residential property flipping rule (held under 12 months = 100% business income, no capital gains treatment) and the tax saved by waiting past 12 months.

    Input parameters for house_flipping
    ParameterTypeRequiredAllowed valuesDescription
    purchasePricenumberYes> 0Purchase price in CAD
    afterRepairValuenumberYes> 0Expected resale price after renovation (ARV) in CAD
    renovationCostnumberYes≥ 0Budgeted renovation cost in CAD, before contingency
    provincestringNoOntario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, NewfoundlandProvince; sets the land transfer tax
    citystringNoCity name — include 'Toronto' to add the Toronto municipal land transfer tax
    contingencyPctnumberNo≥ 0, ≤ 100Contingency as a percent of renovationCost
    holdingPeriodMonthsnumberNo≥ 0, ≤ 120Months held from purchase to sale — under 12 triggers the CRA flipping rule
    monthlyHoldingCostsnumberNo≥ 0Monthly carrying costs: mortgage interest, property tax, insurance, utilities
    realtorCommissionPctnumberNo≥ 0, ≤ 15Realtor commission on the sale as a percent of ARV
    closingCostsBuynumberNo≥ 0Purchase legal/inspection costs, excluding land transfer tax
    closingCostsSellnumberNo≥ 0Sale legal/staging costs, excluding commission
    marginalTaxRatePctnumberNo≥ 0, ≤ 60Your combined marginal tax rate as a percent
    isFirstTimeBuyerbooleanNoEligible for the first-time buyer land transfer tax rebate

    See a live example of house_flipping

    mortgage_amortization

    Canadian Mortgage Amortization Schedule

    Year-by-year amortization of a Canadian mortgage (semi-annual compounding): payment, total interest, balance at renewal, payoff year, and an annual table. Optional lump-sum / payment-increase prepayments show interest and time saved.

    Input parameters for mortgage_amortization
    ParameterTypeRequiredAllowed valuesDescription
    principalnumberYes> 0Mortgage amount in CAD
    annualInterestRatePctnumberNo≥ 0.01, ≤ 25Annual interest rate as a percent, e.g. 4.5
    amortizationYearsintegerNo≥ 1, ≤ 40Amortization in years
    paymentFrequencystringNomonthly, semi-monthly, biweekly, accelerated-biweekly, weekly, accelerated-weeklyHow often payments are made
    termYearsintegerNo≥ 1, ≤ 10Mortgage term in years (sets the renewal point)
    annualLumpSumnumberNo≥ 0Extra lump-sum prepayment each year in CAD
    paymentIncreasePctnumberNo≥ 0, ≤ 100Raise each regular payment by this percent
    prepaymentStartYearintegerNo≥ 1, ≤ 40Year the prepayments start

    See a live example of mortgage_amortization

    mortgage_stress_test

    Canadian Mortgage Stress Test (OSFI B-20)

    Check a purchase, renewal or refinance against the OSFI stress test: qualifying rate (higher of contract + 2% or 5.25%), GDS/TDS at 39/44, pass/close/fail, max home price for a purchase, and how far off a fail is. Straight-switch renewals are exempt unless the amount or amortization increases.

    Input parameters for mortgage_stress_test
    ParameterTypeRequiredAllowed valuesDescription
    scenariostringNopurchase, renewal, refinanceBuying, renewing, or refinancing
    annualIncomenumberYes≥ 0Main applicant gross annual income in CAD
    coApplicantIncomenumberNo≥ 0Co-applicant gross annual income in CAD (0 if none)
    homePricenumberYes> 0Purchase price, or current home value for renewal/refinance, in CAD
    downPaymentnumberNo≥ 0Purchase only: down payment in CAD
    outstandingBalancenumberNo≥ 0Renewal/refinance only: balance owing in CAD
    additionalBorrownumberNo≥ 0Refinance only: extra cash to borrow in CAD
    contractRatePctnumberNo≥ 0.01, ≤ 25Contract interest rate as a percent
    renewalRatePctnumberNo≥ 0.01, ≤ 25Renewal only: rate you are renewing into, percent
    renewalWithNewLenderbooleanNoRenewal only: switching to a new lender
    renewalIncreasingbooleanNoRenewal only: increasing the amount or amortization (then the stress test applies)
    amortizationYearsintegerNo≥ 5, ≤ 30Amortization in years (5–30)
    monthlyPropertyTaxnumberNo≥ 0Monthly property tax in CAD
    monthlyHeatingnumberNo≥ 0Monthly heating cost in CAD
    monthlyCondoFeesnumberNo≥ 0Monthly condo fees in CAD (50% counts)
    monthlyDebtPaymentsnumberNo≥ 0Other monthly debt payments in CAD

    See a live example of mortgage_stress_test

    mortgage_prepayment

    Mortgage Prepayment Savings Calculator (Canada)

    Interest and time saved by prepaying a Canadian mortgage with extra per-payment amounts, an annual lump sum, or both, plus the estimated penalty if the prepayment were over your privilege limit (3 months' interest or IRD).

    Input parameters for mortgage_prepayment
    ParameterTypeRequiredAllowed valuesDescription
    balancenumberYes> 0Current mortgage balance in CAD
    annualInterestRatePctnumberNo≥ 0.01, ≤ 25Annual interest rate as a percent
    amortizationYearsintegerNo≥ 1, ≤ 40Remaining amortization in years
    paymentFrequencystringNomonthly, semi-monthly, biweekly, accelerated-biweekly, weekly, accelerated-weeklyHow often payments are made
    extraPerPaymentnumberNo≥ 0Extra amount added to every payment in CAD
    annualLumpSumnumberNo≥ 0Lump sum paid once a year in CAD
    lumpSumStartYearintegerNo≥ 1, ≤ 40Year the annual lump sum starts
    rateTypestringNofixed, variableFixed or variable (sets the penalty method)
    monthsRemainingInTermintegerNo≥ 0, ≤ 120Months left in the current term
    comparisonRatePctnumberNo≥ 0, ≤ 25Lender's comparison rate for the IRD, percent

    See a live example of mortgage_prepayment

    mortgage_renewal

    Mortgage Renewal Payment Shock Calculator (Canada)

    Compare a Canadian mortgage's payment and term interest at the current rate vs the renewal rate: new payment, monthly and annual change, and extra interest over the new term. An optional lump sum at renewal reduces the balance.

    Input parameters for mortgage_renewal
    ParameterTypeRequiredAllowed valuesDescription
    balancenumberYes> 0Balance at renewal in CAD
    currentRatePctnumberNo≥ 0.01, ≤ 25Rate on the expiring term, percent
    renewalRatePctnumberNo≥ 0.01, ≤ 25Rate offered at renewal, percent
    termYearsintegerNo≥ 1, ≤ 10New term length in years
    remainingAmortizationYearsintegerNo≥ 1, ≤ 40Amortization left at renewal, in years
    paymentFrequencystringNomonthly, biweekly, accelerated-biweekly, weekly, accelerated-weeklyHow often payments are made
    lumpSumAtRenewalnumberNo≥ 0Lump sum paid down at renewal in CAD

    See a live example of mortgage_renewal

    mortgage_qualifier

    How Much Mortgage Do I Qualify For (Canada)

    Maximum mortgage and home price at the OSFI qualifying rate. mode='income': from income, debts and down payment, limited by GDS 39% / TDS 44%. mode='budget': from a monthly payment you can afford. Property tax and heating are estimated.

    Input parameters for mortgage_qualifier
    ParameterTypeRequiredAllowed valuesDescription
    modestringNoincome, budgetQualify from income, or from a monthly payment budget
    annualIncomenumberNo≥ 0Income mode: main applicant gross annual income in CAD
    coApplicantIncomenumberNo≥ 0Income mode: co-applicant gross annual income in CAD
    monthlyDebtPaymentsnumberNo≥ 0Income mode: other monthly debt payments in CAD
    monthlyPaymentBudgetnumberNo≥ 0Budget mode: monthly mortgage payment you can afford in CAD
    annualInterestRatePctnumberNo≥ 0.01, ≤ 25Contract rate as a percent
    amortizationYearsanyNoAmortization: 5, 10, 15, 20, 25 or 30 years
    downPaymentnumberYes≥ 0Down payment available in CAD

    See a live example of mortgage_qualifier

    cmhc_insurance

    CMHC Mortgage Insurance Premium Calculator

    CMHC (mortgage default insurance) premium for any down payment under 20% on a Canadian home: premium rate and amount added to the mortgage, provincial sales tax on the premium (ON, QC, SK — paid in cash at closing), and the insured mortgage total.

    Input parameters for cmhc_insurance
    ParameterTypeRequiredAllowed valuesDescription
    homePricenumberYes> 0Purchase price in CAD
    downPaymentnumberYes≥ 0Down payment in CAD
    provincestringNoOntario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, Newfoundland and Labrador, Prince Edward IslandProvince, for sales tax on the premium
    firstTimeBuyerNewBuildbooleanNoFirst-time buyer buying a new build (30-year insured amortization)

    See a live example of cmhc_insurance

    second_home_affordability

    Second Home Affordability Calculator (Canada)

    Maximum price for a second property (cottage, rental or second home) while keeping your current home: combined TDS across both properties, subject-property GDS, minimum down payment (20% unless you'll live in it), optional rental income add-back.

    Input parameters for second_home_affordability
    ParameterTypeRequiredAllowed valuesDescription
    annualIncomenumberYes≥ 0Household gross annual income in CAD
    primaryMortgagePaymentnumberNo≥ 0Current home's monthly mortgage payment
    primaryPropertyTaxnumberNo≥ 0Current home's MONTHLY property tax
    primaryHeatingnumberNo≥ 0Current home's monthly heating cost
    otherDebtsnumberNo≥ 0Other monthly debt payments (cards, car, loans)
    intentstringNovacation, rental, personalCottage/vacation, rental/investment, or second personal home
    willOccupybooleanNoWill you live in it part-time? Allows CMHC Second Home (5%+ down). Ignored for rentals.
    purchasePricenumberYes> 0Second property purchase price in CAD
    downPaymentnumberYes≥ 0Down payment in CAD, or percent if downPaymentMode='percent'
    downPaymentModestringNodollar, percentdownPayment as dollars or percent of price
    interestRatePctnumberNo≥ 0, ≤ 25Annual interest rate as a percent, e.g. 4.49
    amortizationYearsnumberNo≥ 5, ≤ 30Amortization in years
    secondPropertyTaxAnnualnumberNo≥ 0Second property's ANNUAL property tax
    secondHeatingnumberNo≥ 0Second property's monthly heating cost
    condoFeesnumberNo≥ 0Second property's monthly condo fees (50% counted)
    borrowedEquityAmountnumberNo≥ 0HELOC/equity borrowed for this purchase, in CAD
    rentalIncomenumberNo≥ 0Expected monthly rent; 0 = no rental income counted
    rentalCreditModestringNo50, 80, fullLender rent treatment: 50% or 80% add-back, or full offset
    provincestringNoOntario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, Newfoundland and Labrador, Prince Edward IslandProvince of the second property

    See a live example of second_home_affordability

    debt_service_ratio

    GDS / TDS Debt Service Ratio Calculator

    Gross (GDS) and total (TDS) debt service ratios from income, housing costs and other debts, against the 39% / 44% limits. Condo fees count at 50%. Use the payment at the stress-test rate for a qualifying view.

    Input parameters for debt_service_ratio
    ParameterTypeRequiredAllowed valuesDescription
    annualIncomenumberYes≥ 0Applicant's gross annual income in CAD
    coApplicantIncomenumberNo≥ 0Co-applicant gross annual income in CAD (0 if none)
    mortgagePaymentnumberYes≥ 0Monthly mortgage principal + interest in CAD
    propertyTaxMonthlynumberNo≥ 0Monthly property tax in CAD
    heatingMonthlynumberNo≥ 0Monthly heating cost in CAD
    condoFeesMonthlynumberNo≥ 0Monthly condo fees in CAD (50% counted)
    otherDebtsMonthlynumberNo≥ 0Other monthly debt payments in CAD

    See a live example of debt_service_ratio

    debt_to_income

    Debt-to-Income (TDS) Calculator with Debt List

    TDS from income, housing costs and an itemised debt list. Credit cards and lines of credit with no payment given default to 3% of the balance; car and personal loans need their real payment. Returns total balance, payments, available credit and GDS/TDS vs 39% / 44%.

    Input parameters for debt_to_income
    ParameterTypeRequiredAllowed valuesDescription
    annualIncomenumberYes≥ 0Household gross annual income in CAD
    housingCostsMonthlynumberNo≥ 0Monthly housing costs: mortgage/rent, tax, heat, 50% condo
    debtsarrayNoEvery non-mortgage debt

    See a live example of debt_to_income

    reverse_mortgage

    Reverse Mortgage Calculator (Canada, 55+)

    Reverse mortgage (CHIP-style) for homeowners 55+: theoretical maximum (55% of value — the lender's published ceiling, not your approval), and how the balance compounds (semi-annually, no payments) vs home equity at 5/10/15/20 years.

    Input parameters for reverse_mortgage
    ParameterTypeRequiredAllowed valuesDescription
    homeValuenumberYes> 0Current/appraised home value in CAD
    ageintegerYes≥ 18, ≤ 120Youngest borrower's age (must be 55+)
    amountTakennumberYes≥ 0Amount you'd take in CAD (capped at the 55% ceiling)
    rateTermstringNovariable, 6mo, 1yr, 3yr, 5yrPosted CHIP rate term to use
    appreciationRatePctnumberNo≥ -10, ≤ 15Your own home appreciation assumption, %/yr

    See a live example of reverse_mortgage

    insured_insurable_uninsured

    Insured vs Insurable vs Uninsurable Mortgage Check

    Broker tool: classifies a mortgage as insured, insurable or uninsurable (purchase, renewal, switch, refinance) with reasons, then GDS/TDS in each category at its rate. Renewals depend on whether a premium was paid at origination.

    Input parameters for insured_insurable_uninsured
    ParameterTypeRequiredAllowed valuesDescription
    purposestringNopurchase, renewal, switch, refinanceWhat the mortgage is for
    homeValuenumberYes> 0Home value (or purchase price) in CAD
    mortgageAmountnumberYes> 0Mortgage amount / outstanding balance in CAD
    amortizationYearsnumberNo≥ 1, ≤ 40Amortization in years
    occupancystringNoowner, second, rentalOwner-occupied, second home, or rental
    unitsintegerNo≥ 1, ≤ 4Number of units (1–4)
    premiumPaidstringNoyes, no, unknownWas a borrower-paid insurance premium paid originally?
    fthbOrNewBuildbooleanNoFirst-time buyer or new construction (30-yr insured)
    equityTakeoutbooleanNoRefinance only: taking equity out / raising the loan
    annualIncomenumberNo≥ 0Household gross annual income in CAD (for GDS/TDS)
    monthlyDebtsnumberNo≥ 0Other monthly debt payments in CAD
    propertyTaxMonthlynumberNo≥ 0Monthly property tax in CAD
    heatingMonthlynumberNo≥ 0Monthly heating cost in CAD
    condoFeesMonthlynumberNo≥ 0Monthly condo fees in CAD (50% counted)
    qualifyingModestringNomqr, contractQualify at the stress-test rate or at the contract rate
    rateInsuredPctnumberNo≥ 0, ≤ 25Insured rate, % (illustrative default — pass the lender's)
    rateInsurablePctnumberNo≥ 0, ≤ 25Insurable rate, % (illustrative default)
    rateUninsurablePctnumberNo≥ 0, ≤ 25Uninsurable rate, % (illustrative default)

    See a live example of insured_insurable_uninsured

    closing_costs

    Closing Cost Calculator (Canada)

    Cash needed to close a Canadian home purchase in any province or territory: land transfer tax (with first-time-buyer rebates, Toronto MLTT, NRST), land title and mortgage registration fees (listed separately), CMHC premium + PST, legal/inspection/appraisal/moving allowances, new-build GST/HST.

    Input parameters for closing_costs
    ParameterTypeRequiredAllowed valuesDescription
    homePricenumberYes> 0Purchase price in CAD
    provincestringNoOntario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, YukonProvince or territory
    downPaymentPctnumberNo≥ 0, ≤ 100Down payment as a percent of price
    isFirstTimeBuyerbooleanNoFirst-time buyer (LTT rebates where they exist)
    isTorontobooleanNoOntario only: in the City of Toronto (adds MLTT)
    isForeignBuyerbooleanNoForeign buyer (Ontario NRST / Toronto MNRST)
    propertyTypestringNoexisting, newBuildResale or newly built
    occupancystringNoprimary, rentalNew builds: live in it or rent it out
    amortizationYearsnumberNo≥ 5, ≤ 30Amortization in years (30 adds the CMHC surcharge)
    legalFeesnumberNo≥ 0Legal fees allowance in CAD
    titleInsurancenumberNo≥ 0Title insurance in CAD
    homeInspectionnumberNo≥ 0Home inspection in CAD
    appraisalnumberNo≥ 0Appraisal in CAD
    movingCostsnumberNo≥ 0Moving costs in CAD
    propertyTaxAdjustmentnumberNo≥ 0Prepaid property tax reimbursed to the seller

    See a live example of closing_costs

    capital_cost_allowance

    Capital Cost Allowance (CCA) Calculator

    CRA capital cost allowance on a business or rental asset: class rate, year-1 CCA (half-year rule, AIIP or the post-2024 accelerated incentive, by acquisition date), tax saving at your marginal rate, a 5-year schedule, and recapture or terminal loss on disposal.

    Input parameters for capital_cost_allowance
    ParameterTypeRequiredAllowed valuesDescription
    assetCostnumberYes> 0Capital cost of the asset in CAD
    assetPresetstringNobuilding, equipment, computer, vehicle, clean-energy, customAsset type; 'custom' uses ccaClass
    ccaClassstringNoclass1, class3, class6, class8, class10, class10.1, class12, class16, class17, class43, class43.1, class43.2, class50, class53, class54, class55CCA class id (e.g. class8, class50), used when assetPreset='custom'
    acquisitionDatestringNoDate acquired, YYYY-MM-DD; omitted = half-year rule
    provincestringNoON, BC, AB, QC, MB, SK, NS, NB, PE, NL, NT, YT, NUProvince/territory code for the marginal tax rate, e.g. ON
    annualIncomenumberNo≥ 0Taxable income before CCA, for the marginal rate
    existingUCCnumberNo≥ 0Undepreciated capital cost already in the class; 0 for a new purchase
    disposalProceedsnumberNo≥ 0Proceeds if the asset is sold, for recapture or terminal loss
    disposalDatestringNoDate sold, YYYY-MM-DD, with disposalProceeds
    netRentalIncomeBeforeCCAnumberNoRental building only: net rental income before CCA (CCA can't create a rental loss)

    See a live example of capital_cost_allowance

    real_estate_commission

    Real Estate Commission Calculator (Canada)

    Seller's real estate commission in Canada: commission, GST/HST on it, listing vs buyer brokerage split, and net proceeds. Province sets commonly quoted starting rates (AB/BC tiered, ON/MB flat). Commission is NOT regulated — every rate is negotiable and can be overridden.

    Input parameters for real_estate_commission
    ParameterTypeRequiredAllowed valuesDescription
    salePricenumberYes> 0Sale price in CAD
    provincestringNoOntario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, YukonProvince or territory; sets the commonly quoted starting rates
    structurestringNotiered, flatOverride: tiered (e.g. 7% on first $100k) or flat % of the whole price
    tierThresholdnumberNo≥ 0Override, tiered only: price up to which the first-tier rate applies
    firstTierRatePctnumberNo≥ 0, ≤ 20Override, tiered only: percent on the first tier, e.g. 7
    remainderRatePctnumberNo≥ 0, ≤ 20Override: percent on the balance (tiered) or whole price (flat)
    salesTaxRatePctnumberNo≥ 0, ≤ 20Override: GST/HST percent charged on the commission
    buyerSideSharePctnumberNo≥ 0, ≤ 100Share of the commission paid to the buyer's brokerage, percent
    mortgageBalancenumberNo≥ 0Mortgage paid out at closing, for net proceeds
    legalFeesnumberNo≥ 0Seller's legal fees in CAD
    otherSellingCostsnumberNo≥ 0Other selling costs in CAD (staging, repairs)

    See a live example of real_estate_commission

    cost_of_selling

    Cost of Selling a House Calculator (Canada)

    Total cost of selling a Canadian home and what you walk away with: commission + GST/HST (province starting rates, all overridable), legal fees, mortgage discharge fee and other costs, then net proceeds after the mortgage is paid off.

    Input parameters for cost_of_selling
    ParameterTypeRequiredAllowed valuesDescription
    salePricenumberYes> 0Sale price in CAD
    remainingMortgagenumberNo≥ 0Mortgage balance paid out at closing
    legalFeesnumberNo≥ 0Seller's legal fees in CAD
    mortgageDischargeFeenumberNo≥ 0Lender's mortgage discharge fee in CAD
    otherCostsnumberNo≥ 0Other costs in CAD: staging, repairs, moving
    provincestringNoOntario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, YukonProvince or territory; sets the commonly quoted starting rates
    structurestringNotiered, flatOverride: tiered (e.g. 7% on first $100k) or flat % of the whole price
    tierThresholdnumberNo≥ 0Override, tiered only: price up to which the first-tier rate applies
    firstTierRatePctnumberNo≥ 0, ≤ 20Override, tiered only: percent on the first tier, e.g. 7
    remainderRatePctnumberNo≥ 0, ≤ 20Override: percent on the balance (tiered) or whole price (flat)
    salesTaxRatePctnumberNo≥ 0, ≤ 20Override: GST/HST percent charged on the commission
    buyerSideSharePctnumberNo≥ 0, ≤ 100Share of the commission paid to the buyer's brokerage, percent

    See a live example of cost_of_selling

    property_tax

    Property Tax Calculator (Canada)

    Annual and monthly property tax from ASSESSED value (not purchase price — Ontario still uses 2016 MPAC values) for 18 Canadian cities, each published rate normalised to full assessed value (SK taxes 80%, Winnipeg 45%). Pass ratePct instead of city to use the rate on your own bill.

    Input parameters for property_tax
    ParameterTypeRequiredAllowed valuesDescription
    assessedValuenumberYes> 0Assessed value in CAD, from the assessment notice
    citystringNoToronto, Ottawa, Hamilton, Mississauga, Brampton, London, Windsor, Vancouver, Victoria, Surrey, Calgary, Edmonton, Montréal, Québec City, Winnipeg, Saskatoon, Regina, HalifaxCity whose 2026 rate to use (exact name, e.g. Toronto, Montréal)
    ratePctnumberNo≥ 0, ≤ 10Your own rate as a percent of full assessed value; overrides the city rate
    includeQuebecSchoolTaxbooleanNoQuebec cities only: add the school tax (after its $25,000 exemption)

    See a live example of property_tax

    bc_rescission_period

    BC Home Buyer Rescission Period Calculator

    British Columbia's 3-business-day home buyer rescission period: the deadline (11:59 p.m. on the third business day after acceptance, skipping weekends and BC statutory holidays) and the 0.25% fee to rescind.

    Input parameters for bc_rescission_period
    ParameterTypeRequiredAllowed valuesDescription
    acceptanceDatestringYesDate the offer was accepted, YYYY-MM-DD
    purchasePricenumberYes> 0Accepted purchase price in CAD, for the 0.25% fee

    See a live example of bc_rescission_period

    seventy_percent_rule

    70% Rule Calculator (House Flipping)

    Maximum purchase price for a flip under the 70% rule (or the stricter 65%): ARV × rule − repairs, plus the profit left after repairs and the commission and closing costs on the sale.

    Input parameters for seventy_percent_rule
    ParameterTypeRequiredAllowed valuesDescription
    afterRepairValuenumberYes> 0Expected resale price after renovation (ARV) in CAD
    repairCostsnumberYes≥ 0Total renovation budget in CAD
    rulePctstringNo65, 70Rule to apply: 70% (standard) or 65% (stricter)
    commissionRatePctnumberNo≥ 0, ≤ 10Commission on the sale as a percent of ARV
    closingCostRatePctnumberNo≥ 0, ≤ 10Closing costs on the sale as a percent of ARV

    See a live example of seventy_percent_rule

    house_hacking

    House Hacking Calculator (Canada)

    Live in one unit and rent the rest (basement suite, duplex/triplex, rooms, ADU): mortgage with CMHC, ownership costs, rent after vacancy, your true monthly cost vs renting, and the income needed to qualify with and without rental add-back.

    Input parameters for house_hacking
    ParameterTypeRequiredAllowed valuesDescription
    purchasePricenumberYes> 0Purchase price in CAD
    mortgageRatePctnumberYes≥ 0, ≤ 25Annual mortgage rate as a percent, e.g. 4.5
    monthlyRentnumberYes≥ 0Total monthly rent from the rented part of the home in CAD
    downPaymentPctnumberNo≥ 0, ≤ 100Down payment as a percent of the price
    strategystringNobasement, duplex_triplex, room_rental, aduBasement suite, duplex/triplex, room rental, or ADU
    unitsintegerNo≥ 1, ≤ 4Units in a duplex/triplex (2-4); 3-4 units need 10% down
    amortizationYearsanyNoAmortization in years: 25 or 30
    provincestringNoOntario, British Columbia, Alberta, Quebec, Nova Scotia, Manitoba, Saskatchewan, New Brunswick, PEI, Newfoundland and LabradorProvince of the property
    propertyTaxRatePctnumberNo≥ 0, ≤ 5Annual property tax as a percent of value
    homeInsuranceAnnualnumberNo≥ 0Annual home insurance in CAD
    maintenanceMonthlynumberNo≥ 0Monthly maintenance allowance in CAD
    condoFeesMonthlynumberNo≥ 0Monthly condo or HOA fees in CAD
    vacancyRatePctnumberNo≥ 0, ≤ 25Vacancy allowance as a percent of rent
    rentalExpensesMonthlynumberNo≥ 0Monthly costs of renting it out in CAD
    includeRentalTaxbooleanNoDeduct a rough income-tax estimate on the rent
    marginalTaxRatePctnumberNo≥ 0, ≤ 60Marginal tax rate for the rental tax estimate
    equivalentRentMonthlynumberNo≥ 0Rent you'd pay for a similar home instead, in CAD

    See a live example of house_hacking

    renovation_roi

    Renovation ROI Calculator (Canada)

    Return on a home renovation: value added vs cost, and how that value shrinks by the time you sell (straight-line over the project's economic life — an editable HomeCalc assumption, not a measured figure), plus any net rent the work earns.

    Input parameters for renovation_roi
    ParameterTypeRequiredAllowed valuesDescription
    projectTypestringNoKitchen Renovation (Minor), Kitchen Renovation (Major), Bathroom Renovation, Basement Finishing, Deck / Patio Addition, Exterior Paint / Siding, Window Replacement, Roof Replacement, Landscaping, Custom / OtherRenovation type (sets the default value added and economic life)
    renovationCostnumberYes≥ 0Renovation cost in CAD
    currentHomeValuenumberNo≥ 0Home value before the renovation in CAD
    valueAddednumberNo≥ 0Value the work adds at completion in CAD; omit to use the type's estimate
    yearsUntilSalenumberNo≥ 0, ≤ 30Years between finishing the work and selling
    economicLifeYearsnumberNo> 0, ≤ 60Years until the work adds nothing; omit for the type's default
    monthlyNetRentnumberNo≥ 0Net monthly rent the work earns (e.g. a legal suite) in CAD

    See a live example of renovation_roi

    property_development

    Property Development Cost & Profit Calculator

    Development pro forma for a Canadian build: land + land transfer tax, hard costs, soft costs, HST net of the new-housing rebate, construction financing, contingency, sale proceeds, profit, margin and ROI.

    Input parameters for property_development
    ParameterTypeRequiredAllowed valuesDescription
    landPurchasePricenumberYes≥ 0Land price in CAD (0 if already owned, with ownsLand)
    grossFloorAreaSqftnumberYes> 0Gross floor area in square feet
    costPerSqftnumberYes≥ 0Construction cost per square foot in CAD
    estimatedSalePricenumberYes≥ 0Expected sale price when finished in CAD
    projectTypestringNonew-build, gut-renovation, addition, laneway, custom-home, multi-unitProject type (new builds and custom homes get the HST rebate)
    provincestringNoOntario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, Newfoundland, Northwest Territories, Nunavut, YukonProvince or territory of the project
    ownsLandbooleanNoLand is already owned (no purchase or land transfer tax)
    constructionMonthsnumberNo≥ 0, ≤ 60Construction duration in months
    sitePrepnumberNo≥ 0Site preparation cost in CAD
    landscapingnumberNo≥ 0Landscaping cost in CAD
    financingRatePctnumberNo≥ 0, ≤ 25Construction loan rate as a percent
    drawSchedulePctnumberNo≥ 0, ≤ 100Average share of costs drawn during the build, percent
    contingencyPctnumberNo≥ 0, ≤ 50Contingency as a percent of hard + soft costs
    sellingCommissionPctnumberNo≥ 0, ≤ 10Commission on the sale as a percent

    See a live example of property_development

    rent_vs_buy

    Rent vs Buy Calculator (Canada)

    Compare renting with buying over a time horizon: net cost and net wealth of each (home equity after selling vs the renter investing the down payment and monthly savings), the break-even year, and milestone years.

    Input parameters for rent_vs_buy
    ParameterTypeRequiredAllowed valuesDescription
    purchasePricenumberYes> 0Purchase price of the home in CAD
    monthlyRentnumberYes> 0Monthly rent for a comparable home in CAD
    downPaymentPctnumberNo≥ 0, ≤ 100Down payment as a percent of the price
    mortgageRatePctnumberNo≥ 0, ≤ 25Annual mortgage rate as a percent
    amortizationYearsnumberNo≥ 15, ≤ 30Amortization in years
    yearsToStayintegerNo≥ 1, ≤ 30How many years you plan to stay
    provincestringNoOntario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, Yukon, Newfoundland and LabradorProvince or territory; sets the land transfer tax
    citystringNoCity; Toronto adds municipal LTT, Montreal uses its own welcome-tax brackets
    landTransferTaxnumberNo≥ 0Your own land transfer tax figure in CAD, replacing the computed one
    isFirstTimeBuyerbooleanNoEligible for the first-time buyer land transfer tax rebate
    propertyTaxRatePctnumberNo≥ 0, ≤ 5Annual property tax as a percent of value
    condoFeesMonthlynumberNo≥ 0Monthly condo fees in CAD
    maintenanceMonthlynumberNo≥ 0Monthly maintenance and repairs in CAD
    homeInsuranceAnnualnumberNo≥ 0Annual home insurance in CAD
    rentGrowthPctnumberNo≥ 0, ≤ 20Yearly rent increase as a percent
    homePriceGrowthPctnumberNo≥ -10, ≤ 20Yearly home price growth as a percent
    investmentReturnPctnumberNo≥ 0, ≤ 30Yearly return the renter earns on invested savings
    sellingCostPctnumberNo≥ 0, ≤ 15Cost of selling as a percent of the sale price

    See a live example of rent_vs_buy

    Live examples

    One call per tool. Each shows the params of the tools/call request and the structuredContent of the result. The result’s content[0].text carries the same JSON as text.

    mortgage_payment

    Monthly payment on a $650,000 home with 10% down at 5.25%, 25-year amortization.

    params

    {
      "name": "mortgage_payment",
      "arguments": {
        "homePrice": 650000,
        "downPayment": 65000,
        "annualInterestRatePct": 5.25,
        "amortizationYears": 25
      }
    }

    result.structuredContent

    {
      "basis": "homePrice",
      "monthlyPayment": 3594.19,
      "paymentAmount": 3594.19,
      "paymentLabel": "Monthly",
      "mortgagePrincipal": 585000,
      "downPaymentAmount": 65000,
      "downPaymentPercent": 10,
      "cmhcRequired": true,
      "cmhcInsurancePremium": 18135,
      "cmhcInsuranceRate": 0.031,
      "source": "https://homecalc.ca/tools/mortgage-payment-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    minimum_down_payment

    Minimum down payment on an $850,000 home.

    params

    {
      "name": "minimum_down_payment",
      "arguments": {
        "homePrice": 850000
      }
    }

    result.structuredContent

    {
      "homePrice": 850000,
      "minimumDownPayment": 60000,
      "minimumDownPercent": 7.1,
      "cmhcInsurable": true,
      "cmhcPremiumRatePercent": 4,
      "source": "https://homecalc.ca/tools/down-payment-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    land_transfer_tax

    Land transfer tax on a $1,200,000 purchase in the City of Toronto.

    params

    {
      "name": "land_transfer_tax",
      "arguments": {
        "price": 1200000,
        "province": "Ontario",
        "inToronto": true,
        "isFirstTimeBuyer": false
      }
    }

    result.structuredContent

    {
      "province": "Ontario",
      "provincialLandTransferTax": 20475,
      "torontoMunicipalLandTransferTax": 20475,
      "firstTimeBuyerRebate": 0,
      "totalLandTransferTax": 40950,
      "transferRegistrationFee": 86.42,
      "totalDueAtRegistration": 41036.42,
      "note": null,
      "source": "https://homecalc.ca/tools/land-transfer-tax-calculator/toronto",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    income_tax

    Income tax and take-home pay on $95,000 of employment income in Ontario.

    Developer note: provincialTax already includes the Ontario surtax and the Ontario Health Premium. ontarioSurtax and ontarioHealthPremium are a breakdown of that total — do not add them again.

    params

    {
      "name": "income_tax",
      "arguments": {
        "annualIncome": 95000,
        "province": "Ontario"
      }
    }

    result.structuredContent

    {
      "grossIncome": 95000,
      "federalTax": 12276.5972,
      "provincialTax": 6239.4567400000005,
      "ontarioSurtax": 0,
      "ontarioHealthPremium": 750,
      "cpp": 4646.45,
      "ei": 1123.07,
      "qpip": 0,
      "totalDeductions": 24285.573940000002,
      "netPay": 70714.42606,
      "effectiveRatePercent": 25.6,
      "marginalRatePercent": 29.7,
      "source": "https://homecalc.ca/tools/income-tax-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    mortgage_penalty

    Penalty to break a $400,000 fixed mortgage at 4.5% with 30 months left (big-bank posted-rate IRD).

    params

    {
      "name": "mortgage_penalty",
      "arguments": {
        "balance": 400000,
        "rateType": "fixed",
        "contractRatePct": 4.5,
        "monthsRemaining": 30,
        "lenderMethod": "big-bank",
        "currentRateForRemainingTermPct": 4.29,
        "postedAtOriginationPct": 6.49,
        "todaysPostedForClosestTermPct": 5.79
      }
    }

    result.structuredContent

    {
      "applicablePenalty": 7000,
      "applicableMethod": "posted-rate-ird",
      "threeMonthInterest": 4500,
      "irdStandardMethod": 2100,
      "irdPostedRateMethod": 7000,
      "assumedInputs": {},
      "estimateOnly": false,
      "source": "https://homecalc.ca/tools/mortgage-penalty-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    bc_home_flipping_tax

    BC home flipping tax on a $120,000 gain from a property held 300 days.

    params

    {
      "name": "bc_home_flipping_tax",
      "arguments": {
        "taxableIncome": 120000,
        "daysHeld": 300,
        "isPrimaryResidence": false
      }
    }

    result.structuredContent

    {
      "applies": true,
      "taxRatePercent": 20,
      "primaryResidenceDeduction": 0,
      "netTaxableIncome": 120000,
      "taxOwing": 24000,
      "note": null,
      "source": "https://homecalc.ca/tools/house-flip-tax-calculator/bc",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    rent_increase

    Maximum 2026 guideline increase on $2,000/month rent in Ontario.

    params

    {
      "name": "rent_increase",
      "arguments": {
        "currentRent": 2000,
        "province": "Ontario",
        "year": "2026"
      }
    }

    result.structuredContent

    {
      "province": "Ontario",
      "year": "2026",
      "capped": true,
      "exemption": "none",
      "guidelinePercent": 2.1,
      "publishedGuidelinePercent": 2.1,
      "increaseAmount": 42,
      "newRent": 2042,
      "availableYears": [
        "2024",
        "2025",
        "2026",
        "2027"
      ],
      "note": null,
      "source": "https://homecalc.ca/tools/rent-increase-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    capital_gains_tax

    Capital gains tax on selling a property that is not a principal residence, bought for $600,000 and sold for $900,000 in Ontario.

    params

    {
      "name": "capital_gains_tax",
      "arguments": {
        "salePrice": 900000,
        "purchasePrice": 600000,
        "province": "Ontario",
        "annualIncome": 100000,
        "assetType": "real-estate",
        "sellingCosts": 40000,
        "taxYear": 2026
      }
    }

    result.structuredContent

    {
      "netProceeds": 860000,
      "adjustedCostBase": 600000,
      "capitalGain": 260000,
      "isLoss": false,
      "exemptAmount": 0,
      "lcgeApplied": 0,
      "lossesApplied": 0,
      "gainAfterExemptions": 260000,
      "inclusionRatePercent": 50,
      "taxableCapitalGain": 130000,
      "federalTaxOnGain": 34319,
      "provincialTaxOnGain": 15252,
      "estimatedTax": 49571,
      "ccaRecapture": 0,
      "taxOnRecapture": 0,
      "netAfterTax": 810429,
      "effectiveRateOnGainPercent": 19.1,
      "marginalRatePercent": 42.2,
      "isFullExemption": false,
      "source": "https://homecalc.ca/tools/capital-gains-tax-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    heloc_second_mortgage

    Can a homeowner borrow $75,000 against a $900,000 home with $450,000 owing?

    params

    {
      "name": "heloc_second_mortgage",
      "arguments": {
        "homeValue": 900000,
        "outstandingFirstMortgage": 450000,
        "amountToBorrow": 75000,
        "annualHouseholdIncome": 160000,
        "province": "Ontario",
        "helocPrimeRatePct": 4.95,
        "helocSpreadPct": 0.5,
        "secondMortgageRatePct": 7.5
      }
    }

    result.structuredContent

    {
      "homeValue": 900000,
      "currentEquity": 450000,
      "currentLtvPercent": 50,
      "heloc": {
        "maxAvailable": 270000,
        "requestFits": true,
        "effectiveRatePercent": 5.45,
        "revolvingPortion": 75000,
        "termPortion": 0,
        "monthlyInterestOnlyPayment": 340.63,
        "monthlyBlendedPayment": 340.63,
        "stressTestRatePercent": 7.45,
        "stressTestMonthlyPayment": 465.63,
        "tdsRatioPercent": 33.25,
        "tdsQualifies": true,
        "combinedLtvPercent": 58.33
      },
      "secondMortgage": {
        "lenderTier": "A",
        "maxAvailable": 270000,
        "requestFits": true,
        "ratePercent": 7.5,
        "monthlyPayment": 548.67,
        "totalInterestPaid": 89599.86,
        "amortizationYears": 25,
        "balanceAtEndOfTerm": 73918.97,
        "tdsRatioPercent": 34.6,
        "tdsQualifies": true,
        "combinedLtvPercent": 58.33
      },
      "maxAvailableByLenderTier": {
        "A": 270000,
        "B": 270000,
        "Private": 360000
      },
      "baseGdsRatioPercent": 29.76,
      "baseTdsRatioPercent": 29.76,
      "estimatedMonthlyPropertyTax": 750,
      "source": "https://homecalc.ca/tools/heloc-second-mortgage-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    mortgage_affordability

    Maximum purchase price on $120,000 income with $100,000 down at 4.5%.

    params

    {
      "name": "mortgage_affordability",
      "arguments": {
        "annualIncome": 120000,
        "downPayment": 100000,
        "interestRatePct": 4.5,
        "amortizationYears": 25,
        "province": "Ontario"
      }
    }

    result.structuredContent

    {
      "maxHomePrice": 582878,
      "maxMortgage": 496398.58,
      "monthlyPayment": 2747.43,
      "totalMonthlyHousing": 3322.43,
      "stressTestRatePercent": 6.5,
      "gdsRatioPercent": 39,
      "tdsRatioPercent": 39,
      "downPaymentAmount": 100000,
      "downPaymentPercent": 17.16,
      "minimumDownPaymentRequired": 33287.8,
      "downPaymentBelowMinimum": false,
      "cmhcRequired": true,
      "cmhcPremium": 13520.58,
      "cmhcPremiumRatePercent": 2.8,
      "cmhcNotAvailable": false,
      "amortizationWarning": false,
      "source": "https://homecalc.ca/tools/mortgage-affordability-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    cap_rate

    Cap rate on a $600,000 rental renting for $3,200/month with $9,000 of annual expenses.

    params

    {
      "name": "cap_rate",
      "arguments": {
        "purchasePrice": 600000,
        "monthlyGrossRent": 3200,
        "annualOperatingExpenses": 9000,
        "downPayment": 120000,
        "interestRatePct": 5,
        "amortizationYears": 25
      }
    }

    result.structuredContent

    {
      "capRatePercent": 4.58,
      "netOperatingIncome": 27480,
      "grossRentalIncome": 38400,
      "vacancyLoss": 1920,
      "effectiveGrossIncome": 36480,
      "operatingExpenses": 9000,
      "grossRentMultiplier": 15.63,
      "expenseRatioPercent": 24.67,
      "mortgagePrincipal": 480000,
      "monthlyMortgagePayment": 2791.7,
      "annualDebtService": 33500.45,
      "annualCashFlow": -6020.45,
      "cashInvested": 120000,
      "cashOnCashReturnPercent": -5.02,
      "benchmark": {
        "market": "Your Market",
        "typicalRangePercent": {
          "low": 3.75,
          "high": 5.75
        },
        "position": "lower-typical",
        "message": "This cap rate is within the typical range for Your Market — a reasonable deal if appreciation potential is strong."
      },
      "warnings": [],
      "source": "https://homecalc.ca/tools/cap-rate-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    house_flipping

    Profit on a flip bought for $500,000, renovated for $60,000 and resold for $650,000 after 6 months.

    params

    {
      "name": "house_flipping",
      "arguments": {
        "purchasePrice": 500000,
        "afterRepairValue": 650000,
        "renovationCost": 60000,
        "province": "Ontario",
        "holdingPeriodMonths": 6,
        "monthlyHoldingCosts": 2500,
        "marginalTaxRatePct": 43.41
      }
    }

    result.structuredContent

    {
      "provincialLandTransferTax": 6475,
      "torontoMunicipalLandTransferTax": 0,
      "firstTimeBuyerRebate": 0,
      "totalLandTransferTax": 6475,
      "renovationWithContingency": 69000,
      "holdingCosts": 15000,
      "realtorCommission": 32500,
      "totalCosts": 622975,
      "grossProfit": 27025,
      "craFlippingRuleApplies": true,
      "taxableAmount": 27025,
      "estimatedTax": 11732,
      "netProfit": 15293,
      "roiPercent": 2.7,
      "breakEvenSalePrice": 634707,
      "monthsToCapitalGainsTreatment": 6,
      "taxSavingIfHeldPast12Months": 6000,
      "source": "https://homecalc.ca/tools/house-flipping-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    mortgage_amortization

    Amortization on a $480,000 mortgage at 4.5% over 25 years, year by year.

    params

    {
      "name": "mortgage_amortization",
      "arguments": {
        "principal": 480000,
        "annualInterestRatePct": 4.5
      }
    }

    result.structuredContent

    {
      "paymentAmount": 2656.67,
      "paymentLabel": "Monthly",
      "totalInterest": 317001.05,
      "totalCost": 797001.05,
      "balanceAtEndOfTerm": 421422.66,
      "payoffYears": 25,
      "yearly": [
        {
          "year": 1,
          "principal": 10696.62,
          "interest": 21183.42,
          "balance": 469303.38
        },
        {
          "year": 2,
          "principal": 11183.39,
          "interest": 20696.66,
          "balance": 458119.99
        },
        {
          "year": 3,
          "principal": 11692.3,
          "interest": 20187.74,
          "balance": 446427.69
        },
        {
          "year": 4,
          "principal": 12224.37,
          "interest": 19655.67,
          "balance": 434203.32
        },
        {
          "year": 5,
          "principal": 12780.66,
          "interest": 19099.38,
          "balance": 421422.66
        },
        {
          "year": 6,
          "principal": 13362.26,
          "interest": 18517.78,
          "balance": 408060.4
        },
        {
          "year": 7,
          "principal": 13970.32,
          "interest": 17909.72,
          "balance": 394090.08
        },
        {
          "year": 8,
          "principal": 14606.06,
          "interest": 17273.98,
          "balance": 379484.02
        },
        {
          "year": 9,
          "principal": 15270.73,
          "interest": 16609.31,
          "balance": 364213.29
        },
        {
          "year": 10,
          "principal": 15965.64,
          "interest": 15914.4,
          "balance": 348247.65
        },
        {
          "year": 11,
          "principal": 16692.18,
          "interest": 15187.86,
          "balance": 331555.47
        },
        {
          "year": 12,
          "principal": 17451.78,
          "interest": 14428.27,
          "balance": 314103.69
        },
        {
          "year": 13,
          "principal": 18245.94,
          "interest": 13634.1,
          "balance": 295857.75
        },
        {
          "year": 14,
          "principal": 19076.25,
          "interest": 12803.8,
          "balance": 276781.51
        },
        {
          "year": 15,
          "principal": 19944.33,
          "interest": 11935.71,
          "balance": 256837.17
        },
        {
          "year": 16,
          "principal": 20851.93,
          "interest": 11028.12,
          "balance": 235985.24
        },
        {
          "year": 17,
          "principal": 21800.82,
          "interest": 10079.22,
          "balance": 214184.43
        },
        {
          "year": 18,
          "principal": 22792.89,
          "interest": 9087.15,
          "balance": 191391.53
        },
        {
          "year": 19,
          "principal": 23830.11,
          "interest": 8049.93,
          "balance": 167561.42
        },
        {
          "year": 20,
          "principal": 24914.53,
          "interest": 6965.51,
          "balance": 142646.89
        },
        {
          "year": 21,
          "principal": 26048.3,
          "interest": 5831.74,
          "balance": 116598.59
        },
        {
          "year": 22,
          "principal": 27233.66,
          "interest": 4646.38,
          "balance": 89364.93
        },
        {
          "year": 23,
          "principal": 28472.96,
          "interest": 3407.08,
          "balance": 60891.97
        },
        {
          "year": 24,
          "principal": 29768.66,
          "interest": 2111.38,
          "balance": 31123.32
        },
        {
          "year": 25,
          "principal": 31123.32,
          "interest": 756.72,
          "balance": 0
        }
      ],
      "source": "https://homecalc.ca/tools/mortgage-amortization-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    mortgage_stress_test

    Does $100,000 of income pass the stress test on a $400,000 home with $40,000 down at 4.5%?

    params

    {
      "name": "mortgage_stress_test",
      "arguments": {
        "annualIncome": 100000,
        "homePrice": 400000,
        "downPayment": 40000,
        "contractRatePct": 4.5
      }
    }

    result.structuredContent

    {
      "scenario": "purchase",
      "stressTestApplied": true,
      "qualifyingRatePercent": 6.5,
      "mortgageAmount": 360000,
      "cmhcRequired": true,
      "cmhcPremium": 11160,
      "paymentAtContractRate": 2054.27,
      "paymentAtQualifyingRate": 2486.12,
      "gdsPercent": 35.83,
      "tdsPercent": 35.83,
      "gdsLimitPercent": 39,
      "tdsLimitPercent": 44,
      "qualifies": true,
      "verdict": "pass",
      "maxHomePrice": 434765.13,
      "maxMortgage": 394765.13,
      "extraPriceAt30YearAmortization": 26554.35,
      "source": "https://homecalc.ca/tools/mortgage-stress-test-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    mortgage_prepayment

    Interest saved by paying $500 extra each payment on a $400,000 mortgage at 4.5%.

    params

    {
      "name": "mortgage_prepayment",
      "arguments": {
        "balance": 400000,
        "annualInterestRatePct": 4.5,
        "extraPerPayment": 500
      }
    }

    result.structuredContent

    {
      "regularPayment": 2213.89,
      "totalInterestWithoutPrepayment": 264167.55,
      "totalInterestWithPrepayment": 180468.94,
      "interestSaved": 83698.61,
      "payoffMonthsWithout": 300,
      "payoffMonthsWith": 214,
      "timeSaved": {
        "years": 7,
        "months": 2
      },
      "penaltyIfOverPrivilege": {
        "amount": 12000,
        "method": "IRD"
      },
      "note": "Most lenders allow 10–20% of the original balance per year penalty-free; the penalty applies only to amounts over your privilege.",
      "source": "https://homecalc.ca/tools/mortgage-prepayment-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    mortgage_renewal

    Payment change renewing a $350,000 balance from 2.5% to 4.5%.

    params

    {
      "name": "mortgage_renewal",
      "arguments": {
        "balance": 350000,
        "currentRatePct": 2.5,
        "renewalRatePct": 4.5
      }
    }

    result.structuredContent

    {
      "currentPayment": 1852.46,
      "renewalPayment": 2206.42,
      "monthlyEquivalentCurrent": 1852.46,
      "monthlyEquivalentRenewal": 2206.42,
      "monthlyChange": 353.96,
      "annualChange": 4247.53,
      "termInterestAtRenewalRate": 71611.76,
      "extraInterestThisTerm": 32393.13,
      "balanceAtEndOfNewTerm": 289226.68,
      "source": "https://homecalc.ca/tools/mortgage-renewal-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    mortgage_qualifier

    How much mortgage $90,000 of income qualifies for, with $300/month of debts and $100,000 down, at 4.5%.

    params

    {
      "name": "mortgage_qualifier",
      "arguments": {
        "annualIncome": 90000,
        "monthlyDebtPayments": 300,
        "downPayment": 100000,
        "annualInterestRatePct": 4.5
      }
    }

    result.structuredContent

    {
      "maxMortgage": 347482,
      "maxHomePrice": 447482,
      "estimatedMonthlyPayment": 1923.22,
      "qualifyingRatePercent": 6.5,
      "gdsPercent": 39,
      "tdsPercent": 43,
      "bindingConstraint": "GDS",
      "cmhcRequired": false,
      "cmhcPremium": 0,
      "caution": "This is the most a lender may allow; it is above 4.5× income ($405,000) or a TDS over 38%, which can be a stretch.",
      "source": "https://homecalc.ca/tools/mortgage-qualifier-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    cmhc_insurance

    CMHC premium on a $600,000 home with $60,000 down.

    params

    {
      "name": "cmhc_insurance",
      "arguments": {
        "homePrice": 600000,
        "downPayment": 60000
      }
    }

    result.structuredContent

    {
      "downPaymentPercent": 10,
      "cmhcRequired": true,
      "premiumRatePercent": 3.1,
      "premium": 16740,
      "premiumSalesTax": 1339.2,
      "mortgageBeforeInsurance": 540000,
      "insuredMortgage": 556740,
      "source": "https://homecalc.ca/tools/cmhc-insurance-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    second_home_affordability

    Can a household earning $160,000 carry a $500,000 second home with $100,000 down at 4.49%?

    params

    {
      "name": "second_home_affordability",
      "arguments": {
        "annualIncome": 160000,
        "purchasePrice": 500000,
        "downPayment": 100000,
        "interestRatePct": 4.49
      }
    }

    result.structuredContent

    {
      "maxSecondHomePrice": 394640,
      "qualifiesAtThisPrice": false,
      "mortgageAmount": 400000,
      "monthlyPayment": 2211.67,
      "stressTestRatePercent": 6.49,
      "subjectPropertyGdsPercent": 23.83,
      "combinedTdsPercent": 48.39,
      "downPaymentAmount": 100000,
      "downPaymentPercent": 20,
      "minimumDownPaymentPercent": 20,
      "downPaymentBelowMinimum": false,
      "incomeRequiredToQualify": 175960.11,
      "rentalIncomeCreditMonthly": 0,
      "note": "Estimate at standard A-lender limits (GDS 39% / TDS 44%), not an approval — a lender or broker confirms what counts.",
      "source": "https://homecalc.ca/tools/second-home-affordability-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    debt_service_ratio

    GDS and TDS on $120,000 of income with a $2,400 mortgage payment and $400 of other debts.

    params

    {
      "name": "debt_service_ratio",
      "arguments": {
        "annualIncome": 120000,
        "mortgagePayment": 2400,
        "otherDebtsMonthly": 400
      }
    }

    result.structuredContent

    {
      "grossMonthlyIncome": 10000,
      "housingCostsMonthly": 2850,
      "totalDebtServiceMonthly": 3250,
      "gdsPercent": 28.5,
      "tdsPercent": 32.5,
      "gdsLimitPercent": 39,
      "tdsLimitPercent": 44,
      "gdsWithinLimit": true,
      "tdsWithinLimit": true,
      "withinBothLimits": true,
      "note": "Estimate at standard A-lender limits (GDS 39% / TDS 44%), not an approval — a lender or broker confirms what counts.",
      "source": "https://homecalc.ca/tools/debt-service-ratio-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    debt_to_income

    Debt ratios with a $4,000 credit card balance and an $18,000 car loan on $90,000 of income.

    params

    {
      "name": "debt_to_income",
      "arguments": {
        "annualIncome": 90000,
        "housingCostsMonthly": 2000,
        "debts": [
          {
            "type": "credit-card",
            "balance": 4000,
            "limit": 10000
          },
          {
            "type": "car-loan",
            "balance": 18000,
            "monthlyPayment": 450
          }
        ]
      }
    }

    result.structuredContent

    {
      "totalDebtBalance": 22000,
      "totalDebtPaymentsMonthly": 570,
      "totalAvailableCredit": 6000,
      "gdsPercent": 26.67,
      "tdsPercent": 34.27,
      "gdsLimitPercent": 39,
      "tdsLimitPercent": 44,
      "withinBothLimits": true,
      "note": "Estimate at standard A-lender limits (GDS 39% / TDS 44%), not an approval — a lender or broker confirms what counts.",
      "source": "https://homecalc.ca/tools/debt-to-income-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    reverse_mortgage

    A 65-year-old taking $150,000 as a reverse mortgage on a $700,000 home.

    params

    {
      "name": "reverse_mortgage",
      "arguments": {
        "homeValue": 700000,
        "age": 65,
        "amountTaken": 150000
      }
    }

    result.structuredContent

    {
      "maxTheoreticalAmount": 385000,
      "amountUsed": 150000,
      "amountWasCapped": false,
      "annualRatePercent": 7.09,
      "effectiveAnnualRatePercent": 7.22,
      "closingCost": 1795,
      "appreciationRatePercent": 0,
      "projections": [
        {
          "year": 5,
          "loanBalance": 212511.57,
          "projectedHomeValue": 700000,
          "remainingEquity": 487488.43,
          "noNegativeEquityGuaranteeApplies": false
        },
        {
          "year": 10,
          "loanBalance": 301074.45,
          "projectedHomeValue": 700000,
          "remainingEquity": 398925.55,
          "noNegativeEquityGuaranteeApplies": false
        },
        {
          "year": 15,
          "loanBalance": 426545.37,
          "projectedHomeValue": 700000,
          "remainingEquity": 273454.63,
          "noNegativeEquityGuaranteeApplies": false
        },
        {
          "year": 20,
          "loanBalance": 604305.51,
          "projectedHomeValue": 700000,
          "remainingEquity": 95694.49,
          "noNegativeEquityGuaranteeApplies": false
        }
      ],
      "note": "55% of value is the lender's published theoretical ceiling, not a personalized approval — the amount you're approved for depends on age, property and location; ask the lender for your number.",
      "source": "https://homecalc.ca/tools/reverse-mortgage-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    insured_insurable_uninsured

    Is a $480,000 renewal on a $700,000 home insured, insurable or uninsured?

    params

    {
      "name": "insured_insurable_uninsured",
      "arguments": {
        "purpose": "renewal",
        "homeValue": 700000,
        "mortgageAmount": 480000,
        "premiumPaid": "no",
        "annualIncome": 120000
      }
    }

    result.structuredContent

    {
      "classification": "insurable",
      "confidence": "likely",
      "label": "Likely low-ratio insurable",
      "reasons": [
        "No borrower-paid premium, but the original terms (20%+ down, under $1M, ≤25y, owner-occupied) meet low-ratio insurable criteria — the lender may have portfolio-insured it, or it's insurable-but-uninsured."
      ],
      "currentLtvPercent": 68.6,
      "qualificationByCategory": [
        {
          "category": "insured",
          "ratePercent": 4.29,
          "qualifyingRatePct": 6.29,
          "payment": 3154.3,
          "gds": 37.3,
          "tds": 37.3,
          "gdsPass": true,
          "tdsPass": true,
          "pass": true
        },
        {
          "category": "insurable",
          "ratePercent": 4.59,
          "qualifyingRatePct": 6.59,
          "payment": 3241.39,
          "gds": 38.2,
          "tds": 38.2,
          "gdsPass": true,
          "tdsPass": true,
          "pass": true
        },
        {
          "category": "uninsurable",
          "ratePercent": 4.99,
          "qualifyingRatePct": 6.99,
          "payment": 3359.03,
          "gds": 39.3,
          "tds": 39.3,
          "gdsPass": false,
          "tdsPass": true,
          "pass": false
        }
      ],
      "note": "A graded classification, not a regulatory determination — confirm the insurer and certificate with the lender. Estimate at standard A-lender limits (GDS 39% / TDS 44%), not an approval — a lender or broker confirms what counts.",
      "source": "https://homecalc.ca/tools/insured-insurable-uninsured-comparison",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    closing_costs

    Closing costs for a first-time buyer on a $600,000 Ontario home with 10% down.

    params

    {
      "name": "closing_costs",
      "arguments": {
        "homePrice": 600000,
        "province": "Ontario",
        "downPaymentPct": 10,
        "isFirstTimeBuyer": true
      }
    }

    result.structuredContent

    {
      "province": "Ontario",
      "downPayment": 60000,
      "mortgage": 540000,
      "landTransferTaxLabel": "Ontario Land Transfer Tax",
      "provincialLandTransferTaxBeforeRelief": 8475,
      "torontoMunicipalLandTransferTaxBeforeRelief": 0,
      "landTransferTaxRelief": 4000,
      "provincialLandTransferTaxPayable": 4475,
      "torontoMunicipalLandTransferTaxPayable": 0,
      "nonResidentSpeculationTax": 0,
      "torontoAdminFee": 0,
      "landTitleRegistrationFee": 86.42,
      "mortgageRegistrationFee": 86.42,
      "registrationFeesNotIncluded": false,
      "cmhcPremiumAddedToMortgage": 16740,
      "pstOnCmhcPremium": 1339.2,
      "legalFees": 2000,
      "titleInsurance": 400,
      "homeInspection": 500,
      "appraisal": 350,
      "movingCosts": 2000,
      "propertyTaxAdjustment": 0,
      "newBuildHstAtClosing": 0,
      "firstTimeBuyerGstRebate": 0,
      "totalClosingCosts": 11237.04,
      "totalCashNeeded": 71237.04,
      "notes": [
        "The CMHC premium is added to the mortgage, not paid in cash; its provincial sales tax (ON, QC, SK) is paid at closing.",
        "Some lawyers bill the registration fees as disbursements on their invoice — don't count them twice."
      ],
      "source": "https://homecalc.ca/tools/closing-cost-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    capital_cost_allowance

    CCA on a $400,000 rental building bought in March 2026 in Ontario.

    params

    {
      "name": "capital_cost_allowance",
      "arguments": {
        "assetCost": 400000,
        "assetPreset": "building",
        "acquisitionDate": "2026-03-01",
        "province": "ON",
        "annualIncome": 120000
      }
    }

    result.structuredContent

    {
      "ccaClass": "Class 1 — 4%",
      "ccaRatePercent": 4,
      "costBaseUsed": 400000,
      "class10_1CapApplied": false,
      "year1Rule": "Reaccelerated Investment Incentive Property (RIIP) — enhanced first-year deduction (half-year suspended)",
      "year1CCA": 24000,
      "year1TaxSavings": 8918,
      "uccAfterYear1": 376000,
      "fiveYearTotalCCA": 80645,
      "marginalRatePercent": 37.2,
      "rentalLossCapApplied": false,
      "schedule": [
        {
          "year": 1,
          "openingUCC": 400000,
          "ccaDeduction": 24000,
          "taxSavings": 8918,
          "closingUCC": 376000
        },
        {
          "year": 2,
          "openingUCC": 376000,
          "ccaDeduction": 15040,
          "taxSavings": 5589,
          "closingUCC": 360960
        },
        {
          "year": 3,
          "openingUCC": 360960,
          "ccaDeduction": 14438,
          "taxSavings": 5365,
          "closingUCC": 346522
        },
        {
          "year": 4,
          "openingUCC": 346522,
          "ccaDeduction": 13861,
          "taxSavings": 5151,
          "closingUCC": 332661
        },
        {
          "year": 5,
          "openingUCC": 332661,
          "ccaDeduction": 13306,
          "taxSavings": 4945,
          "closingUCC": 319354
        }
      ],
      "source": "https://homecalc.ca/tools/capital-cost-allowance-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    real_estate_commission

    Commission on a $750,000 sale in Ontario.

    params

    {
      "name": "real_estate_commission",
      "arguments": {
        "salePrice": 750000,
        "province": "Ontario"
      }
    }

    result.structuredContent

    {
      "province": "Ontario",
      "structure": "flat",
      "ratesUsed": {
        "remainderRatePercent": 5,
        "salesTaxRatePercent": 13,
        "salesTaxLabel": "HST"
      },
      "commissionBeforeTax": 37500,
      "salesTax": 4875,
      "totalCommission": 42375,
      "effectiveRatePercent": 5.65,
      "listingSideBeforeTax": 18750,
      "buyerSideBeforeTax": 18750,
      "otherCosts": 1500,
      "netProceeds": 706125,
      "provinceNote": "Ontario is usually quoted as one percentage of the whole price — commonly 5%, split about evenly between the two brokerages — plus 13% HST.",
      "note": "Commission is not regulated in Canada — these are commonly quoted starting points, not set rates. Replace them with what your agent quotes.",
      "source": "https://homecalc.ca/tools/real-estate-commission-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    cost_of_selling

    Net proceeds selling an $800,000 Ontario home with $300,000 left on the mortgage.

    params

    {
      "name": "cost_of_selling",
      "arguments": {
        "salePrice": 800000,
        "province": "Ontario",
        "remainingMortgage": 300000
      }
    }

    result.structuredContent

    {
      "province": "Ontario",
      "structure": "flat",
      "commissionBeforeTax": 40000,
      "salesTaxOnCommission": 5200,
      "salesTaxLabel": "HST",
      "totalCommission": 45200,
      "commissionEffectiveRatePercent": 5.65,
      "legalFees": 1500,
      "mortgageDischargeFee": 300,
      "otherCosts": 2000,
      "totalSellingCosts": 49000,
      "remainingMortgage": 300000,
      "netProceeds": 451000,
      "note": "Commission is not regulated in Canada — these are commonly quoted starting points, not set rates. Replace them with what your agent quotes.",
      "source": "https://homecalc.ca/tools/cost-of-selling-a-house-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    property_tax

    Property tax on a $700,000 assessment in Toronto.

    params

    {
      "name": "property_tax",
      "arguments": {
        "assessedValue": 700000,
        "city": "Toronto"
      }
    }

    result.structuredContent

    {
      "city": "Toronto",
      "province": "Ontario",
      "rateYear": 2026,
      "rateUsedPercent": 0.767311,
      "rateSource": "city's published rate, normalised to full assessed value",
      "baseTax": 5371.18,
      "fixedCharges": 0,
      "quebecSchoolTax": 0,
      "annualTax": 5371.18,
      "monthlyTax": 447.6,
      "effectiveRatePercent": 0.767,
      "note": "Municipal 0.605295% + City Building Fund 0.009016% + education 0.153%.",
      "officialSource": "https://www.toronto.ca/services-payments/property-taxes-utilities/property-tax/property-tax-rates-and-fees/",
      "source": "https://homecalc.ca/tools/property-tax-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    bc_rescission_period

    When does the BC rescission period end for an offer accepted on 2 Nov 2026, and what is the fee on $400,000?

    params

    {
      "name": "bc_rescission_period",
      "arguments": {
        "acceptanceDate": "2026-11-02",
        "purchasePrice": 400000
      }
    }

    result.structuredContent

    {
      "acceptanceDate": "2026-11-02",
      "businessDays": [
        "2026-11-03",
        "2026-11-04",
        "2026-11-05"
      ],
      "deadline": "2026-11-05",
      "deadlineWeekday": "Thursday",
      "deadlineTime": "11:59 p.m. local time",
      "skippedDays": [],
      "rescissionFee": 1000,
      "source": "https://homecalc.ca/tools/bc-rescission-period-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    seventy_percent_rule

    Maximum offer under the 70% rule for a $700,000 ARV with $80,000 of repairs.

    params

    {
      "name": "seventy_percent_rule",
      "arguments": {
        "afterRepairValue": 700000,
        "repairCosts": 80000
      }
    }

    result.structuredContent

    {
      "rule": "70%",
      "maxPurchasePrice": 410000,
      "saleCommission": 35000,
      "saleClosingCosts": 10500,
      "totalCosts": 125500,
      "profitAtMaxPrice": 164500,
      "profitMarginPercent": 23.5,
      "worthPursuing": true,
      "note": "Rule of thumb only. Holding costs, financing and tax on the profit are not included — house_flipping covers those.",
      "source": "https://homecalc.ca/tools/70-percent-rule-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    house_hacking

    Renting a $2,000/month suite in a $900,000 home at 4.5%.

    params

    {
      "name": "house_hacking",
      "arguments": {
        "purchasePrice": 900000,
        "mortgageRatePct": 4.5,
        "monthlyRent": 2000
      }
    }

    result.structuredContent

    {
      "downPayment": 90000,
      "cmhcPremium": 26730,
      "insuredMortgage": 836730,
      "monthlyMortgagePayment": 4218.92,
      "totalOwnershipCostMonthly": 5468.92,
      "netRentAfterVacancyMonthly": 1900,
      "netRentalCashFlowMonthly": 1900,
      "yourTrueMonthlyCost": 3568.92,
      "coveredByTenantsPercent": 34.7,
      "monthlySavingsVsRenting": 431.08,
      "grossRentToLiveFreeMonthly": 5756.76,
      "stressTestRatePercent": 6.5,
      "incomeNeededToQualifyAnnual": 188963,
      "incomeNeededWithRentalAddBackAnnual": 150963,
      "lenderRentRecognitionPercent": 65,
      "principalPaidFirst5Years": 74466,
      "source": "https://homecalc.ca/tools/house-hacking-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    renovation_roi

    Return on a $25,000 minor kitchen renovation.

    params

    {
      "name": "renovation_roi",
      "arguments": {
        "projectType": "Kitchen Renovation (Minor)",
        "renovationCost": 25000
      }
    }

    result.structuredContent

    {
      "projectType": "Kitchen Renovation (Minor)",
      "valueAddedAtCompletion": 18750,
      "valueAddedIsEstimate": true,
      "newHomeValue": 618750,
      "roiAtCompletionPercent": -25,
      "costRecoveryAtCompletionPercent": 75,
      "economicLifeYears": 15,
      "atSale": {
        "years": 0,
        "valueAdded": 18750,
        "rentCollected": 0,
        "netGainLoss": -6250,
        "costRecoveryPercent": 75
      },
      "projection": [
        {
          "year": 0,
          "valueAdded": 18750,
          "netGainLoss": -6250
        },
        {
          "year": 1,
          "valueAdded": 17500,
          "netGainLoss": -7500
        },
        {
          "year": 3,
          "valueAdded": 15000,
          "netGainLoss": -10000
        },
        {
          "year": 5,
          "valueAdded": 12500,
          "netGainLoss": -12500
        },
        {
          "year": 10,
          "valueAdded": 6250,
          "netGainLoss": -18750
        },
        {
          "year": 15,
          "valueAdded": 0,
          "netGainLoss": -25000
        },
        {
          "year": 20,
          "valueAdded": 0,
          "netGainLoss": -25000
        },
        {
          "year": 25,
          "valueAdded": 0,
          "netGainLoss": -25000
        }
      ],
      "note": "Value-added estimates and economic lives are HomeCalc starting assumptions — no measured Canadian source publishes them. Replace them with a local realtor's or appraiser's figures.",
      "source": "https://homecalc.ca/tools/renovation-roi-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    property_development

    Profit on a 2,000 sq ft build on $500,000 of land at $250/sq ft, selling for $1.2M.

    params

    {
      "name": "property_development",
      "arguments": {
        "landPurchasePrice": 500000,
        "grossFloorAreaSqft": 2000,
        "costPerSqft": 250,
        "estimatedSalePrice": 1200000
      }
    }

    result.structuredContent

    {
      "landTotal": 509475,
      "landTransferTax": 6475,
      "hardCosts": 515000,
      "softCosts": 97700,
      "netHst": 79651,
      "newHousingHstRebate": 0,
      "financingCost": 54082,
      "contingency": 61270,
      "totalProjectCost": 1317178,
      "netSaleProceeds": 1137000,
      "profit": -180178,
      "profitMarginPercent": -15.8,
      "roiPercent": -13.7,
      "allInCostPerSqft": 658.59,
      "note": "Soft costs use the calculator's defaults: architect 8%, engineering 3%, permits 2% and project management 5% of hard costs, $5,000 survey/appraisals, $3,000 legal on the land and $3,000 on the sale. Adjust them on the website.",
      "source": "https://homecalc.ca/tools/property-development-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    rent_vs_buy

    Rent at $2,200/month or buy a $600,000 home at 4.5%?

    params

    {
      "name": "rent_vs_buy",
      "arguments": {
        "purchasePrice": 600000,
        "monthlyRent": 2200,
        "mortgageRatePct": 4.5
      }
    }

    result.structuredContent

    {
      "monthlyMortgagePayment": 2668,
      "monthlyOwnerCostYear1": 3628,
      "cmhcPremium": 0,
      "landTransferTax": 16950,
      "firstTimeBuyerRebate": 0,
      "atYearsToStay": {
        "year": 10,
        "netCostBuying": 168979,
        "netCostRenting": -158191,
        "wealthBuying": 417272,
        "wealthRenting": 459160,
        "homeValue": 806350,
        "equityAfterSelling": 417272
      },
      "buyingIsCheaper": false,
      "differenceAtYearsToStay": 327170,
      "breakEvenYear": null,
      "milestones": [
        {
          "year": 5,
          "netCostBuying": 120912,
          "netCostRenting": -123752,
          "wealthBuying": 239068,
          "wealthRenting": 266219
        },
        {
          "year": 10,
          "netCostBuying": 168979,
          "netCostRenting": -158191,
          "wealthBuying": 417272,
          "wealthRenting": 459160
        },
        {
          "year": 15,
          "netCostBuying": 188801,
          "netCostRenting": -236146,
          "wealthBuying": 630608,
          "wealthRenting": 716249
        },
        {
          "year": 25,
          "netCostBuying": 115884,
          "netCostRenting": -618873,
          "wealthBuying": 1193453,
          "wealthRenting": 1530338
        }
      ],
      "source": "https://homecalc.ca/tools/rent-vs-buy-calculator",
      "disclaimer": "Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA."
    }

    Result format and source links

    A successful result has both content (one text item) and structuredContent. Every successful result also includes two fields to show the user:

    • source — the HomeCalc page for that calculator, where the user can check or change the inputs.
    • disclaimer — currently: “Estimate only, based on 2026 Canadian rules. Not financial advice. Confirm with your lender, lawyer, or the CRA.”

    The source links returned by the examples above:

    Source URL returned by each example
    Toolsource
    mortgage_paymenthttps://homecalc.ca/tools/mortgage-payment-calculator
    minimum_down_paymenthttps://homecalc.ca/tools/down-payment-calculator
    land_transfer_taxhttps://homecalc.ca/tools/land-transfer-tax-calculator/toronto
    income_taxhttps://homecalc.ca/tools/income-tax-calculator
    mortgage_penaltyhttps://homecalc.ca/tools/mortgage-penalty-calculator
    bc_home_flipping_taxhttps://homecalc.ca/tools/house-flip-tax-calculator/bc
    rent_increasehttps://homecalc.ca/tools/rent-increase-calculator
    capital_gains_taxhttps://homecalc.ca/tools/capital-gains-tax-calculator
    heloc_second_mortgagehttps://homecalc.ca/tools/heloc-second-mortgage-calculator
    mortgage_affordabilityhttps://homecalc.ca/tools/mortgage-affordability-calculator
    cap_ratehttps://homecalc.ca/tools/cap-rate-calculator
    house_flippinghttps://homecalc.ca/tools/house-flipping-calculator
    mortgage_amortizationhttps://homecalc.ca/tools/mortgage-amortization-calculator
    mortgage_stress_testhttps://homecalc.ca/tools/mortgage-stress-test-calculator
    mortgage_prepaymenthttps://homecalc.ca/tools/mortgage-prepayment-calculator
    mortgage_renewalhttps://homecalc.ca/tools/mortgage-renewal-calculator
    mortgage_qualifierhttps://homecalc.ca/tools/mortgage-qualifier-calculator
    cmhc_insurancehttps://homecalc.ca/tools/cmhc-insurance-calculator
    second_home_affordabilityhttps://homecalc.ca/tools/second-home-affordability-calculator
    debt_service_ratiohttps://homecalc.ca/tools/debt-service-ratio-calculator
    debt_to_incomehttps://homecalc.ca/tools/debt-to-income-calculator
    reverse_mortgagehttps://homecalc.ca/tools/reverse-mortgage-calculator
    insured_insurable_uninsuredhttps://homecalc.ca/tools/insured-insurable-uninsured-comparison
    closing_costshttps://homecalc.ca/tools/closing-cost-calculator
    capital_cost_allowancehttps://homecalc.ca/tools/capital-cost-allowance-calculator
    real_estate_commissionhttps://homecalc.ca/tools/real-estate-commission-calculator
    cost_of_sellinghttps://homecalc.ca/tools/cost-of-selling-a-house-calculator
    property_taxhttps://homecalc.ca/tools/property-tax-calculator
    bc_rescission_periodhttps://homecalc.ca/tools/bc-rescission-period-calculator
    seventy_percent_rulehttps://homecalc.ca/tools/70-percent-rule-calculator
    house_hackinghttps://homecalc.ca/tools/house-hacking-calculator
    renovation_roihttps://homecalc.ca/tools/renovation-roi-calculator
    property_developmenthttps://homecalc.ca/tools/property-development-calculator
    rent_vs_buyhttps://homecalc.ca/tools/rent-vs-buy-calculator

    The link can depend on the inputs — for example, a Toronto purchase returns the Toronto land transfer tax page.

    Errors and troubleshooting

    There are two kinds of error. Tool errors come back as a normal result with isError: true; protocol errors come back as a JSON-RPC error.

    A calculation the tool refuses

    When the premise is impossible (here, a down payment below the legal minimum), the tool returns isError: true and a reason instead of a number. Relay the reason to the user.

    params

    {
      "name": "mortgage_payment",
      "arguments": {
        "homePrice": 650000,
        "downPayment": 10000,
        "annualInterestRatePct": 5.25
      }
    }

    Response

    {
      "result": {
        "content": [
          {
            "type": "text",
            "text": "{\n  \"error\": \"A down payment of $10,000 is below the legal minimum for a $650,000 home, which is $40,000 (5% on the first $500,000, 10% from $500,000 to $1.5M, 20% at or above $1.5M). There is no zero-down or below-minimum insured mortgage in Canada, so no payment is returned. Tell the user the minimum, and re-run with a down payment of at least that amount.\"\n}"
          }
        ],
        "structuredContent": {
          "error": "A down payment of $10,000 is below the legal minimum for a $650,000 home, which is $40,000 (5% on the first $500,000, 10% from $500,000 to $1.5M, 20% at or above $1.5M). There is no zero-down or below-minimum insured mortgage in Canada, so no payment is returned. Tell the user the minimum, and re-run with a down payment of at least that amount."
        },
        "isError": true
      },
      "jsonrpc": "2.0",
      "id": 37
    }

    Missing or invalid arguments

    Arguments are validated against the tool's inputSchema. A missing required field or an out-of-range value comes back as an error result naming the problem.

    params

    {
      "name": "minimum_down_payment",
      "arguments": {}
    }

    Response

    {
      "result": {
        "content": [
          {
            "type": "text",
            "text": "Input validation error: Invalid arguments for tool minimum_down_payment: homePrice: Invalid input: expected number, received undefined"
          }
        ],
        "isError": true
      },
      "jsonrpc": "2.0",
      "id": 38
    }

    A tool name that does not exist

    Only the names returned by tools/list exist. Any other name is rejected.

    params

    {
      "name": "best_mortgage_rate",
      "arguments": {
        "province": "Ontario"
      }
    }

    Response

    {
      "jsonrpc": "2.0",
      "id": 39,
      "error": {
        "code": -32602,
        "message": "Tool best_mortgage_rate not found"
      }
    }

    406 Not Acceptable

    The Accept header must list both application/json and text/event-stream. Sending only one (or none) returns 406 before the request reaches any tool.

    Request

    curl -sS https://homecalc.ca/api/mcp \
      -H 'content-type: application/json' \
      -H 'accept: application/json' \
      -H 'mcp-protocol-version: 2025-06-18' \
      -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

    Response (HTTP 406)

    {"jsonrpc":"2.0","error":{"code":-32000,"message":"Not Acceptable: Client must accept both application/json and text/event-stream"},"id":null}

    400 Unsupported protocol version

    An unknown MCP-Protocol-Version header returns 400, and the error lists the 2025-era revisions the server accepts. Official MCP SDK clients negotiate the version for you.

    Request

    curl -sS https://homecalc.ca/api/mcp \
      -H 'content-type: application/json' \
      -H 'accept: application/json, text/event-stream' \
      -H 'mcp-protocol-version: 1999-01-01' \
      -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

    Response (HTTP 400)

    {"jsonrpc":"2.0","error":{"code":-32000,"message":"Bad Request: Unsupported protocol version: 1999-01-01 (supported versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07)"},"id":null}

    Privacy and data

    No personal data. The connector has no login and never stores names, emails, IP addresses, exact figures, account identifiers or conversation text. For each calculation we keep anonymous, rounded usage statistics: which calculator, which assistant (Claude or ChatGPT), the time, whether it succeeded or returned an error, the province, rounded ranges of the inputs (for example the price in $100,000 bands, income in $25,000 bands, the interest rate rounded down to the nearest 0.25%) and yes/no outcomes (for example whether CMHC insurance applies). Our hosting provider keeps standard request logs, including IP addresses, for about a day for security and operations. Usage statistics are deleted after 24 months. We use them only to improve the calculators and to publish aggregate market research, and we never sell them.

    Calls from your own client — including any you make to try these examples — are counted in those anonymous usage statistics. See the Privacy Policy for the full details.

    Questions

    The connector is built and maintained by Hami Tahm, founder of HomeCalc.ca, on the same calculator cores as the website (see our methodology). Questions or issues? Email hami@homecalc.ca.

    Related: HomeCalc Connector · All calculators · Embed our calculators

    Stay Ahead of the Market

    Get weekly insights on rates, market trends, and smarter homebuying decisions.

    No spam. Unsubscribe anytime.