itr-agent
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@itr-agentIngest my AIS for AY 2024-25 and tell me what documents are missing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
itr-agent
An open-source MCP server for filing Indian Income Tax Returns. It runs locally on your machine and plugs into any MCP-capable AI app (Claude Desktop, Cursor, and others). No backend, and no document leaves your device.
Status
Phase 0 (foundation): strict schemas, the trade validation gate, and the MCP server skeleton.
Phase 1 (AIS and missing documents) is in place:
Ingest and store.
ingest_ais,ingest_26as,ingest_form16, andingest_tradestake structured data that the AI has read from the user's file. The server validates it and stores it underITR_AGENT_HOME(default~/.itr-agent), one folder per assessment year.Show.
show_aisrenders the AIS as markdown, with Indian digit grouping and TDS totals.Find what's missing.
get_document_checklistworks out which supporting documents the AIS implies (26AS, Form 16 per employer, broker P&L) and attaches a download guide to each missing one. Guides live insrc/itr_agent/guides_data/. They are drafted and not yet checked against the live portals.
Still not_implemented: reconciliation, tax and capital-gains engines, ITR
JSON, and currency conversion. These are Phases 2 to 3.
Related MCP server: itr-mcp
Development
uv venv .venv
uv pip install -p .venv/bin/python -e ".[dev]"
.venv/bin/python -m pytestRun the server over stdio:
.venv/bin/itr-agentLicense
MIT. See LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
AI for Tally Prime and Tally ERP 9. Hosted MCP server to ask your accounts in any language.
Document sharing, invoicing, and personal finance platform. 15+ AI tools via OAuth 2.1.
AI governance MCP server for EU AI Act compliance and jurisdiction verification
PDF tools + invoice extraction, bank statement parsing, GST reconciliation & GSTIN validation.
Related MCP Servers
- AlicenseAqualityAmaintenanceAn offline-first MCP server for Indian financial, tax, and government APIs, providing tools for identity validation (PAN, Aadhaar, GSTIN), tax calculations (Income Tax, TDS, GST), and master data lookups (IFSC, Pincode, HSN/SAC) with zero authentication required.7461 PyPI67MIT
- AlicenseAqualityBmaintenanceLocal-first MCP server for Indian income tax computation, enabling users to compute taxes, compare regimes, plan advance tax, and parse Form 26AS without sending data to the cloud.1210 npm10MIT
- AlicenseAqualityDmaintenanceTurns any MCP host into a finance & tax copilot for Indian taxpayers, using live keyless data and deterministic advisory.16MIT
- AlicenseAqualityCmaintenanceLocal MCP server for securely storing and sharing identity documents (passports, visas, licenses) with AI agents, requiring per-field user consent for each request.1121 npmMIT