Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

itr-agent

NPM · ITR-AGENT

Local-first Indian income tax filing agent: ITR form, tax computation, 26AS/AIS reconciliation

Available components

+4 this week 85 Trust /100

Last scanned (22 hours ago)

Scores higher than 77% of npm servers

Category Finance and Payments

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 0 of 3 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to Sagargupta16/itr-agent). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 6 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability72
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 7425 tokens (~464/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 16 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 16 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (16)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

  • 19 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

  • 17 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

  • 15 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

  • 14 Nov 26 0
    • Schema quality: 374 → 464 ▼ functional
    • Dependency health: 0.85 → 1.00 ▲ functional
    • Package version: 0.6.0 → 0.7.0 functional
  • 13 Nov 26 81

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/itr-agent@0.7.0

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo Sagargupta16/itr-agent
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/Sagargupta16/itr-agent/.github/workflows/publish.yml@refs/tags/v0.7.0
Rekor log index 3869573195
Predicate type SLSA build provenance https://slsa.dev/provenance/v1
Subject digest sha512:0fcb56043989ffc532217276f2eb2cde4b811cdeff62c32baf80370e67d6f0a2aee59fe71bb5ddf2b2dd1d5f0ea78da82d351330ff5e5694745eb3254

Background: How many MCP packages publish verified provenance →

Dependencies 3 packages
Packages resolved 3
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 16 exposed · ~7,425 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
compare_regimes ~753

Compute tax under BOTH regimes for the same income and return a side-by-side comparison with the recommended regime and the savings amount. Pass the old-regime deductions you could actually claim; the new regime ignores them. `breakeven` says, from code, the smallest old-regime deductions at which the old regime costs no more than the new one and how much more that is than what was passed (null when no amount gets there). Quote it rather than estimating.

NameTypeReqDescription
ageBandstring–Age band: below60, senior (60-79), superSenior (80+). Affects old-regime exemption only.
deductionsnumber–Old regime only: total Chapter VI-A deductions (80C, 80D, ...) in INR, EXCLUDING employer NPS (use employerNps80CCD2). Ignored under the new regime.
employerNps80CCD2number–Employer's NPS contribution under s.80CCD(2) in INR. Allowed in BOTH regimes (the one Chapter VI-A deduction 115BAC keeps); capped at 14% of salary in the new regime, 10% (private) / 14% (government)…
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
governmentEmployerboolean–Central/State Government employer (raises the old-regime 80CCD(2) cap to 14% for FY 2025-26)
housePropertyLossnumber–Loss under the head house property as a POSITIVE number: home-loan interest on the house you live in, or a let-out property's net loss. Requires housePropertyType. Old regime: set off against other h…
housePropertyTypestring–Required when housePropertyLoss is above 0. 'selfOccupied': the home you live in; its interest is deductible only up to Rs 2,00,000 in the old regime (s.24(b)) and not at all in the new regime (s.115…
housesarray–Optional: every house owned, one entry each, INSTEAD of housePropertyLoss. The tool works out income from house property per regime (nil self-occupied interest under the new regime) and folds it in,…
ltcg112Anumber–Long-term capital gains under section 112A in INR, BEFORE the Rs 1,25,000 exemption
otherIncomenumber–Other normal-rate income in INR (interest, net rent, etc.)
presumptiveBusinessobject–Optional: presumptive business or profession (44AD / 44ADA / 44AE). The tool works out the deemed income and adds it to otherIncome itself.
salaryIncomenumber–Gross salary income in INR, before standard deduction
stcg111Anumber–Short-term capital gains under section 111A (listed equity, STT paid) in INR

No output schema declared.

No examples provided.

compute_house_property ~277

Work out the head "Income from house property" per house from rent, municipal tax and home-loan interest: annual value, the 30% standard deduction (s.24(a)), interest with the self-occupied cap of Rs 2,00,000 shared across self-occupied houses (Rs 30,000 for an older loan; nil under the new regime), pre-construction interest in 5 instalments, and houses past the 2-house self-occupied limit deemed let out (FY 2025-26 figures). compute_tax and compare_regimes take the same `houses` input and fold the result in themselves; use this tool to show the working.

NameTypeReqDescription
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
housesarrayyesEvery house the taxpayer owns, one entry each. The tool works out the head (annual value, 30% standard deduction, capped interest) per regime, so do not also pass housePropertyLoss.
regimestringyesTax regime: self-occupied interest is nil under the new regime (s.115BAC(2)(i)) and capped in the old

No output schema declared.

No examples provided.

compute_hra ~252

HRA exemption per Rule 2A: least of (actual HRA, rent minus 10% of salary, 50% metro / 40% non-metro of salary), computed period-wise. Salary = basic + retirement-forming DA + fixed-percentage turnover commission. Old regime only. Give each period's city: the tool checks it against the fy's rule-pack metro list (FY 2025-26: Delhi, Mumbai, Kolkata, Chennai). Also computes the 80GG alternative for rent payers who received no HRA at any time in the year (the two are mutually exclusive).

NameTypeReqDescription
eightyGGobject–Compute the 80GG alternative instead of HRA (requires: no HRA received at any time in the year)
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27)
periodsarray–Homogeneous periods (amounts are per-period TOTALS, not monthly). Split whenever salary, rent, HRA, or city changes. Required unless eightyGG is supplied.
regimestring–HRA exemption and 80GG are both unavailable under the new regime

No output schema declared.

No examples provided.

compute_interest_234 ~814

Deterministic sections 234A, 234B and 234C interest (FY 2025-26 rates). 234A: 1%/month for filing after the due date, on tax outstanding after all prepaid tax. 234B: 1%/month on assessed-minus-advance when advance < 90% (from 1 April of the AY), reduced by self-assessment payments under s.140A. 234C: per-installment shortfalls with the statutory 12%/36% safe harbors for June/September, measured on tax due on RETURNED income. Rule 119A rounding applied (principal floored to Rs 100, part month = full month). Pass dates (filingDate with form, paidOrAssessedDate, payment dates) and the tool counts the months; month counts are still accepted. Each section is computed only when its own inputs are supplied; anything skipped is named in `skipped`.

NameTypeReqDescription
advanceTaxPaidnumber–Total advance tax paid during the FY, in INR
assessedTaxnumberyes234B base: tax on total income minus TDS/TCS and reliefs, in INR (advance tax is NOT deducted here)
cumulativePaidarray–Cumulative (running-total) advance tax paid by Jun 15 / Sep 15 / Dec 15 / Mar 15, in INR. Required for 234C.
dueDatestring–Explicit s.139(1) due date (YYYY-MM-DD) for 234A, e.g. an audit case. Overrides `form`.
filingDatestring–Date the return is or will be filed (YYYY-MM-DD). Drives 234A (needs `form` or `dueDate`) and, unless paidOrAssessedDate is given, the end of 234B.
formstring–ITR form, used with filingDate to pick the non-audit s.139(1) due date from the rule pack for 234A
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27)
monthsFor234Binteger–Months from 1 April of the AY to the date of payment or assessment (part month = full month). Prefer paidOrAssessedDate or filingDate and let the tool count. Filing on 20 July of the AY is 4.
monthsLateFilinginteger–234A: months from the day after the due date to the date of filing (part month = full month). 0 means filed on time. Prefer filingDate with `form` and let the tool count.
paidOrAssessedDatestring–234B end date (YYYY-MM-DD): when the outstanding tax is paid in full, or the assessment date. Defaults to filingDate. The tool counts the months from 1 April of the AY (Rule 119A, part month = full m…
presumptiveboolean–44AD/44ADA presumptive: a single 100% installment by 03-15 (MM-DD) instead of four
selfAssessmentPaymentsarray–Self-assessment tax paid under s.140A before assessment: each payment stops 234B interest on that amount from its own month (s.234B(2))
taxDueOnReturnedIncomenumber–234C base: tax due on RETURNED income minus TDS/TCS/reliefs, in INR. Defaults to assessedTax when omitted.
taxOutstandingFor234Anumber–234A base: tax outstanding after TDS/TCS, advance tax, AND reliefs, in INR. Defaults to assessedTax minus advanceTaxPaid.
taxOutstandingForms234Anumber–Deprecated misspelling of taxOutstandingFor234A; still accepted.

No output schema declared.

No examples provided.

compute_loss_setoff ~523

Apply current-year and brought-forward losses in statutory order (s.70 within a head, s.71 across heads with the Rs 2,00,000 house-property cap and no business loss against salary, then ss.71B/72/73/74 oldest first) and report each step with its section, income by head after set-off, what is carried forward with the last year it can be used (house property 8, business 8, speculative 4, capital 8 years), what expired, what s.80 forfeits on a late return, and Schedule CYLA/BFLA/CFL rows. `forComputeTax` goes into compute_tax or tax_summary field for field, with nothing added (do not also pass houses there).

NameTypeReqDescription
broughtForwardarray–Losses brought forward from earlier years: one entry per kind and origin year, from last year's Schedule CFL
businessnumber–Business or profession other than speculation (F&O included), net: profit or a NEGATIVE loss, in INR
capitalGainsobject–Capital gains and losses of the year
filedByDueDatebooleanyesThe return for THIS year is filed by the s.139(1) due date. If not, s.80 stops this year's business, speculative and capital losses from being carried forward (house property survives, s.71B). list_t…
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
housePropertynumber–Income from house property for all houses together, in INR: positive income or a NEGATIVE loss (compute_house_property totals.income)
housePropertyTypestring–Which kind of house a house-property LOSS comes from; 'letOut' for a figure from compute_house_property (its caps are already applied)
otherSourcesnumber–Income from other sources at normal rates, in INR
regimestringyesTax regime: no house-property loss crosses heads under the new regime (s.115BAC(2)); run once per regime to compare
salaryIncomenumber–Gross salary before the standard deduction, in INR
speculativenumber–Speculative business (intraday equity), net: profit or a NEGATIVE loss, in INR

No output schema declared.

No examples provided.

compute_presumptive_income ~484

Deemed profit under the presumptive schemes (FY 2025-26 figures): 44AD at 8% of turnover (6% of digital receipts) up to Rs 2,00,00,000, or Rs 3,00,00,000 where cash is at most 5%; 44ADA at 50% of professional receipts up to Rs 50,00,000 / Rs 75,00,000; 44AE per goods carriage per month for up to 10 vehicles. Reports eligibility, the deemed figure with its working, and the income to report (the higher of deemed and declared). compute_tax takes the same `presumptiveBusiness` input and adds the income itself.

NameTypeReqDescription
carriagesarray–44AE: each goods carriage owned in the year (the scheme allows at most 10 at any time)
cashReceiptsWithin5Pctboolean–Cash receipts are at most 5% of the total, which lifts the ceiling to Rs 3,00,00,000 (44AD) or Rs 75,00,000 (44ADA). Required for 44ADA; for 44AD it is worked out from the two turnover figures when l…
declaredProfitnumber–A higher profit the taxpayer declares; the scheme taxes the deemed figure or more
digitalTurnovernumber–44AD: turnover received by account-payee cheque, bank transfer, UPI or other digital modes (deemed profit 6%)
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
grossReceiptsnumber–44ADA: gross professional receipts (deemed profit 50%)
maxCarriagesAtAnyTimeinteger–44AE: the most carriages owned at any one time; defaults to the number listed
otherTurnovernumber–44AD: the rest of turnover, cash included (deemed profit 8%)
schemestringyes44AD: small business on turnover. 44ADA: specified profession on gross receipts. 44AE: goods carriages.

No output schema declared.

No examples provided.

compute_tax ~854

Deterministic Indian income tax computation for a fiscal year. Handles new/old regime slabs, standard deduction, 87A rebate with marginal relief (threshold tested on TOTAL income per the statute; rebate never offsets 111A/112A tax under the new regime), employer NPS under 80CCD(2) in both regimes, house-property loss (self-occupied interest capped by s.24(b), not deductible under 115BAC; set-off capped by s.71(3A); none under 115BAC), 111A/112A capital gains rates with the basic-exemption set-off, surcharge (with the 15% cap on gains and marginal relief), and 4% cess (FY 2025-26 figures). All arithmetic is done in code from a versioned rule pack -- never estimated.

NameTypeReqDescription
ageBandstring–Age band: below60, senior (60-79), superSenior (80+). Affects old-regime exemption only.
deductionsnumber–Old regime only: total Chapter VI-A deductions (80C, 80D, ...) in INR, EXCLUDING employer NPS (use employerNps80CCD2). Ignored under the new regime.
employerNps80CCD2number–Employer's NPS contribution under s.80CCD(2) in INR. Allowed in BOTH regimes (the one Chapter VI-A deduction 115BAC keeps); capped at 14% of salary in the new regime, 10% (private) / 14% (government)…
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
governmentEmployerboolean–Central/State Government employer (raises the old-regime 80CCD(2) cap to 14% for FY 2025-26)
housePropertyLossnumber–Loss under the head house property as a POSITIVE number: home-loan interest on the house you live in, or a let-out property's net loss. Requires housePropertyType. Old regime: set off against other h…
housePropertyTypestring–Required when housePropertyLoss is above 0. 'selfOccupied': the home you live in; its interest is deductible only up to Rs 2,00,000 in the old regime (s.24(b)) and not at all in the new regime (s.115…
housesarray–Optional: every house owned, one entry each, INSTEAD of housePropertyLoss. The tool works out income from house property per regime (nil self-occupied interest under the new regime) and folds it in,…
ltcg112Anumber–Long-term capital gains under section 112A in INR, BEFORE the Rs 1,25,000 exemption
otherIncomenumber–Other normal-rate income in INR (interest, net rent, etc.)
presumptiveBusinessobject–Optional: presumptive business or profession (44AD / 44ADA / 44AE). The tool works out the deemed income and adds it to otherIncome itself.
regimestringyesTax regime. 'new' (115BAC) is the default regime since FY 2023-24.
salaryIncomenumber–Gross salary income in INR, before standard deduction
stcg111Anumber–Short-term capital gains under section 111A (listed equity, STT paid) in INR

No output schema declared.

No examples provided.

filing_checklist ~105

Ordered, form-specific walkthrough for filing ITR-1/2/3/4 on incometax.gov.in: documents to gather, reconciliation, tax computation, portal steps schedule by schedule, and e-verification. Guidance only -- the taxpayer performs the final submit on the portal themselves.

NameTypeReqDescription
formstringyesThe ITR form to file (use recommend_itr_form if unsure)
fystring–Fiscal year, e.g. '2025-26'

No output schema declared.

No examples provided.

list_deductions ~92

Return the old-regime deduction checklist with statutory caps for a fiscal year (80C, 80CCD(1B), 80D tiers, 80TTA/TTB, 24(b), HRA metro list). Useful for estimating the `deductions` input to compute_tax/compare_regimes.

NameTypeReqDescription
fystring–Fiscal year, e.g. '2025-26'

No output schema declared.

No examples provided.

list_tax_years ~173

List the fiscal years this server has rule packs for, with filing deadlines for the current assessment year and `status`: computed from today's date in India, which deadlines have passed, the days left, the phase per ITR form (on time, belated with the s.234F fee, or updated return only), the revised-return window, and the next advance tax instalment of the current financial year. Quote `status` instead of comparing dates yourself. `statutes` gives each year's Act and, for tax year 2026-27 under the Income-tax Act 2025, the map from the 1961 section numbers the notes cite.

NameTypeReqDescription
asOfstring–Date to report the status for (YYYY-MM-DD). Defaults to today in India; pass it only to plan ahead.

No output schema declared.

No examples provided.

parse_ais ~249

Decrypt and parse the AIS JSON export from the income tax portal, entirely on-device. Provide pan + dob (DDMMYYYY) to derive the password, or pass it explicitly. Returns taxpayer info, normalized information rows (TDS entries, SFT transactions) with amounts, dates, and codes extracted by column label, and `totals` summed in code: every section/element/code group with its row count and amount (each group's `key` is what reconcile_documents takes as interestGroups/dividendGroups), and salary per employer TAN from section 192 TDS rows. Never add up rows yourself. The decryption scheme is reverse-engineered from the AIS utility; if it fails, use the portal's CSV export as a fallback and file an issue.

NameTypeReqDescription
dobstring–Date of birth as DDMMYYYY (or DD-MM-YYYY); date of incorporation for non-individuals. NOT ISO YYYY-MM-DD.
panstring–PAN (used to derive the decryption password)
passwordstring–Explicit decryption password (overrides pan+dob derivation)
pathstringyesAbsolute path to the downloaded AIS .json file

No output schema declared.

No examples provided.

parse_form26as ~125

Parse the caret-delimited Form 26AS TEXT export from TRACES into structured TDS entries (deductor, TAN, section, amounts, booking status) with totals, plus TCS rows (206C*) separated into tcsEntries. Reports creditableTdsDeposited (status F rows only) alongside the raw total. Download the 'Text' format from TRACES (the archive opens with your DOB as DDMMYYYY); PDF exports are not supported.

NameTypeReqDescription
pathstringyesAbsolute path to the 26AS .txt file downloaded from TRACES

No output schema declared.

No examples provided.

recommend_itr_form ~962

Recommend ITR-1/2/3/4 for an individual from income heads, residency, losses, and disqualifier flags, with rule-by-rule reasoning. Loss-continuity aware: brought-forward business/speculative losses force ITR-3 even with zero current-year business income (Schedule CFL). Checks the 44AD/44ADA turnover ceilings when presumptiveTurnover is supplied, the 44AE vehicle limit when vehicles44AE is supplied, and the ITR-1/ITR-4 house-property limit (2 for AY 2026-27). Returns the filing deadline with its statutory citation, the belated and revised deadlines, and the 234F late fee.

NameTypeReqDescription
agriIncomenumber–Agricultural income in INR (above Rs 5,000 rules out ITR-1/ITR-4)
businessLossboolean–Non-speculative business loss (incl. F&O) brought forward or arising this year
capitalLossboolean–Capital loss (STCL/LTCL) brought forward or to carry forward
cashReceiptsWithin5Pctboolean–Cash receipts are at most 5% of turnover/receipts (lifts the 44AD/44ADA ceiling to Rs 3,00,00,000 / Rs 75,00,000 for FY 2025-26)
esopDeferralboolean–Tax deferred on eligible-startup ESOPs (s80-IAC)
fystring–Fiscal year, e.g. '2025-26'
hasBusinessIncomeboolean–Any business or professional income this year, incl. F&O trading and freelancing
hasForeignAssetsOrIncomeboolean–Foreign assets/income incl. vested RSUs or ESPP of a foreign parent (Schedule FA)
hasLotteryOrGamingIncomeboolean–Winnings from lottery, online games, or racehorses
hasNonPresumptiveBusinessboolean–Also has business/professional income OUTSIDE the presumptive scheme (ITR-4 cannot carry both)
hasOtherCapitalGainsboolean–Capital gains outside 111A/112A: property, debt MF, unlisted or foreign shares
holdsUnlistedSharesboolean–Held unlisted equity shares during the FY
housePropertiesinteger–Number of house properties with income or loss (ITR-1/ITR-4 admit up to 2 for AY 2026-27)
housePropertyLossboolean–House property loss to carry forward
isDirectorboolean–Director in any company during the FY
isPartnerInFirmboolean–Partner in a partnership firm
ltcg112Anumber–LTCG under 112A in INR before the Rs 1,25,000 exemption
presumptiveboolean–Opting for presumptive taxation (44AD/44ADA/44AE)
presumptiveSchemestring–Which presumptive section (drives the turnover ceiling check; defaults to 44AD)
presumptiveTurnovernumber–44AD turnover or 44ADA gross receipts in INR. Above Rs 2,00,00,000 (Rs 3,00,00,000 with cash receipts within 5%) / Rs 50,00,000 (Rs 75,00,000) the scheme lapses and ITR-3 with audit applies (FY 2025-…
residencystring–Residential status for the FY (RNOR/NRI cannot file ITR-1/ITR-4)
speculativeLossboolean–Speculative (intraday equity) loss brought forward or arising this year
stcg111Anumber–STCG under 111A in INR (any amount rules out ITR-1/ITR-4)
tds194Nboolean–TDS was deducted under s.194N on cash withdrawals (rules out ITR-1)
totalIncomenumberyesEstimated TOTAL income in INR, i.e. after Chapter VI-A deductions -- this is the figure the Rs 50,00,000 ITR-1/ITR-4 ceiling tests (AY 2026-27). Use the gross figure only if you have no deductions.
vehicles44AEinteger–44AE only: the most goods carriages owned at any time in the year (the scheme allows up to 10). Omit to skip the check.

No output schema declared.

No examples provided.

reconcile_documents ~395

Cross-document mismatch report -- the checks that pre-empt 143(1)(a) intimations and 139(9) defect notices: TDS claimed vs 26AS deposited (the ledger of record), missing-employer detection, AIS interest/dividend vs declared, Form 16 vs 26AS per-TAN totals, declared salary below the Form 16 total, and 26AS rows missing the gross amount. Also groups 26AS TDS by income head so each credit can be placed in the right schedule. Prefer the file inputs: form26asPath reads the 26AS export itself, and aisFile decrypts the AIS and sums the groups you name, so no row or total is copied by hand. Pass whichever documents you have; checks needing missing inputs are reported as skipped.

NameTypeReqDescription
aisobject–AIS aggregates, when you have figures rather than the file. Take them from parse_ais `totals` (summed in code), never by adding rows yourself; prefer aisFile.
aisFileobject–The AIS export itself: salary by TAN is taken from section 192 TDS rows, and interest/dividend are the code-summed totals of the groups you name. Any figure given in `ais` overrides the file's.
form16array–Per-employer Form 16 Part A figures
form26asPathstring–Absolute path to the 26AS TRACES Text export (.txt). Parsed here, so the rows never pass through your arguments. Use instead of form26asTds.
form26asTdsarray–TDS entries from parse_form26as (tdsEntries, not tcsEntries)
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27)
returnobject–Figures from the draft return

No output schema declared.

No examples provided.

schedule_advance_tax ~166

Build the advance tax installment plan (06-15 at 15%, 09-15 at 45%, 12-15 at 75%, 03-15 at 100% cumulative, MM-DD, FY 2025-26) for an estimated tax liability net of TDS. Reports per-installment amounts and shortfalls against what has been paid so far.

NameTypeReqDescription
estimatedTaxnumberyesEstimated total tax liability for the FY in INR (use compute_tax first)
fystring–Fiscal year, e.g. '2025-26'
paidSoFararray–Advance tax already paid per installment, in order
tdsExpectednumber–TDS/TCS expected to be deducted during the year in INR

No output schema declared.

No examples provided.

tax_summary ~1,201

One computation of what is payable or refundable for the year: tax (compute_tax, with houses and presumptiveBusiness folded in), less TDS and TCS read from the Form 26AS file itself (creditable status F rows), advance tax and self-assessment tax, plus s.234A, s.234B and s.234C interest with every month count taken from the dates, and the s.234F fee (Rs 5,000, Rs 1,000 up to Rs 5,00,000 of income) when filed after the due date. The due date comes from the rule pack by form; the filing date defaults to today in India. Net is rounded under s.288B; negative is a refund. Use this instead of subtracting TDS or counting months yourself.

NameTypeReqDescription
advanceTaxPaymentsarray–Each advance tax payment made during the FY, with its date; the tool works out s.234B and s.234C from them
ageBandstring–Age band: below60, senior (60-79), superSenior (80+). Affects old-regime exemption only.
businessIncomeboolean–Whether any of the income is from business or profession (counted in otherIncome). Required for a senior or super senior without presumptiveBusiness: a resident senior with none owes no advance tax (…
deductionsnumber–Old regime only: total Chapter VI-A deductions (80C, 80D, ...) in INR, EXCLUDING employer NPS (use employerNps80CCD2). Ignored under the new regime.
dueDatestring–Explicit s.139(1) due date (YYYY-MM-DD), e.g. for an audit case. Overrides `form`.
employerNps80CCD2number–Employer's NPS contribution under s.80CCD(2) in INR. Allowed in BOTH regimes (the one Chapter VI-A deduction 115BAC keeps); capped at 14% of salary in the new regime, 10% (private) / 14% (government)…
filingDatestring–Date the return is or will be filed (YYYY-MM-DD); defaults to today in India
formstring–ITR form, to take the non-audit s.139(1) due date from the rule pack (use recommend_itr_form if unsure)
form26asPathstring–Absolute path to the Form 26AS Text export from TRACES. Preferred: the tool takes TDS credit as the creditable (status F) total and TCS from Part VI itself.
fystring–Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
governmentEmployerboolean–Central/State Government employer (raises the old-regime 80CCD(2) cap to 14% for FY 2025-26)
housePropertyLossnumber–Loss under the head house property as a POSITIVE number: home-loan interest on the house you live in, or a let-out property's net loss. Requires housePropertyType. Old regime: set off against other h…
housePropertyTypestring–Required when housePropertyLoss is above 0. 'selfOccupied': the home you live in; its interest is deductible only up to Rs 2,00,000 in the old regime (s.24(b)) and not at all in the new regime (s.115…
housesarray–Optional: every house owned, one entry each, INSTEAD of housePropertyLoss. The tool works out income from house property per regime (nil self-occupied interest under the new regime) and folds it in,…
ltcg112Anumber–Long-term capital gains under section 112A in INR, BEFORE the Rs 1,25,000 exemption
otherIncomenumber–Other normal-rate income in INR (interest, net rent, etc.)
presumptiveBusinessobject–Optional: presumptive business or profession (44AD / 44ADA / 44AE). The tool works out the deemed income and adds it to otherIncome itself.
regimestringyesTax regime. 'new' (115BAC) is the default regime since FY 2023-24.
salaryIncomenumber–Gross salary income in INR, before standard deduction
selfAssessmentPaymentsarray–Self-assessment tax (s.140A) paid after the FY, each with its date; each stops s.234B on its amount from that month
stcg111Anumber–Short-term capital gains under section 111A (listed equity, STT paid) in INR
tcsCreditnumber–Only without form26asPath: TCS credit in INR (default 0)
tdsCreditnumber–Only without form26asPath: TDS credit in INR, e.g. from Form 16 Part A. 0 when no tax was deducted.

No output schema declared.

No examples provided.

Install

How do I install the itr-agent MCP server?

itr-agent runs locally as an npm package, launched with npx -y itr-agent. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · itr-agent

# add to Claude Code
claude mcp add sagargupta16-itr-agent -- npx -y itr-agent
Common questions

What is the itr-agent MCP server?

itr-agent is an MCP server listed in the public MCP registry as io.github.Sagargupta16/itr-agent. Local-first Indian income tax filing agent: ITR form, tax computation, 26AS/AIS reconciliation. This page covers its npm package (itr-agent).

Is the itr-agent MCP server safe to use?

itr-agent scores 85 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the itr-agent MCP server expose?

itr-agent exposes 16 tools: compute_tax, compare_regimes, schedule_advance_tax, list_deductions, parse_form26as, and 11 more. Their descriptions and schemas cost roughly 7,425 tokens of context every time the server is loaded.

Is the itr-agent MCP server still maintained?

itr-agent is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the itr-agent MCP server under?

itr-agent declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the itr-agent MCP server?

VerifyMCP ran 16 checks on itr-agent, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.