itr-agent
Local MCP server that guides Indian income tax filing and computes tax offline
- 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-agentAdd to claude_desktop_config.json
{
"mcpServers": {
"itr-agent": {
"command": "npx",
"args": [
"-y",
"itr-agent"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"itr-agent": {
"command": "npx",
"args": [
"-y",
"itr-agent"
]
}
}
}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.

