TrueCalci

India advance tax instalments

advance_tax

Read-onlyIdempotent

Calculate Indian advance tax instalments and the interest for late or short payment (Sections 234A, 234B and 234C; sections 207-211). Instalment deadlines: 15% by 15 June, 45% by 15 September, 75% by 15 December, 100% by 15 March (presumptive 44AD/44ADA: 100% by 15 March). Pass the payments actually made and the filing date to get the interest; without them every instalment is treated as unpaid.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`as_of_date`	Yes	Civil date YYYY-MM-DD. Selects the rule pack in force on that date. Required: the engine will not assume a date.
`assessed_tax`	Yes	Total tax on the year's income in INR (₹), before advance tax and before TDS/TCS credit. Advance tax applies when the balance after TDS/TCS is ₹10,000 or more.
`tds_tcs_credit`	No	Tax already deducted or collected at source for the year (₹). Default 0.
`filing_category`	No	Sets the return due date. non_audit_individual (ITR-1/ITR-2): 31 July. non_audit_business (business or profession, accounts not audited, and such firms' partners): 31 August from tax year 2026-27, 31 July before. audit_corporate_and_business: 31 October. transfer_pricing_international: 30 November.	non_audit_individual
`advance_tax_paid`	No	Advance tax payments made, each with its date. Omit if none were made.
`capital_gains_tax`	No	Part of assessed_tax that arises on capital gains (₹); excluded from instalments due before the gain arose.
`date_of_filing_or_payment`	No	Date the return was (or will be) filed, YYYY-MM-DD. Ends the Section 234B period and decides whether Section 234A applies. Default: the return due date for filing_category.
`is_presumptive_44ad_44ada`	No	True if income is declared under presumptive taxation (44AD/44ADA): one instalment of 100% by 15 March.
`is_senior_citizen_no_business`	No	True for a resident senior citizen (60+) with no business or professional income: exempt from advance tax.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`trace`	No
`status`	No
`currency`	No
`as_of_date`	No
`disclaimer`	No
`minor_units`	No
`rule_ids_used`	No
`financial_year`	No
`is_presumptive`	No
`tds_tcs_credit`	No
`assessment_year`	No
`return_due_date`	No
`gross_assessed_tax`	No
`instalment_details`	No
`total_amount_payable`	No
`unpaid_tax_principal`	No
`advance_tax_applicable`	No
`filing_or_payment_date`	No
`total_advance_tax_paid`	No
`total_interest_payable`	No
`section_234a_applicable`	No
`section_234b_applicable`	No
`net_advance_tax_base_s208`	No
`section_234a_months_charged`	No
`section_234b_months_charged`	No
`total_section_234a_interest`	No
`total_section_234b_interest`	No
`total_section_234c_interest`	No
`exemption_or_applicability_reason`	No
`section_234b_threshold_90_percent`	No
`section_234a_shortfall_base_rule119a`	No
`section_234b_shortfall_base_rule119a`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 27, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "advance_tax_applicable": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "as_of_date": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "assessment_year": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "currency": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "disclaimer": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "exemption_or_applicability_reason": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "filing_or_payment_date": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "financial_year": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "gross_assessed_tax": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "instalment_details": {
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "is_presumptive": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "minor_units": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "net_advance_tax_base_s208": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "return_due_date": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "rule_ids_used": {
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "section_234a_applicable": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "section_234a_months_charged": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "section_234a_shortfall_base_rule119a": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "section_234b_applicable": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "section_234b_months_charged": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "section_234b_shortfall_base_rule119a": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "section_234b_threshold_90_percent": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "status": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "tds_tcs_credit": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "total_advance_tax_paid": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "total_amount_payable": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "total_interest_payable": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "total_section_234a_interest": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "total_section_234b_interest": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "total_section_234c_interest": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    },
+    "trace": {
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "unpaid_tax_principal": {
+      "type": [
+        "string",
+        "number",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Changed8 schema fields changedSep 27, 2026

addedInput schema / properties / advance_tax_paid

Added value: +{
+  "description": "Advance tax payments made, each with its date. Omit if none were made.",
+  "items": {
+    "properties": {
+      "amount": {
+        "description": "Amount paid (₹).",
+        "pattern": "^\\d+\\.\\d{2}$",
+        "type": "string"
+      },
+      "date": {
+        "description": "Payment date, YYYY-MM-DD.",
+        "format": "date",
+        "type": "string"
+      }
+    },
+    "required": [
+      "date",
+      "amount"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedInput schema / properties / assessed_tax / description

Previous value: -"Estimated total annual net tax liability after TDS/TCS credits in INR (₹). Advance tax mandatory if >= ₹10,000."New value: +"Total tax on the year's income in INR (₹), before advance tax and before TDS/TCS credit. Advance tax applies when the balance after TDS/TCS is ₹10,000 or more."

addedInput schema / properties / capital_gains_tax

Added value: +{
+  "description": "Part of assessed_tax that arises on capital gains (₹); excluded from instalments due before the gain arose.",
+  "pattern": "^\\d+\\.\\d{2}$",
+  "type": "string"
+}

addedInput schema / properties / date_of_filing_or_payment

Added value: +{
+  "description": "Date the return was (or will be) filed, YYYY-MM-DD. Ends the Section 234B period and decides whether Section 234A applies. Default: the return due date for filing_category.",
+  "format": "date",
+  "type": "string"
+}

addedInput schema / properties / filing_category

Added value: +{
+  "default": "non_audit_individual",
+  "description": "Sets the return due date. non_audit_individual (ITR-1/ITR-2): 31 July. non_audit_business (business or profession, accounts not audited, and such firms' partners): 31 August from tax year 2026-27, 31 July before. audit_corporate_and_business: 31 October. transfer_pricing_international: 30 November.",
+  "enum": [
+    "non_audit_individual",
+    "non_audit_business",
+    "audit_corporate_and_business",
+    "transfer_pricing_international"
+  ],
+  "type": "string"
+}

addedInput schema / properties / is_presumptive_44ad_44ada

Added value: +{
+  "description": "True if income is declared under presumptive taxation (44AD/44ADA): one instalment of 100% by 15 March.",
+  "type": "boolean"
+}

addedInput schema / properties / is_senior_citizen_no_business

Added value: +{
+  "description": "True for a resident senior citizen (60+) with no business or professional income: exempt from advance tax.",
+  "type": "boolean"
+}

addedInput schema / properties / tds_tcs_credit

Added value: +{
+  "description": "Tax already deducted or collected at source for the year (₹). Default 0.",
+  "pattern": "^\\d+\\.\\d{2}$",
+  "type": "string"
+}

Changed2 schema fields changedSep 26, 2026

addedInput schema / properties / as_of_date

Added value: +{
+  "description": "Civil date YYYY-MM-DD. Selects the rule pack in force on that date. Required: the engine will not assume a date.",
+  "example": "2026-09-26",
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "assessed_tax"
-]New value: +[
+  "assessed_tax",
+  "as_of_date"
+]

Changed3 schema fields changedSep 26, 2026
- addedInput schema / properties / assessed_tax / example
```
Added value: +"150000.00"
```
- addedInput schema / properties / assessed_tax / pattern
```
Added value: +"^\\d+\\.\\d{2}$"
```
- changedInput schema / properties / assessed_tax / type
```
Previous value: -"number"New value: +"string"
```
AddedSep 11, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations already declare readOnlyHint/idempotent/non-destructive, so safety is covered. The description adds a genuinely useful behavioural default beyond the structured fields: 'without them every instalment is treated as unpaid', clarifying the consequence of omitting advance_tax_paid. It does not describe output shape, but an output schema exists.

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

Conciseness4/5

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

Three sentences, purpose front-loaded, then the instalment rules, then the default-behaviour caveat. Dense but nearly every clause carries information; the parenthetical deadline list is compact. Slightly crowded but no filler.

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

Completeness5/5

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

With an output schema present the description needn't explain return values, and annotations cover the safety profile. The description supplies the statutory rules and the key default (unpaid instalments) needed to invoke the 9-parameter tool correctly, so nothing essential is missing for a read-only calculator.

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 description coverage is 100%, so the baseline is 3 and the schema carries the parameter detail. The description nonetheless adds domain meaning the schema lacks, namely the instalment percentages and deadlines (15%/45%/75%/100%) and the presumptive 44AD/44ADA single-instalment rule, which help the agent reason about the parameters.

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

Purpose5/5

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

States a specific verb ('Calculate') and resource ('Indian advance tax instalments and the interest for late or short payment') with statutory grounding in Sections 234A/234B/234C and 207-211. An agent can distinguish this from the sibling tax tools (tax_in, tds, tcs, gst_regular) without opening any schema.

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?

Explicitly tells the agent to 'Pass the payments actually made and the filing date to get the interest', which is actionable guidance on inputs. It also lays out the deadline schedule so the agent understands what the tool models, but it stops short of naming when to prefer a sibling (e.g., tax_in for a plain income-tax computation) or any explicit exclusion.

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

All TrueCalci tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?