Skip to content
MCP server

itr-agent

Local MCP server that guides Indian income tax filing and computes tax offline

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.7.0
Listing updated
today

Similar MCP servers

About itr-agent

itr-agent is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

It will not file the return for you. The README says India has no public filing API, so the agent walks you up to the submit button on incometax.gov.in and you press it. What it does cover is the interview, the form choice and the arithmetic.

A file_my_itr prompt asks one question at a time: residency, age band, income heads, then a sweep for things that rule out ITR-1 such as foreign RSUs or a director role. Tax is computed by a deterministic engine from a versioned rule pack, so the model never does the maths. Coverage includes old and new regime slabs, 87A rebate, capital gains, house property, HRA, presumptive income under 44AD, 44ADA and 44AE, loss set-off, and 234A/B/C interest with the 234F fee.

Documents stay on your machine. parse_ais decrypts the AIS JSON on-device and parse_form26as reads the TRACES text export, then reconcile_documents flags mismatches before filing. The default year is FY 2025-26 (AY 2026-27).

Install

Run in a terminal

claude mcp add itr-agent -- npx -y itr-agent

Add to claude_desktop_config.json

{
  "mcpServers": {
    "itr-agent": {
      "command": "npx",
      "args": [
        "-y",
        "itr-agent"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "itr-agent": {
      "command": "npx",
      "args": [
        "-y",
        "itr-agent"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "itr-agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "itr-agent"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

recommend_itr_form
Select ITR-1/2/3/4 with rule-by-rule reasoning and deadlines.
filing_checklist
Ordered, form-specific filing walkthrough.
compute_tax
Full tax computation for the year under both regimes.
compare_regimes
Old versus new regime with breakeven deductions.
schedule_advance_tax
Advance tax instalment plan with shortfall tracking.
compute_interest_234
Sections 234A/B/C interest.
compute_hra
HRA exemption and 80GG alternative.
compute_house_property
Income from house property per house.
compute_presumptive_income
Deemed income under 44AD, 44ADA and 44AE.
compute_loss_setoff
Apply current and brought-forward losses in statutory order.
tax_summary
Net tax owed or refund after TDS, TCS and payments.
list_deductions
Old-regime deduction checklist with caps.
parse_form26as
Parse the Form 26AS text export.
parse_ais
Decrypt and parse the AIS JSON export on-device.

What it does

Guided filing interview
A prompt asks one question at a time and tracks the on-time or belated status.
ITR form recommendation
Chooses ITR-1 to 4 and gives rule-by-rule reasoning.
Regime comparison
Shows old and new regime side by side with a breakeven deduction.
AIS and 26AS parsing
Parses and reconciles tax documents on the device.
Interest and fee calculation
Computes sections 234A, 234B, 234C and the 234F fee.
Portal checklist
Produces a schedule-by-schedule walkthrough ending at e-verification.

Good for

  • Pick the right ITR form for a salaried person with foreign RSUs
  • Compare old and new tax regimes with real numbers
  • Reconcile Form 26AS and AIS before filing
  • Estimate advance tax instalments and interest
  • Compute HRA exemption or house property income

Pricing

Open source

Runs locally from npm; no price listed

itr-agent FAQ

Does it submit my return?

No. The README says you file on incometax.gov.in, or through an authorised ERI or CA.

Is my data uploaded?

No. It is described as local-first with no accounts, uploads or cloud.

Which tax year is the default?

FY 2025-26 (AY 2026-27); tax year 2026-27 can be chosen with the fy option.

Who does the arithmetic?

A deterministic engine using a versioned rule pack, not the language model.

Which clients work?

Claude Desktop, Claude Code and any MCP client.

Is itr-agent free?

Yes. itr-agent is open source, so you can use and self-host it for free.

How do I add itr-agent to Claude Code?

Run this command in your terminal: claude mcp add itr-agent -- npx -y itr-agent

What are the best alternatives to itr-agent?

The closest alternatives to itr-agent are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Data Ny and Crypto Feeds.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers