# itr-agent

itr-agent is an MCP server for Claude Code and other platforms that assists with Indian income tax filing. It activates when you need to calculate taxes and complete your ITR form.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 repo stars
- Author: Sagargupta16
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Sagargupta16/itr-agent
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/itr-agent

## What it does

itr-agent is a local-first agent for Indian income tax filing. It guides users through the ITR form process, asking questions, computing taxes deterministically on the local machine, and helping reconcile documents. All data remains on the device, with no accounts, uploads, or cloud interaction.

The agent conducts a step-by-step interview, identifying the correct ITR form, calculating taxes, and offering comparisons between tax regimes. It also helps detect discrepancies in `26AS` and `AIS` documents before filing.

itr-agent does not submit the return directly. Instead, it guides the user to the submit button on the official `incometax.gov.in` portal with all figures verified.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add itr-agent -- npx -y itr-agent
```

### Codex

**Platform CLI**
```bash
codex mcp add itr-agent -- npx -y itr-agent
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "itr-agent": {
            "command": "npx",
            "args": [
                "-y",
                "itr-agent"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "itr-agent": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "itr-agent"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add itr-agent npx -y itr-agent
```

## When to use it
- Calculate Indian income tax
- Select the correct ITR form
- Reconcile `26AS` and `AIS` tax documents
- Compare old and new tax regimes
- Schedule advance tax payments

## Example prompts
- Help me file my ITR.
- Calculate my income tax for FY 2025-26.
- Compare tax regimes for 18L salary and 3.75L deductions.

## Similar
- [india-trading-skills](https://affpapa.org/en/nevibecode/plugins/india-trading-skills.md) — plugin · ★ 69 repo stars
- [Contazz AutoPilot](https://affpapa.org/en/nevibecode/mcp/contazz-autopilot.md) — MCP server · 139 installs
- [india-finance-mcp](https://affpapa.org/en/nevibecode/mcp/india-finance-mcp.md) — MCP server · 611 installs
- [Tapetide - Indian Stock Market MCP](https://affpapa.org/en/nevibecode/mcp/tapetide-indian-stock-market-mcp.md) — MCP server · ★ 151 repo stars
- [AION Indian Market Intelligence for Macro Event & Sector Impact Analysis](https://affpapa.org/en/nevibecode/mcp/aion-indian-market-intelligence-for-macro-event-sector-impact-analysis.md) — MCP server · ★ 24 repo stars
- [Quantplay](https://affpapa.org/en/nevibecode/mcp/quantplay.md) — MCP server · ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
