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
| Value | |
|---|---|
| Endpoint | https://homecalc.ca/api/mcp |
| Transport | MCP Streamable HTTP — JSON-RPC 2.0 over POST; responses arrive as text/event-stream |
| Protocol revisions | 2026-07-28, and the 2025-era revisions 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07 |
| Authentication | None — no account, no API key |
| Sessions | Stateless — no mcp-session-id is issued; every request stands alone |
| Tools | 34 calculation tools, all marked readOnlyHint: true and openWorldHint: false |
| Server | homecalc 0.1.0 |
| Browser clients | CORS allows any origin (Access-Control-Allow-Origin: *) |
| Price | Free |
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/mcpResponse (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/jsonaccept: 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_paymentminimum_down_paymentland_transfer_taxincome_taxmortgage_penaltybc_home_flipping_taxrent_increasecapital_gains_taxheloc_second_mortgagemortgage_affordabilitycap_ratehouse_flippingmortgage_amortizationmortgage_stress_testmortgage_prepaymentmortgage_renewalmortgage_qualifiercmhc_insurancesecond_home_affordabilitydebt_service_ratiodebt_to_incomereverse_mortgageinsured_insurable_uninsuredclosing_costscapital_cost_allowancereal_estate_commissioncost_of_sellingproperty_taxbc_rescission_periodseventy_percent_rulehouse_hackingrenovation_roiproperty_developmentrent_vs_buy
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| homePrice | number | No | > 0 | Purchase price in CAD, with downPayment. Omit if the user gave the mortgage amount. |
| loanAmount | number | No | > 0 | Mortgage amount in CAD, instead of homePrice. No CMHC premium is added. |
| downPayment | number | No | ≥ 0 | Down payment in CAD, or percent if downPaymentType='percent'. Required with homePrice. |
| annualInterestRatePct | number | Yes | ≥ 0, ≤ 25 | Annual interest rate as a percent, e.g. 5.25 |
| amortizationYears | number | No | ≥ 1, ≤ 30 | Amortization in years (max 25 insured, 30 uninsured/first-time new builds) |
| downPaymentType | string | No | amount, percent | downPayment as dollars or percent of homePrice |
| paymentFrequency | string | No | monthly, semi-monthly, biweekly, accelerated-biweekly, weekly, accelerated-weekly | How often payments are made |
| rateType | string | No | fixed, variable | Fixed or variable rate |
| termYears | number | No | ≥ 1, ≤ 10 | Mortgage term in years |
| province | string | No | Province name, used only for CMHC PST on the premium |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| homePrice | number | Yes | > 0 | Purchase price in CAD |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| price | number | Yes | > 0 | Purchase price in CAD |
| province | string | Yes | Ontario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, Yukon | Province or territory |
| inToronto | boolean | No | Ontario only: property is within the City of Toronto (adds the municipal LTT) | |
| isFirstTimeBuyer | boolean | No | First-time buyer (rebate where one exists) | |
| quebecMunicipality | string | No | montreal, other | Quebec only: 'montreal' = Montreal's welcome-tax brackets (default); 'other' = provincial base schedule, for municipalities without higher rates above $500,000 |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| annualIncome | number | Yes | ≥ 0 | Gross annual employment income in CAD |
| province | string | Yes | Ontario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, Newfoundland & Labrador | Province of residence |
| employmentType | string | No | employed, self_employed | Self-employed pays both CPP/QPP halves |
| rrspContribution | number | No | ≥ 0 | Annual RRSP contribution in CAD |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| balance | number | Yes | > 0 | Outstanding mortgage balance in CAD |
| rateType | string | No | fixed, variable | Fixed or variable mortgage |
| contractRatePct | number | Yes | ≥ 0, ≤ 25 | Your contract rate as a percent, e.g. 5.25 |
| monthsRemaining | number | Yes | ≥ 0, ≤ 120 | Months remaining in the term |
| lenderMethod | string | No | big-bank, monoline | Big banks use the posted-rate IRD, monolines actual rates. Either can be larger, depending on the original discount vs today's posted rate. |
| currentRateForRemainingTermPct | number | No | ≥ 0, ≤ 25 | Monoline method: today's rate for the remaining term (percent). Omit if unknown (assumption is flagged). |
| postedAtOriginationPct | number | No | ≥ 0, ≤ 25 | Big-bank method: posted (not discounted) rate when signed, from the mortgage documents. Can change the penalty several-fold. Omit if unknown (assumption is flagged). |
| todaysPostedForClosestTermPct | number | No | ≥ 0, ≤ 25 | Big-bank method: the lender's posted rate today for the closest term. Omit if unknown (assumption is flagged). |
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).
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| taxableIncome | number | Yes | Proceeds minus cost to acquire minus cost to improve (may be negative) | |
| daysHeld | number | Yes | ≥ 0 | Days owned before the sale |
| isPrimaryResidence | boolean | No | Lived in it as a primary residence |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| currentRent | number | Yes | > 0 | Current monthly rent in CAD |
| province | string | Yes | Ontario, British Columbia, Manitoba | Province whose guideline applies |
| year | string | Yes | Guideline year, e.g. '2026'; unsupported = latest (shown in reply) | |
| unitExempt | boolean | No | ON: first occupied on/after 15 Nov 2018. MB: exempt for a non-rent reason |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| salePrice | number | Yes | ≥ 0 | Gross sale proceeds in CAD |
| purchasePrice | number | Yes | ≥ 0 | Original purchase price in CAD |
| province | string | No | Ontario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, Yukon | Province/territory of residence |
| annualIncome | number | No | ≥ 0 | Other annual income in CAD; the gain is taxed on top of it |
| assetType | string | No | real-estate, stocks, crypto, business, rental, other | What was sold; decides which exemptions apply |
| sellingCosts | number | No | ≥ 0 | Commission, legal and other selling costs |
| buyingCosts | number | No | ≥ 0 | Land transfer tax, legal and other buying costs |
| capitalImprovements | number | No | ≥ 0 | Capital improvements added to the adjusted cost base |
| isPrincipalResidence | boolean | No | Real estate only: claim the principal residence exemption | |
| yearsOwned | number | No | ≥ 0 | Years owned (for principal-residence proration) |
| yearsDesignated | number | No | ≥ 0 | Years designated as your principal residence |
| isQSBC | boolean | No | Business only: qualified small business corporation shares (LCGE) | |
| lcgeRemaining | number | No | ≥ 0 | Remaining lifetime capital gains exemption room in CAD |
| capitalLosses | number | No | ≥ 0 | Capital losses (prior or current) to offset the gain |
| taxpayerType | string | No | individual, corporation, trust | Who sold the asset |
| taxYear | number | No | ≥ 2020, ≤ 2035 | Tax year of the disposition |
| landValue | number | No | ≥ 0 | Rental only: land portion of the sale price (splits land vs building gain) |
| originalBuildingCost | number | No | ≥ 0 | Rental only: original building cost for CCA recapture |
| ccaClaimedToDate | number | No | ≥ 0 | Rental only: total CCA claimed to date |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| homeValue | number | Yes | > 0 | Current market value of the home in CAD |
| outstandingFirstMortgage | number | Yes | ≥ 0 | Balance remaining on the first mortgage in CAD |
| amountToBorrow | number | Yes | ≥ 0 | Amount you want to borrow in CAD |
| annualHouseholdIncome | number | Yes | ≥ 0 | Gross annual household income in CAD |
| province | string | No | Ontario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, Newfoundland and Labrador, Prince Edward Island | Sets the property-tax estimate used in TDS |
| existingMonthlyDebts | number | No | ≥ 0 | Other monthly debt payments (car, cards, loans) |
| purposeOfFunds | string | No | Home Renovation, Debt Consolidation, Investment Property Down Payment, Education, Emergency Funds, Other | What the money is for |
| secondMortgageLenderTier | string | No | A, B, Private | A = bank/credit union, B = trust/MIC, Private = individual investor |
| helocPrimeRatePct | number | No | ≥ 0, ≤ 25 | Prime rate as a percent; defaults to the site's current prime |
| helocSpreadPct | number | No | ≥ 0, ≤ 10 | Lender spread over prime as a percent, e.g. 0.5 |
| secondMortgageRatePct | number | No | ≥ 0, ≤ 30 | Second mortgage rate as a percent; defaults to the tier's typical rate |
| secondMortgageAmortYears | number | No | ≥ 1, ≤ 30 | Second mortgage amortization in years (not used by interest-only Private) |
| secondMortgageTermYears | number | No | ≥ 1, ≤ 10 | Second mortgage term in years |
| extraMonthlyPrincipal | number | No | ≥ 0 | Optional extra principal paid monthly on the HELOC |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| annualIncome | number | Yes | ≥ 0 | Primary applicant gross annual income in CAD |
| downPayment | number | Yes | ≥ 0 | Down payment — dollars, or a percent if downPaymentMode='percent' |
| coApplicantIncome | number | No | ≥ 0 | Co-applicant gross annual income in CAD (0 = none) |
| downPaymentMode | string | No | dollar, percent | downPayment as dollars or percent |
| monthlyDebts | number | No | ≥ 0 | Other monthly debt payments (car, cards, student loans) |
| annualPropertyTax | number | No | ≥ 0 | Estimated annual property tax in CAD |
| monthlyHeating | number | No | ≥ 0 | Estimated monthly heating cost in CAD |
| propertyType | string | No | single-family, condo, townhouse | Type of home being bought |
| condoFees | number | No | ≥ 0 | Monthly condo fees — 50% counts toward GDS/TDS for condos |
| province | string | No | Province of the purchase | |
| interestRatePct | number | No | ≥ 0, ≤ 25 | Contract mortgage rate as a percent, e.g. 4.79 |
| amortizationYears | any | No | Amortization: 25 or 30 years |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| purchasePrice | number | Yes | > 0 | Purchase price in CAD |
| monthlyGrossRent | number | Yes | ≥ 0 | Gross monthly rent for all units in CAD |
| annualOperatingExpenses | number | Yes | ≥ 0 | Annual operating expenses in CAD (tax, insurance, management, maintenance, landlord utilities); excludes the mortgage |
| downPayment | number | Yes | ≥ 0 | Down payment in CAD. Set equal to purchasePrice for an all-cash purchase. |
| interestRatePct | number | No | ≥ 0, ≤ 25 | Mortgage rate as a percent, e.g. 5.49 |
| amortizationYears | number | No | ≥ 1, ≤ 30 | Mortgage amortization in years |
| vacancyRatePct | number | No | ≥ 0, ≤ 100 | Vacancy allowance as a percent of gross rent |
| city | string | No | toronto, vancouver, calgary, edmonton, ottawa, montreal, halifax, winnipeg, hamilton, kitchener-waterloo, other | City used for the cap-rate benchmark range |
| propertyType | string | No | single-family, multi-unit, commercial, mixed-use | Used for down payment warnings |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| purchasePrice | number | Yes | > 0 | Purchase price in CAD |
| afterRepairValue | number | Yes | > 0 | Expected resale price after renovation (ARV) in CAD |
| renovationCost | number | Yes | ≥ 0 | Budgeted renovation cost in CAD, before contingency |
| province | string | No | Ontario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, Newfoundland | Province; sets the land transfer tax |
| city | string | No | City name — include 'Toronto' to add the Toronto municipal land transfer tax | |
| contingencyPct | number | No | ≥ 0, ≤ 100 | Contingency as a percent of renovationCost |
| holdingPeriodMonths | number | No | ≥ 0, ≤ 120 | Months held from purchase to sale — under 12 triggers the CRA flipping rule |
| monthlyHoldingCosts | number | No | ≥ 0 | Monthly carrying costs: mortgage interest, property tax, insurance, utilities |
| realtorCommissionPct | number | No | ≥ 0, ≤ 15 | Realtor commission on the sale as a percent of ARV |
| closingCostsBuy | number | No | ≥ 0 | Purchase legal/inspection costs, excluding land transfer tax |
| closingCostsSell | number | No | ≥ 0 | Sale legal/staging costs, excluding commission |
| marginalTaxRatePct | number | No | ≥ 0, ≤ 60 | Your combined marginal tax rate as a percent |
| isFirstTimeBuyer | boolean | No | Eligible for the first-time buyer land transfer tax rebate |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| principal | number | Yes | > 0 | Mortgage amount in CAD |
| annualInterestRatePct | number | No | ≥ 0.01, ≤ 25 | Annual interest rate as a percent, e.g. 4.5 |
| amortizationYears | integer | No | ≥ 1, ≤ 40 | Amortization in years |
| paymentFrequency | string | No | monthly, semi-monthly, biweekly, accelerated-biweekly, weekly, accelerated-weekly | How often payments are made |
| termYears | integer | No | ≥ 1, ≤ 10 | Mortgage term in years (sets the renewal point) |
| annualLumpSum | number | No | ≥ 0 | Extra lump-sum prepayment each year in CAD |
| paymentIncreasePct | number | No | ≥ 0, ≤ 100 | Raise each regular payment by this percent |
| prepaymentStartYear | integer | No | ≥ 1, ≤ 40 | Year the prepayments start |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| scenario | string | No | purchase, renewal, refinance | Buying, renewing, or refinancing |
| annualIncome | number | Yes | ≥ 0 | Main applicant gross annual income in CAD |
| coApplicantIncome | number | No | ≥ 0 | Co-applicant gross annual income in CAD (0 if none) |
| homePrice | number | Yes | > 0 | Purchase price, or current home value for renewal/refinance, in CAD |
| downPayment | number | No | ≥ 0 | Purchase only: down payment in CAD |
| outstandingBalance | number | No | ≥ 0 | Renewal/refinance only: balance owing in CAD |
| additionalBorrow | number | No | ≥ 0 | Refinance only: extra cash to borrow in CAD |
| contractRatePct | number | No | ≥ 0.01, ≤ 25 | Contract interest rate as a percent |
| renewalRatePct | number | No | ≥ 0.01, ≤ 25 | Renewal only: rate you are renewing into, percent |
| renewalWithNewLender | boolean | No | Renewal only: switching to a new lender | |
| renewalIncreasing | boolean | No | Renewal only: increasing the amount or amortization (then the stress test applies) | |
| amortizationYears | integer | No | ≥ 5, ≤ 30 | Amortization in years (5–30) |
| monthlyPropertyTax | number | No | ≥ 0 | Monthly property tax in CAD |
| monthlyHeating | number | No | ≥ 0 | Monthly heating cost in CAD |
| monthlyCondoFees | number | No | ≥ 0 | Monthly condo fees in CAD (50% counts) |
| monthlyDebtPayments | number | No | ≥ 0 | Other monthly debt payments in CAD |
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).
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| balance | number | Yes | > 0 | Current mortgage balance in CAD |
| annualInterestRatePct | number | No | ≥ 0.01, ≤ 25 | Annual interest rate as a percent |
| amortizationYears | integer | No | ≥ 1, ≤ 40 | Remaining amortization in years |
| paymentFrequency | string | No | monthly, semi-monthly, biweekly, accelerated-biweekly, weekly, accelerated-weekly | How often payments are made |
| extraPerPayment | number | No | ≥ 0 | Extra amount added to every payment in CAD |
| annualLumpSum | number | No | ≥ 0 | Lump sum paid once a year in CAD |
| lumpSumStartYear | integer | No | ≥ 1, ≤ 40 | Year the annual lump sum starts |
| rateType | string | No | fixed, variable | Fixed or variable (sets the penalty method) |
| monthsRemainingInTerm | integer | No | ≥ 0, ≤ 120 | Months left in the current term |
| comparisonRatePct | number | No | ≥ 0, ≤ 25 | Lender's comparison rate for the IRD, percent |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| balance | number | Yes | > 0 | Balance at renewal in CAD |
| currentRatePct | number | No | ≥ 0.01, ≤ 25 | Rate on the expiring term, percent |
| renewalRatePct | number | No | ≥ 0.01, ≤ 25 | Rate offered at renewal, percent |
| termYears | integer | No | ≥ 1, ≤ 10 | New term length in years |
| remainingAmortizationYears | integer | No | ≥ 1, ≤ 40 | Amortization left at renewal, in years |
| paymentFrequency | string | No | monthly, biweekly, accelerated-biweekly, weekly, accelerated-weekly | How often payments are made |
| lumpSumAtRenewal | number | No | ≥ 0 | Lump sum paid down at renewal in CAD |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| mode | string | No | income, budget | Qualify from income, or from a monthly payment budget |
| annualIncome | number | No | ≥ 0 | Income mode: main applicant gross annual income in CAD |
| coApplicantIncome | number | No | ≥ 0 | Income mode: co-applicant gross annual income in CAD |
| monthlyDebtPayments | number | No | ≥ 0 | Income mode: other monthly debt payments in CAD |
| monthlyPaymentBudget | number | No | ≥ 0 | Budget mode: monthly mortgage payment you can afford in CAD |
| annualInterestRatePct | number | No | ≥ 0.01, ≤ 25 | Contract rate as a percent |
| amortizationYears | any | No | Amortization: 5, 10, 15, 20, 25 or 30 years | |
| downPayment | number | Yes | ≥ 0 | Down payment available in CAD |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| homePrice | number | Yes | > 0 | Purchase price in CAD |
| downPayment | number | Yes | ≥ 0 | Down payment in CAD |
| province | string | No | Ontario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, Newfoundland and Labrador, Prince Edward Island | Province, for sales tax on the premium |
| firstTimeBuyerNewBuild | boolean | No | First-time buyer buying a new build (30-year insured amortization) |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| annualIncome | number | Yes | ≥ 0 | Household gross annual income in CAD |
| primaryMortgagePayment | number | No | ≥ 0 | Current home's monthly mortgage payment |
| primaryPropertyTax | number | No | ≥ 0 | Current home's MONTHLY property tax |
| primaryHeating | number | No | ≥ 0 | Current home's monthly heating cost |
| otherDebts | number | No | ≥ 0 | Other monthly debt payments (cards, car, loans) |
| intent | string | No | vacation, rental, personal | Cottage/vacation, rental/investment, or second personal home |
| willOccupy | boolean | No | Will you live in it part-time? Allows CMHC Second Home (5%+ down). Ignored for rentals. | |
| purchasePrice | number | Yes | > 0 | Second property purchase price in CAD |
| downPayment | number | Yes | ≥ 0 | Down payment in CAD, or percent if downPaymentMode='percent' |
| downPaymentMode | string | No | dollar, percent | downPayment as dollars or percent of price |
| interestRatePct | number | No | ≥ 0, ≤ 25 | Annual interest rate as a percent, e.g. 4.49 |
| amortizationYears | number | No | ≥ 5, ≤ 30 | Amortization in years |
| secondPropertyTaxAnnual | number | No | ≥ 0 | Second property's ANNUAL property tax |
| secondHeating | number | No | ≥ 0 | Second property's monthly heating cost |
| condoFees | number | No | ≥ 0 | Second property's monthly condo fees (50% counted) |
| borrowedEquityAmount | number | No | ≥ 0 | HELOC/equity borrowed for this purchase, in CAD |
| rentalIncome | number | No | ≥ 0 | Expected monthly rent; 0 = no rental income counted |
| rentalCreditMode | string | No | 50, 80, full | Lender rent treatment: 50% or 80% add-back, or full offset |
| province | string | No | Ontario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, Newfoundland and Labrador, Prince Edward Island | Province of the second property |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| annualIncome | number | Yes | ≥ 0 | Applicant's gross annual income in CAD |
| coApplicantIncome | number | No | ≥ 0 | Co-applicant gross annual income in CAD (0 if none) |
| mortgagePayment | number | Yes | ≥ 0 | Monthly mortgage principal + interest in CAD |
| propertyTaxMonthly | number | No | ≥ 0 | Monthly property tax in CAD |
| heatingMonthly | number | No | ≥ 0 | Monthly heating cost in CAD |
| condoFeesMonthly | number | No | ≥ 0 | Monthly condo fees in CAD (50% counted) |
| otherDebtsMonthly | number | No | ≥ 0 | Other monthly debt payments in CAD |
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%.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| annualIncome | number | Yes | ≥ 0 | Household gross annual income in CAD |
| housingCostsMonthly | number | No | ≥ 0 | Monthly housing costs: mortgage/rent, tax, heat, 50% condo |
| debts | array | No | Every non-mortgage debt |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| homeValue | number | Yes | > 0 | Current/appraised home value in CAD |
| age | integer | Yes | ≥ 18, ≤ 120 | Youngest borrower's age (must be 55+) |
| amountTaken | number | Yes | ≥ 0 | Amount you'd take in CAD (capped at the 55% ceiling) |
| rateTerm | string | No | variable, 6mo, 1yr, 3yr, 5yr | Posted CHIP rate term to use |
| appreciationRatePct | number | No | ≥ -10, ≤ 15 | Your own home appreciation assumption, %/yr |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| purpose | string | No | purchase, renewal, switch, refinance | What the mortgage is for |
| homeValue | number | Yes | > 0 | Home value (or purchase price) in CAD |
| mortgageAmount | number | Yes | > 0 | Mortgage amount / outstanding balance in CAD |
| amortizationYears | number | No | ≥ 1, ≤ 40 | Amortization in years |
| occupancy | string | No | owner, second, rental | Owner-occupied, second home, or rental |
| units | integer | No | ≥ 1, ≤ 4 | Number of units (1–4) |
| premiumPaid | string | No | yes, no, unknown | Was a borrower-paid insurance premium paid originally? |
| fthbOrNewBuild | boolean | No | First-time buyer or new construction (30-yr insured) | |
| equityTakeout | boolean | No | Refinance only: taking equity out / raising the loan | |
| annualIncome | number | No | ≥ 0 | Household gross annual income in CAD (for GDS/TDS) |
| monthlyDebts | number | No | ≥ 0 | Other monthly debt payments in CAD |
| propertyTaxMonthly | number | No | ≥ 0 | Monthly property tax in CAD |
| heatingMonthly | number | No | ≥ 0 | Monthly heating cost in CAD |
| condoFeesMonthly | number | No | ≥ 0 | Monthly condo fees in CAD (50% counted) |
| qualifyingMode | string | No | mqr, contract | Qualify at the stress-test rate or at the contract rate |
| rateInsuredPct | number | No | ≥ 0, ≤ 25 | Insured rate, % (illustrative default — pass the lender's) |
| rateInsurablePct | number | No | ≥ 0, ≤ 25 | Insurable rate, % (illustrative default) |
| rateUninsurablePct | number | No | ≥ 0, ≤ 25 | Uninsurable rate, % (illustrative default) |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| homePrice | number | Yes | > 0 | Purchase price in CAD |
| province | string | No | Ontario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, Yukon | Province or territory |
| downPaymentPct | number | No | ≥ 0, ≤ 100 | Down payment as a percent of price |
| isFirstTimeBuyer | boolean | No | First-time buyer (LTT rebates where they exist) | |
| isToronto | boolean | No | Ontario only: in the City of Toronto (adds MLTT) | |
| isForeignBuyer | boolean | No | Foreign buyer (Ontario NRST / Toronto MNRST) | |
| propertyType | string | No | existing, newBuild | Resale or newly built |
| occupancy | string | No | primary, rental | New builds: live in it or rent it out |
| amortizationYears | number | No | ≥ 5, ≤ 30 | Amortization in years (30 adds the CMHC surcharge) |
| legalFees | number | No | ≥ 0 | Legal fees allowance in CAD |
| titleInsurance | number | No | ≥ 0 | Title insurance in CAD |
| homeInspection | number | No | ≥ 0 | Home inspection in CAD |
| appraisal | number | No | ≥ 0 | Appraisal in CAD |
| movingCosts | number | No | ≥ 0 | Moving costs in CAD |
| propertyTaxAdjustment | number | No | ≥ 0 | Prepaid property tax reimbursed to the seller |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| assetCost | number | Yes | > 0 | Capital cost of the asset in CAD |
| assetPreset | string | No | building, equipment, computer, vehicle, clean-energy, custom | Asset type; 'custom' uses ccaClass |
| ccaClass | string | No | class1, class3, class6, class8, class10, class10.1, class12, class16, class17, class43, class43.1, class43.2, class50, class53, class54, class55 | CCA class id (e.g. class8, class50), used when assetPreset='custom' |
| acquisitionDate | string | No | Date acquired, YYYY-MM-DD; omitted = half-year rule | |
| province | string | No | ON, BC, AB, QC, MB, SK, NS, NB, PE, NL, NT, YT, NU | Province/territory code for the marginal tax rate, e.g. ON |
| annualIncome | number | No | ≥ 0 | Taxable income before CCA, for the marginal rate |
| existingUCC | number | No | ≥ 0 | Undepreciated capital cost already in the class; 0 for a new purchase |
| disposalProceeds | number | No | ≥ 0 | Proceeds if the asset is sold, for recapture or terminal loss |
| disposalDate | string | No | Date sold, YYYY-MM-DD, with disposalProceeds | |
| netRentalIncomeBeforeCCA | number | No | Rental building only: net rental income before CCA (CCA can't create a rental loss) |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| salePrice | number | Yes | > 0 | Sale price in CAD |
| province | string | No | Ontario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, Yukon | Province or territory; sets the commonly quoted starting rates |
| structure | string | No | tiered, flat | Override: tiered (e.g. 7% on first $100k) or flat % of the whole price |
| tierThreshold | number | No | ≥ 0 | Override, tiered only: price up to which the first-tier rate applies |
| firstTierRatePct | number | No | ≥ 0, ≤ 20 | Override, tiered only: percent on the first tier, e.g. 7 |
| remainderRatePct | number | No | ≥ 0, ≤ 20 | Override: percent on the balance (tiered) or whole price (flat) |
| salesTaxRatePct | number | No | ≥ 0, ≤ 20 | Override: GST/HST percent charged on the commission |
| buyerSideSharePct | number | No | ≥ 0, ≤ 100 | Share of the commission paid to the buyer's brokerage, percent |
| mortgageBalance | number | No | ≥ 0 | Mortgage paid out at closing, for net proceeds |
| legalFees | number | No | ≥ 0 | Seller's legal fees in CAD |
| otherSellingCosts | number | No | ≥ 0 | Other selling costs in CAD (staging, repairs) |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| salePrice | number | Yes | > 0 | Sale price in CAD |
| remainingMortgage | number | No | ≥ 0 | Mortgage balance paid out at closing |
| legalFees | number | No | ≥ 0 | Seller's legal fees in CAD |
| mortgageDischargeFee | number | No | ≥ 0 | Lender's mortgage discharge fee in CAD |
| otherCosts | number | No | ≥ 0 | Other costs in CAD: staging, repairs, moving |
| province | string | No | Ontario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, Yukon | Province or territory; sets the commonly quoted starting rates |
| structure | string | No | tiered, flat | Override: tiered (e.g. 7% on first $100k) or flat % of the whole price |
| tierThreshold | number | No | ≥ 0 | Override, tiered only: price up to which the first-tier rate applies |
| firstTierRatePct | number | No | ≥ 0, ≤ 20 | Override, tiered only: percent on the first tier, e.g. 7 |
| remainderRatePct | number | No | ≥ 0, ≤ 20 | Override: percent on the balance (tiered) or whole price (flat) |
| salesTaxRatePct | number | No | ≥ 0, ≤ 20 | Override: GST/HST percent charged on the commission |
| buyerSideSharePct | number | No | ≥ 0, ≤ 100 | Share of the commission paid to the buyer's brokerage, percent |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| assessedValue | number | Yes | > 0 | Assessed value in CAD, from the assessment notice |
| city | string | No | Toronto, Ottawa, Hamilton, Mississauga, Brampton, London, Windsor, Vancouver, Victoria, Surrey, Calgary, Edmonton, Montréal, Québec City, Winnipeg, Saskatoon, Regina, Halifax | City whose 2026 rate to use (exact name, e.g. Toronto, Montréal) |
| ratePct | number | No | ≥ 0, ≤ 10 | Your own rate as a percent of full assessed value; overrides the city rate |
| includeQuebecSchoolTax | boolean | No | Quebec cities only: add the school tax (after its $25,000 exemption) |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| acceptanceDate | string | Yes | Date the offer was accepted, YYYY-MM-DD | |
| purchasePrice | number | Yes | > 0 | Accepted purchase price in CAD, for the 0.25% fee |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| afterRepairValue | number | Yes | > 0 | Expected resale price after renovation (ARV) in CAD |
| repairCosts | number | Yes | ≥ 0 | Total renovation budget in CAD |
| rulePct | string | No | 65, 70 | Rule to apply: 70% (standard) or 65% (stricter) |
| commissionRatePct | number | No | ≥ 0, ≤ 10 | Commission on the sale as a percent of ARV |
| closingCostRatePct | number | No | ≥ 0, ≤ 10 | Closing costs on the sale as a percent of ARV |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| purchasePrice | number | Yes | > 0 | Purchase price in CAD |
| mortgageRatePct | number | Yes | ≥ 0, ≤ 25 | Annual mortgage rate as a percent, e.g. 4.5 |
| monthlyRent | number | Yes | ≥ 0 | Total monthly rent from the rented part of the home in CAD |
| downPaymentPct | number | No | ≥ 0, ≤ 100 | Down payment as a percent of the price |
| strategy | string | No | basement, duplex_triplex, room_rental, adu | Basement suite, duplex/triplex, room rental, or ADU |
| units | integer | No | ≥ 1, ≤ 4 | Units in a duplex/triplex (2-4); 3-4 units need 10% down |
| amortizationYears | any | No | Amortization in years: 25 or 30 | |
| province | string | No | Ontario, British Columbia, Alberta, Quebec, Nova Scotia, Manitoba, Saskatchewan, New Brunswick, PEI, Newfoundland and Labrador | Province of the property |
| propertyTaxRatePct | number | No | ≥ 0, ≤ 5 | Annual property tax as a percent of value |
| homeInsuranceAnnual | number | No | ≥ 0 | Annual home insurance in CAD |
| maintenanceMonthly | number | No | ≥ 0 | Monthly maintenance allowance in CAD |
| condoFeesMonthly | number | No | ≥ 0 | Monthly condo or HOA fees in CAD |
| vacancyRatePct | number | No | ≥ 0, ≤ 25 | Vacancy allowance as a percent of rent |
| rentalExpensesMonthly | number | No | ≥ 0 | Monthly costs of renting it out in CAD |
| includeRentalTax | boolean | No | Deduct a rough income-tax estimate on the rent | |
| marginalTaxRatePct | number | No | ≥ 0, ≤ 60 | Marginal tax rate for the rental tax estimate |
| equivalentRentMonthly | number | No | ≥ 0 | Rent you'd pay for a similar home instead, in CAD |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| projectType | string | No | Kitchen Renovation (Minor), Kitchen Renovation (Major), Bathroom Renovation, Basement Finishing, Deck / Patio Addition, Exterior Paint / Siding, Window Replacement, Roof Replacement, Landscaping, Custom / Other | Renovation type (sets the default value added and economic life) |
| renovationCost | number | Yes | ≥ 0 | Renovation cost in CAD |
| currentHomeValue | number | No | ≥ 0 | Home value before the renovation in CAD |
| valueAdded | number | No | ≥ 0 | Value the work adds at completion in CAD; omit to use the type's estimate |
| yearsUntilSale | number | No | ≥ 0, ≤ 30 | Years between finishing the work and selling |
| economicLifeYears | number | No | > 0, ≤ 60 | Years until the work adds nothing; omit for the type's default |
| monthlyNetRent | number | No | ≥ 0 | Net monthly rent the work earns (e.g. a legal suite) in CAD |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| landPurchasePrice | number | Yes | ≥ 0 | Land price in CAD (0 if already owned, with ownsLand) |
| grossFloorAreaSqft | number | Yes | > 0 | Gross floor area in square feet |
| costPerSqft | number | Yes | ≥ 0 | Construction cost per square foot in CAD |
| estimatedSalePrice | number | Yes | ≥ 0 | Expected sale price when finished in CAD |
| projectType | string | No | new-build, gut-renovation, addition, laneway, custom-home, multi-unit | Project type (new builds and custom homes get the HST rebate) |
| province | string | No | Ontario, British Columbia, Alberta, Quebec, Manitoba, Saskatchewan, Nova Scotia, New Brunswick, PEI, Newfoundland, Northwest Territories, Nunavut, Yukon | Province or territory of the project |
| ownsLand | boolean | No | Land is already owned (no purchase or land transfer tax) | |
| constructionMonths | number | No | ≥ 0, ≤ 60 | Construction duration in months |
| sitePrep | number | No | ≥ 0 | Site preparation cost in CAD |
| landscaping | number | No | ≥ 0 | Landscaping cost in CAD |
| financingRatePct | number | No | ≥ 0, ≤ 25 | Construction loan rate as a percent |
| drawSchedulePct | number | No | ≥ 0, ≤ 100 | Average share of costs drawn during the build, percent |
| contingencyPct | number | No | ≥ 0, ≤ 50 | Contingency as a percent of hard + soft costs |
| sellingCommissionPct | number | No | ≥ 0, ≤ 10 | Commission on the sale as a percent |
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.
| Parameter | Type | Required | Allowed values | Description |
|---|---|---|---|---|
| purchasePrice | number | Yes | > 0 | Purchase price of the home in CAD |
| monthlyRent | number | Yes | > 0 | Monthly rent for a comparable home in CAD |
| downPaymentPct | number | No | ≥ 0, ≤ 100 | Down payment as a percent of the price |
| mortgageRatePct | number | No | ≥ 0, ≤ 25 | Annual mortgage rate as a percent |
| amortizationYears | number | No | ≥ 15, ≤ 30 | Amortization in years |
| yearsToStay | integer | No | ≥ 1, ≤ 30 | How many years you plan to stay |
| province | string | No | Ontario, British Columbia, Quebec, Alberta, Manitoba, Nova Scotia, New Brunswick, Saskatchewan, PEI, Newfoundland & Labrador, Northwest Territories, Nunavut, Yukon, Newfoundland and Labrador | Province or territory; sets the land transfer tax |
| city | string | No | City; Toronto adds municipal LTT, Montreal uses its own welcome-tax brackets | |
| landTransferTax | number | No | ≥ 0 | Your own land transfer tax figure in CAD, replacing the computed one |
| isFirstTimeBuyer | boolean | No | Eligible for the first-time buyer land transfer tax rebate | |
| propertyTaxRatePct | number | No | ≥ 0, ≤ 5 | Annual property tax as a percent of value |
| condoFeesMonthly | number | No | ≥ 0 | Monthly condo fees in CAD |
| maintenanceMonthly | number | No | ≥ 0 | Monthly maintenance and repairs in CAD |
| homeInsuranceAnnual | number | No | ≥ 0 | Annual home insurance in CAD |
| rentGrowthPct | number | No | ≥ 0, ≤ 20 | Yearly rent increase as a percent |
| homePriceGrowthPct | number | No | ≥ -10, ≤ 20 | Yearly home price growth as a percent |
| investmentReturnPct | number | No | ≥ 0, ≤ 30 | Yearly return the renter earns on invested savings |
| sellingCostPct | number | No | ≥ 0, ≤ 15 | Cost of selling as a percent of the sale price |
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:
| Tool | source |
|---|---|
| mortgage_payment | https://homecalc.ca/tools/mortgage-payment-calculator |
| minimum_down_payment | https://homecalc.ca/tools/down-payment-calculator |
| land_transfer_tax | https://homecalc.ca/tools/land-transfer-tax-calculator/toronto |
| income_tax | https://homecalc.ca/tools/income-tax-calculator |
| mortgage_penalty | https://homecalc.ca/tools/mortgage-penalty-calculator |
| bc_home_flipping_tax | https://homecalc.ca/tools/house-flip-tax-calculator/bc |
| rent_increase | https://homecalc.ca/tools/rent-increase-calculator |
| capital_gains_tax | https://homecalc.ca/tools/capital-gains-tax-calculator |
| heloc_second_mortgage | https://homecalc.ca/tools/heloc-second-mortgage-calculator |
| mortgage_affordability | https://homecalc.ca/tools/mortgage-affordability-calculator |
| cap_rate | https://homecalc.ca/tools/cap-rate-calculator |
| house_flipping | https://homecalc.ca/tools/house-flipping-calculator |
| mortgage_amortization | https://homecalc.ca/tools/mortgage-amortization-calculator |
| mortgage_stress_test | https://homecalc.ca/tools/mortgage-stress-test-calculator |
| mortgage_prepayment | https://homecalc.ca/tools/mortgage-prepayment-calculator |
| mortgage_renewal | https://homecalc.ca/tools/mortgage-renewal-calculator |
| mortgage_qualifier | https://homecalc.ca/tools/mortgage-qualifier-calculator |
| cmhc_insurance | https://homecalc.ca/tools/cmhc-insurance-calculator |
| second_home_affordability | https://homecalc.ca/tools/second-home-affordability-calculator |
| debt_service_ratio | https://homecalc.ca/tools/debt-service-ratio-calculator |
| debt_to_income | https://homecalc.ca/tools/debt-to-income-calculator |
| reverse_mortgage | https://homecalc.ca/tools/reverse-mortgage-calculator |
| insured_insurable_uninsured | https://homecalc.ca/tools/insured-insurable-uninsured-comparison |
| closing_costs | https://homecalc.ca/tools/closing-cost-calculator |
| capital_cost_allowance | https://homecalc.ca/tools/capital-cost-allowance-calculator |
| real_estate_commission | https://homecalc.ca/tools/real-estate-commission-calculator |
| cost_of_selling | https://homecalc.ca/tools/cost-of-selling-a-house-calculator |
| property_tax | https://homecalc.ca/tools/property-tax-calculator |
| bc_rescission_period | https://homecalc.ca/tools/bc-rescission-period-calculator |
| seventy_percent_rule | https://homecalc.ca/tools/70-percent-rule-calculator |
| house_hacking | https://homecalc.ca/tools/house-hacking-calculator |
| renovation_roi | https://homecalc.ca/tools/renovation-roi-calculator |
| property_development | https://homecalc.ca/tools/property-development-calculator |
| rent_vs_buy | https://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