Skip to main content
Glama

AVnester — Indian Real Estate Intelligence

Optimize home-loan tax regime (calculator)

optimize_home_loan_tax_regime
Read-onlyIdempotent

Compare a home-loan borrower's income tax under the OLD vs NEW regime (tax year 2026-27, Income-tax Act, 2025) and recommend which regime saves more income tax. Deterministic slab math — not tax advice. Use when the user asks "old or new tax regime", "home-loan tax benefit", or "section 80C / 24(b) deduction". Models interest (s.22, old 24(b)) + principal (s.123, old 80C); a joint loan is the user's own share. The response lists benefits it does NOT model. Includes a disclaimer field to show.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "annualIncome": "<annualIncome>",
      "homeLoanInterest": "<homeLoanInterest>",
      "homeLoanPrincipal": "<homeLoanPrincipal>"
    },
    "name": "optimize_home_loan_tax_regime"
  }
}

Input Schema

NameRequiredDescriptionDefault
ageBandNoTaxpayer age band — raises the OLD-regime basic exemption (senior 60–80 → ₹3L, super-senior 80+ → ₹5L). New regime unaffected. Defaults to below60.
other80CNoOther s.123 (old 80C) investments in INR (PF, ELSS, insurance, etc.).
jointLoanNoJoint loan: amounts are the whole loan's; result is the user's own share (equal split).
saleValueNoNRI only — sale consideration in INR for the TDS computation.
annualRentNoAnnual rent received in INR for let_out (taken as 0 if omitted).
isSalariedNoWhether the taxpayer is salaried (gets the standard deduction).
hasForm15CBNoNRI only — whether Form 15CB CA-attestation is already in hand.
indexedCostNoNRI only — cost of acquisition (unindexed for an NRI). When omitted, TDS computed on full sale value.
annualIncomeYesAnnual gross income in INR EXCLUDING house property (salary + other income).
propertyTypeNoWhether the property is self-occupied or let out.self_occupied
holdingMonthsNoNRI only — holding period in months. ≤24 is STCG; >24 is LTCG.
nroBalanceUsdNoNRI only — NRO account balance in USD equivalent for the repatriation cap math.
ytdRemittedUsdNoNRI only — FY-to-date USD already remitted under the $1M cap.
residencyStatusNoDefault resident. Pass nri to get TDS (s.393(2), old §195) + LRS-cap math in the response.
homeLoanInterestYesAnnual home-loan interest paid (INR).
homeLoanPrincipalYesAnnual home-loan principal repaid (INR) — counts toward s.123 (old 80C).
countryOfResidenceNoNRI only — DTAA article lookup hint. Free-form country name.
otherOldRegimeDeductionsNoOther OLD-regime-only deductions as a lump (HRA exemption, 80D, NPS 80CCD(1B), etc.).

Output Schema

NameRequiredDescriptionDefault
newYes
nriNo
oldYes
cardsYes
notesNo
lawBasisNo
jointLoanYes
disclaimerYes
notModeledYes
assumptionsYes
attributionYes
recommendedYes
annualIncomeYes
annualSavingYes
propertyTypeYes
residencyStatusNo
homeLoanTaxBenefitOldYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • changedInput schema / properties / annualRent / description
      Previous value: -"Annual rent received in INR — required for let_out."New value: +"Annual rent received in INR for let_out (taken as 0 if omitted)."
    • changedInput schema / properties / homeLoanPrincipal / description
      Previous value: -"Annual home-loan principal repaid (INR) — counts toward 80C."New value: +"Annual home-loan principal repaid (INR) — counts toward s.123 (old 80C)."
    • changedInput schema / properties / indexedCost / description
      Previous value: -"NRI only — indexed cost of acquisition (LTCG). When omitted, TDS computed on full sale value."New value: +"NRI only — cost of acquisition (unindexed for an NRI). When omitted, TDS computed on full sale value."
    • changedInput schema / properties / jointLoan / description
      Previous value: -"Joint loan with a co-borrower — doubles the 80C/24b caps (equal-split assumption)."New value: +"Joint loan: amounts are the whole loan's; result is the user's own share (equal split)."
    • changedInput schema / properties / other80C / description
      Previous value: -"Other 80C investments in INR (PF, ELSS, insurance, etc.)."New value: +"Other s.123 (old 80C) investments in INR (PF, ELSS, insurance, etc.)."
    • changedInput schema / properties / residencyStatus / description
      Previous value: -"Default resident. Pass nri to get §195 TDS + LRS-cap math in the response."New value: +"Default resident. Pass nri to get TDS (s.393(2), old §195) + LRS-cap math in the response."
    • changedInput schema / properties / saleValue / description
      Previous value: -"NRI only — sale consideration in INR for §195 TDS computation."New value: +"NRI only — sale consideration in INR for the TDS computation."
    • addedOutput schema / properties / lawBasis
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / notes
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / nri / properties / tds / properties / notes
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / nri / properties / tds / properties / taxSurchargePct
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / nri / properties / tds / properties / tdsSurchargePct
      Added value: +{
      +  "type": "number"
      +}
  2. Changed2 schema fields changed
    • addedOutput schema / properties / cards
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "data": {
      +        "additionalProperties": {},
      +        "type": "object"
      +      },
      +      "priority": {
      +        "type": "integer"
      +      },
      +      "template": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "template",
      +      "data",
      +      "priority"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "annualIncome",
      -  "propertyType",
      -  "jointLoan",
      -  "old",
      -  "new",
      -  "recommended",
      -  "annualSaving",
      -  "homeLoanTaxBenefitOld",
      -  "notModeled",
      -  "assumptions",
      -  "attribution",
      -  "disclaimer"
      -]New value: +[
      +  "annualIncome",
      +  "propertyType",
      +  "jointLoan",
      +  "old",
      +  "new",
      +  "recommended",
      +  "annualSaving",
      +  "homeLoanTaxBenefitOld",
      +  "notModeled",
      +  "assumptions",
      +  "attribution",
      +  "disclaimer",
      +  "cards"
      +]
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "annualIncome": {
      +      "type": "integer"
      +    },
      +    "annualSaving": {
      +      "type": "integer"
      +    },
      +    "assumptions": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "notTaxAdvice": {
      +          "enum": [
      +            true
      +          ]
      +        },
      +        "regimeYear": {
      +          "enum": [
      +            "FY2026-27"
      +          ]
      +        },
      +        "section80EEAExcluded": {
      +          "enum": [
      +            true
      +          ]
      +        },
      +        "surchargeNotModeled": {
      +          "enum": [
      +            true
      +          ]
      +        }
      +      },
      +      "required": [
      +        "regimeYear",
      +        "surchargeNotModeled",
      +        "section80EEAExcluded",
      +        "notTaxAdvice"
      +      ],
      +      "type": "object"
      +    },
      +    "attribution": {
      +      "enum": [
      +        "AVnester"
      +      ]
      +    },
      +    "disclaimer": {
      +      "type": "string"
      +    },
      +    "homeLoanTaxBenefitOld": {
      +      "type": "integer"
      +    },
      +    "jointLoan": {
      +      "type": "boolean"
      +    },
      +    "new": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "deductionsApplied": {
      +          "type": "integer"
      +        },
      +        "taxableIncome": {
      +          "type": "integer"
      +        },
      +        "totalTax": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "taxableIncome",
      +        "totalTax",
      +        "deductionsApplied"
      +      ],
      +      "type": "object"
      +    },
      +    "notModeled": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "nri": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "countryOfResidence": {
      +          "type": "string"
      +        },
      +        "dtaaNote": {
      +          "type": "string"
      +        },
      +        "repatriation": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "availableUsd": {
      +              "type": "number"
      +            },
      +            "capUsd": {
      +              "type": "number"
      +            },
      +            "disclaimer": {
      +              "type": "string"
      +            },
      +            "notModeled": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "requiresCA": {
      +              "type": "boolean"
      +            }
      +          },
      +          "required": [
      +            "availableUsd",
      +            "capUsd",
      +            "requiresCA",
      +            "notModeled",
      +            "disclaimer"
      +          ],
      +          "type": "object"
      +        },
      +        "tds": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "disclaimer": {
      +              "type": "string"
      +            },
      +            "form13EligibilityHint": {
      +              "type": "boolean"
      +            },
      +            "ltcgTax": {
      +              "type": "number"
      +            },
      +            "notModeled": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "section195Rate": {
      +              "type": "number"
      +            },
      +            "stcgTax": {
      +              "type": "number"
      +            },
      +            "tdsAmount": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "section195Rate",
      +            "tdsAmount",
      +            "ltcgTax",
      +            "stcgTax",
      +            "form13EligibilityHint",
      +            "notModeled",
      +            "disclaimer"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "countryOfResidence",
      +        "dtaaNote"
      +      ],
      +      "type": "object"
      +    },
      +    "old": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "deductionsApplied": {
      +          "type": "integer"
      +        },
      +        "taxableIncome": {
      +          "type": "integer"
      +        },
      +        "totalTax": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "taxableIncome",
      +        "totalTax",
      +        "deductionsApplied"
      +      ],
      +      "type": "object"
      +    },
      +    "propertyType": {
      +      "enum": [
      +        "self_occupied",
      +        "let_out"
      +      ],
      +      "type": "string"
      +    },
      +    "recommended": {
      +      "enum": [
      +        "old",
      +        "new"
      +      ],
      +      "type": "string"
      +    },
      +    "residencyStatus": {
      +      "enum": [
      +        "nri"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "annualIncome",
      +    "propertyType",
      +    "jointLoan",
      +    "old",
      +    "new",
      +    "recommended",
      +    "annualSaving",
      +    "homeLoanTaxBenefitOld",
      +    "notModeled",
      +    "assumptions",
      +    "attribution",
      +    "disclaimer"
      +  ],
      +  "type": "object"
      +}
  4. Changed10 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedInput schema / properties / annualIncome / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / annualRent / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / holdingMonths / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / homeLoanInterest / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / homeLoanPrincipal / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / indexedCost / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / other80C / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / otherOldRegimeDeductions / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / saleValue / maximum
      Removed value: -9007199254740991
  5. Changed8 schema fields changed
    • addedInput schema / properties / countryOfResidence
      Added value: +{
      +  "description": "NRI only — DTAA article lookup hint. Free-form country name.",
      +  "maxLength": 50,
      +  "type": "string"
      +}
    • addedInput schema / properties / hasForm15CB
      Added value: +{
      +  "description": "NRI only — whether Form 15CB CA-attestation is already in hand.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / holdingMonths
      Added value: +{
      +  "description": "NRI only — holding period in months. ≤24 is STCG; >24 is LTCG.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / indexedCost
      Added value: +{
      +  "description": "NRI only — indexed cost of acquisition (LTCG). When omitted, TDS computed on full sale value.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / nroBalanceUsd
      Added value: +{
      +  "description": "NRI only — NRO account balance in USD equivalent for the repatriation cap math.",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / residencyStatus
      Added value: +{
      +  "description": "Default resident. Pass nri to get §195 TDS + LRS-cap math in the response.",
      +  "enum": [
      +    "resident",
      +    "nri"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / saleValue
      Added value: +{
      +  "description": "NRI only — sale consideration in INR for §195 TDS computation.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / ytdRemittedUsd
      Added value: +{
      +  "description": "NRI only — FY-to-date USD already remitted under the $1M cap.",
      +  "minimum": 0,
      +  "type": "number"
      +}
  6. Added

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (which already declare this a read-only, idempotent, closed-world calculation), it discloses that the math is deterministic slab logic rather than advice, exactly which sections it models (s.22 / old 24(b) for interest, s.123 / old 80C for principal), that joint-loan amounts are split to the user's own share, that the response enumerates benefits it does NOT model, and that a disclaimer field is returned for display.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core compare-and-recommend purpose, then trigger phrases, then modeling scope, then disclosure caveats. Every clause carries distinct information despite the dense semicolon structure; nothing is repeated from the title or schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and annotations covering the safety profile, the description only needs to frame scope and limits, which it does well, including an explicit statement of unmodeled benefits. The one real omission is that it never mentions the NRI branch, even though residencyStatus switches on TDS and repatriation-cap math that materially changes the response.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds meaning the schema does not: it ties homeLoanInterest to s.22/24(b) and homeLoanPrincipal to s.123/80C, telling the agent which statutory treatment each numeric input feeds. It says nothing about the eight NRI-scoped parameters (residency, TDS, LRS/USD fields), leaving that half of the surface to the schema alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb pair (compare and recommend) against a specific resource: a borrower's income tax under the old vs new regime, with tax year (2026-27) and statute (Income-tax Act, 2025) named. That is far more concrete than the sibling property tools (affordability, prepayment, balance transfer), but no sibling is named, so differentiation is inferred rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It supplies explicit trigger utterances ('old or new tax regime', 'home-loan tax benefit', 'section 80C / 24(b) deduction'), which cleanly signal when to select it. It offers no when-not guidance or named alternative, so a user asking a broader property-finance question gets no routing hint.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources