itr-agent — Claude Code MCP server: what it does, how to install
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.
MIT ★ 11 updated 2026-11-14
claude mcp add itr-agent -- npx -y itr-agentWhat itr-agent 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.
What it helps with
- Calculate Indian income tax
- Select the correct ITR form
- Reconcile
26ASandAIStax documents - Compare old and new tax regimes
- Schedule advance tax payments
Example prompts for the agent
- Help me file my ITR.
- Calculate my income tax for FY 2025-26.
- Compare tax regimes for 18L salary and 3.75L deductions.
How to install itr-agent
Platform CLI
claude mcp add itr-agent -- npx -y itr-agentPlatform CLI
codex mcp add itr-agent -- npx -y itr-agentConfig file
{
"mcpServers": {
"itr-agent": {
"command": "npx",
"args": [
"-y",
"itr-agent"
]
}
}
}Config file
{
"servers": {
"itr-agent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"itr-agent"
]
}
}
}Platform CLI
gemini mcp add itr-agent npx -y itr-agentStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about itr-agent
How to install itr-agent in Claude Code?
To install itr-agent in Claude Code, use the command claude mcp add itr-agent -- npx -y itr-agent. This adds the MCP server to your environment.
What does itr-agent do?
itr-agent assists users in India with filing income tax returns. It guides them through ITR form completion, calculates taxes locally, and helps reconcile financial documents.
Does itr-agent require uploading documents to the cloud?
No, itr-agent operates locally. All your documents and data remain on your machine, without any cloud uploads or account creation.