# itr-agent (npm · itr-agent)

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

- Trust score: 85/100 (high trust)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- npm · `itr-agent`: 85/100 (this document), [markdown](https://verifymcp.io/servers/sagargupta16-itr-agent/itr-agent.md), [page](https://verifymcp.io/servers/sagargupta16-itr-agent/itr-agent)

## Channel facts

- Registry: `npm`
- Package: `itr-agent`
- Version: `0.7.0`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 0 of 3 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to Sagargupta16/itr-agent).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 6 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 72/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 16 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 16 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## 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.

### Claude

```bash
claude mcp add sagargupta16-itr-agent -- npx -y itr-agent
```

### Cursor

```json
{
  "mcpServers": {
    "sagargupta16-itr-agent": {
      "command": "npx",
      "args": [
        "-y",
        "itr-agent"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "sagargupta16-itr-agent": {
      "command": "npx",
      "args": [
        "-y",
        "itr-agent"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add sagargupta16-itr-agent -- npx -y itr-agent
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sagargupta16-itr-agent": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "itr-agent"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sagargupta16-itr-agent --command npx --arg -y --arg itr-agent
```

### Hermes

```yaml
mcp_servers:
  sagargupta16-itr-agent:
    command: "npx"
    args: ["-y", "itr-agent"]
```

### Netclaw

```json
{
  "McpServers": {
    "sagargupta16-itr-agent": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "itr-agent"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add sagargupta16-itr-agent -t stdio -c npx -a -y itr-agent
```

### Other

```json
{
  "mcpServers": {
    "sagargupta16-itr-agent": {
      "command": "npx",
      "args": [
        "-y",
        "itr-agent"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 85, +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.

### 2026-11-19 (score 84, +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.

### 2026-11-17 (score 83, +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.

### 2026-11-15 (score 82, +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.

### 2026-11-14 (score 81, 0)

- [functional regression] Schema quality: 374 → 464
- [functional improvement] Dependency health: 0.85 → 1.00
- [functional] Package version: 0.6.0 → 0.7.0

### 2026-11-13 (score 81)

First indexed and scored.

## MCP tools (16)

### `compute_tax` (~854 tokens)

Compute Indian income tax

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.

Input parameters:

- `ageBand` (string): Age band: below60, senior (60-79), superSenior (80+). Affects old-regime exemption only.
- `deductions` (number): Old regime only: total Chapter VI-A deductions (80C, 80D, ...) in INR, EXCLUDING employer NPS (use employerNps80CCD2). Ignored under the new regime.
- `employerNps80CCD2` (number): 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)…
- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
- `governmentEmployer` (boolean): Central/State Government employer (raises the old-regime 80CCD(2) cap to 14% for FY 2025-26)
- `housePropertyLoss` (number): 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…
- `housePropertyType` (string): 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…
- `houses` (array): 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,…
- `ltcg112A` (number): Long-term capital gains under section 112A in INR, BEFORE the Rs 1,25,000 exemption
- `otherIncome` (number): Other normal-rate income in INR (interest, net rent, etc.)
- `presumptiveBusiness` (object): Optional: presumptive business or profession (44AD / 44ADA / 44AE). The tool works out the deemed income and adds it to otherIncome itself.
- `regime` (string, required): Tax regime. 'new' (115BAC) is the default regime since FY 2023-24.
- `salaryIncome` (number): Gross salary income in INR, before standard deduction
- `stcg111A` (number): Short-term capital gains under section 111A (listed equity, STT paid) in INR

### `compare_regimes` (~753 tokens)

Compare old vs new tax regime

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.

Input parameters:

- `ageBand` (string): Age band: below60, senior (60-79), superSenior (80+). Affects old-regime exemption only.
- `deductions` (number): Old regime only: total Chapter VI-A deductions (80C, 80D, ...) in INR, EXCLUDING employer NPS (use employerNps80CCD2). Ignored under the new regime.
- `employerNps80CCD2` (number): 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)…
- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
- `governmentEmployer` (boolean): Central/State Government employer (raises the old-regime 80CCD(2) cap to 14% for FY 2025-26)
- `housePropertyLoss` (number): 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…
- `housePropertyType` (string): 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…
- `houses` (array): 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,…
- `ltcg112A` (number): Long-term capital gains under section 112A in INR, BEFORE the Rs 1,25,000 exemption
- `otherIncome` (number): Other normal-rate income in INR (interest, net rent, etc.)
- `presumptiveBusiness` (object): Optional: presumptive business or profession (44AD / 44ADA / 44AE). The tool works out the deemed income and adds it to otherIncome itself.
- `salaryIncome` (number): Gross salary income in INR, before standard deduction
- `stcg111A` (number): Short-term capital gains under section 111A (listed equity, STT paid) in INR

### `schedule_advance_tax` (~166 tokens)

Plan advance tax installments

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.

Input parameters:

- `estimatedTax` (number, required): Estimated total tax liability for the FY in INR (use compute_tax first)
- `fy` (string): Fiscal year, e.g. '2025-26'
- `paidSoFar` (array): Advance tax already paid per installment, in order
- `tdsExpected` (number): TDS/TCS expected to be deducted during the year in INR

### `list_deductions` (~92 tokens)

List old-regime deductions

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.

Input parameters:

- `fy` (string): Fiscal year, e.g. '2025-26'

### `parse_form26as` (~125 tokens)

Parse Form 26AS (text export)

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.

Input parameters:

- `path` (string, required): Absolute path to the 26AS .txt file downloaded from TRACES

### `parse_ais` (~249 tokens)

Parse AIS (Annual Information Statement)

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.

Input parameters:

- `dob` (string): Date of birth as DDMMYYYY (or DD-MM-YYYY); date of incorporation for non-individuals. NOT ISO YYYY-MM-DD.
- `pan` (string): PAN (used to derive the decryption password)
- `password` (string): Explicit decryption password (overrides pan+dob derivation)
- `path` (string, required): Absolute path to the downloaded AIS .json file

### `compute_interest_234` (~814 tokens)

Compute 234A/234B/234C interest

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`.

Input parameters:

- `advanceTaxPaid` (number): Total advance tax paid during the FY, in INR
- `assessedTax` (number, required): 234B base: tax on total income minus TDS/TCS and reliefs, in INR (advance tax is NOT deducted here)
- `cumulativePaid` (array): Cumulative (running-total) advance tax paid by Jun 15 / Sep 15 / Dec 15 / Mar 15, in INR. Required for 234C.
- `dueDate` (string): Explicit s.139(1) due date (YYYY-MM-DD) for 234A, e.g. an audit case. Overrides `form`.
- `filingDate` (string): 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.
- `form` (string): ITR form, used with filingDate to pick the non-audit s.139(1) due date from the rule pack for 234A
- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27)
- `monthsFor234B` (integer): 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.
- `monthsLateFiling` (integer): 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.
- `paidOrAssessedDate` (string): 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…
- `presumptive` (boolean): 44AD/44ADA presumptive: a single 100% installment by 03-15 (MM-DD) instead of four
- `selfAssessmentPayments` (array): Self-assessment tax paid under s.140A before assessment: each payment stops 234B interest on that amount from its own month (s.234B(2))
- `taxDueOnReturnedIncome` (number): 234C base: tax due on RETURNED income minus TDS/TCS/reliefs, in INR. Defaults to assessedTax when omitted.
- `taxOutstandingFor234A` (number): 234A base: tax outstanding after TDS/TCS, advance tax, AND reliefs, in INR. Defaults to assessedTax minus advanceTaxPaid.
- `taxOutstandingForms234A` (number): Deprecated misspelling of taxOutstandingFor234A; still accepted.

### `compute_hra` (~252 tokens)

Compute HRA exemption (+80GG)

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).

Input parameters:

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

### `reconcile_documents` (~395 tokens)

Reconcile Form 16 vs AIS vs 26AS

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.

Input parameters:

- `ais` (object): 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.
- `aisFile` (object): 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.
- `form16` (array): Per-employer Form 16 Part A figures
- `form26asPath` (string): Absolute path to the 26AS TRACES Text export (.txt). Parsed here, so the rows never pass through your arguments. Use instead of form26asTds.
- `form26asTds` (array): TDS entries from parse_form26as (tdsEntries, not tcsEntries)
- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27)
- `return` (object): Figures from the draft return

### `recommend_itr_form` (~962 tokens)

Recommend the ITR form

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.

Input parameters:

- `agriIncome` (number): Agricultural income in INR (above Rs 5,000 rules out ITR-1/ITR-4)
- `businessLoss` (boolean): Non-speculative business loss (incl. F&O) brought forward or arising this year
- `capitalLoss` (boolean): Capital loss (STCL/LTCL) brought forward or to carry forward
- `cashReceiptsWithin5Pct` (boolean): 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)
- `esopDeferral` (boolean): Tax deferred on eligible-startup ESOPs (s80-IAC)
- `fy` (string): Fiscal year, e.g. '2025-26'
- `hasBusinessIncome` (boolean): Any business or professional income this year, incl. F&O trading and freelancing
- `hasForeignAssetsOrIncome` (boolean): Foreign assets/income incl. vested RSUs or ESPP of a foreign parent (Schedule FA)
- `hasLotteryOrGamingIncome` (boolean): Winnings from lottery, online games, or racehorses
- `hasNonPresumptiveBusiness` (boolean): Also has business/professional income OUTSIDE the presumptive scheme (ITR-4 cannot carry both)
- `hasOtherCapitalGains` (boolean): Capital gains outside 111A/112A: property, debt MF, unlisted or foreign shares
- `holdsUnlistedShares` (boolean): Held unlisted equity shares during the FY
- `houseProperties` (integer): Number of house properties with income or loss (ITR-1/ITR-4 admit up to 2 for AY 2026-27)
- `housePropertyLoss` (boolean): House property loss to carry forward
- `isDirector` (boolean): Director in any company during the FY
- `isPartnerInFirm` (boolean): Partner in a partnership firm
- `ltcg112A` (number): LTCG under 112A in INR before the Rs 1,25,000 exemption
- `presumptive` (boolean): Opting for presumptive taxation (44AD/44ADA/44AE)
- `presumptiveScheme` (string): Which presumptive section (drives the turnover ceiling check; defaults to 44AD)
- `presumptiveTurnover` (number): 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-…
- `residency` (string): Residential status for the FY (RNOR/NRI cannot file ITR-1/ITR-4)
- `speculativeLoss` (boolean): Speculative (intraday equity) loss brought forward or arising this year
- `stcg111A` (number): STCG under 111A in INR (any amount rules out ITR-1/ITR-4)
- `tds194N` (boolean): TDS was deducted under s.194N on cash withdrawals (rules out ITR-1)
- `totalIncome` (number, required): Estimated 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.
- `vehicles44AE` (integer): 44AE only: the most goods carriages owned at any time in the year (the scheme allows up to 10). Omit to skip the check.

### `filing_checklist` (~105 tokens)

Step-by-step ITR filing checklist

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.

Input parameters:

- `form` (string, required): The ITR form to file (use recommend_itr_form if unsure)
- `fy` (string): Fiscal year, e.g. '2025-26'

### `compute_house_property` (~277 tokens)

Compute income from house property

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.

Input parameters:

- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
- `houses` (array, required): Every 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.
- `regime` (string, required): Tax regime: self-occupied interest is nil under the new regime (s.115BAC(2)(i)) and capped in the old

### `compute_presumptive_income` (~484 tokens)

Compute presumptive business income

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.

Input parameters:

- `carriages` (array): 44AE: each goods carriage owned in the year (the scheme allows at most 10 at any time)
- `cashReceiptsWithin5Pct` (boolean): 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…
- `declaredProfit` (number): A higher profit the taxpayer declares; the scheme taxes the deemed figure or more
- `digitalTurnover` (number): 44AD: turnover received by account-payee cheque, bank transfer, UPI or other digital modes (deemed profit 6%)
- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
- `grossReceipts` (number): 44ADA: gross professional receipts (deemed profit 50%)
- `maxCarriagesAtAnyTime` (integer): 44AE: the most carriages owned at any one time; defaults to the number listed
- `otherTurnover` (number): 44AD: the rest of turnover, cash included (deemed profit 8%)
- `scheme` (string, required): 44AD: small business on turnover. 44ADA: specified profession on gross receipts. 44AE: goods carriages.

### `compute_loss_setoff` (~523 tokens)

Set off and carry forward losses

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).

Input parameters:

- `broughtForward` (array): Losses brought forward from earlier years: one entry per kind and origin year, from last year's Schedule CFL
- `business` (number): Business or profession other than speculation (F&O included), net: profit or a NEGATIVE loss, in INR
- `capitalGains` (object): Capital gains and losses of the year
- `filedByDueDate` (boolean, required): The 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…
- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
- `houseProperty` (number): Income from house property for all houses together, in INR: positive income or a NEGATIVE loss (compute_house_property totals.income)
- `housePropertyType` (string): Which kind of house a house-property LOSS comes from; 'letOut' for a figure from compute_house_property (its caps are already applied)
- `otherSources` (number): Income from other sources at normal rates, in INR
- `regime` (string, required): Tax regime: no house-property loss crosses heads under the new regime (s.115BAC(2)); run once per regime to compare
- `salaryIncome` (number): Gross salary before the standard deduction, in INR
- `speculative` (number): Speculative business (intraday equity), net: profit or a NEGATIVE loss, in INR

### `tax_summary` (~1201 tokens)

What do I owe: tax, interest and fee in one call

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.

Input parameters:

- `advanceTaxPayments` (array): Each advance tax payment made during the FY, with its date; the tool works out s.234B and s.234C from them
- `ageBand` (string): Age band: below60, senior (60-79), superSenior (80+). Affects old-regime exemption only.
- `businessIncome` (boolean): 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 (…
- `deductions` (number): Old regime only: total Chapter VI-A deductions (80C, 80D, ...) in INR, EXCLUDING employer NPS (use employerNps80CCD2). Ignored under the new regime.
- `dueDate` (string): Explicit s.139(1) due date (YYYY-MM-DD), e.g. for an audit case. Overrides `form`.
- `employerNps80CCD2` (number): 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)…
- `filingDate` (string): Date the return is or will be filed (YYYY-MM-DD); defaults to today in India
- `form` (string): ITR form, to take the non-audit s.139(1) due date from the rule pack (use recommend_itr_form if unsure)
- `form26asPath` (string): 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.
- `fy` (string): Fiscal year, e.g. '2025-26' (AY 2026-27); '2026-27' is tax year 2026-27 under the Income-tax Act 2025
- `governmentEmployer` (boolean): Central/State Government employer (raises the old-regime 80CCD(2) cap to 14% for FY 2025-26)
- `housePropertyLoss` (number): 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…
- `housePropertyType` (string): 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…
- `houses` (array): 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,…
- `ltcg112A` (number): Long-term capital gains under section 112A in INR, BEFORE the Rs 1,25,000 exemption
- `otherIncome` (number): Other normal-rate income in INR (interest, net rent, etc.)
- `presumptiveBusiness` (object): Optional: presumptive business or profession (44AD / 44ADA / 44AE). The tool works out the deemed income and adds it to otherIncome itself.
- `regime` (string, required): Tax regime. 'new' (115BAC) is the default regime since FY 2023-24.
- `salaryIncome` (number): Gross salary income in INR, before standard deduction
- `selfAssessmentPayments` (array): Self-assessment tax (s.140A) paid after the FY, each with its date; each stops s.234B on its amount from that month
- `stcg111A` (number): Short-term capital gains under section 111A (listed equity, STT paid) in INR
- `tcsCredit` (number): Only without form26asPath: TCS credit in INR (default 0)
- `tdsCredit` (number): Only without form26asPath: TDS credit in INR, e.g. from Form 16 Part A. 0 when no tax was deducted.

### `list_tax_years` (~173 tokens)

List supported fiscal years

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.

Input parameters:

- `asOf` (string): Date to report the status for (YYYY-MM-DD). Defaults to today in India; pass it only to plan ahead.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/sagargupta16-itr-agent/itr-agent#diagnostics

## Score history

- 2026-11-21: 85
- 2026-11-20: 84
- 2026-11-19: 84
- 2026-11-18: 83
- 2026-11-17: 83
- 2026-11-16: 82
- 2026-11-15: 82
- 2026-11-14: 81
- 2026-11-13: 81

## 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.

## Links

- npm package: https://www.npmjs.com/package/itr-agent
- Socket report: https://socket.dev/npm/package/itr-agent
- Repository: https://github.com/Sagargupta16/itr-agent
- Changelog RSS feed: https://verifymcp.io/servers/sagargupta16-itr-agent/itr-agent.xml
- Changelog JSON feed: https://verifymcp.io/servers/sagargupta16-itr-agent/itr-agent/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/sagargupta16-itr-agent/itr-agent.json
- HTML version of this page: https://verifymcp.io/servers/sagargupta16-itr-agent/itr-agent
