Skip to main content
Glama

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, and ingest_trades take structured data that the AI has read from the user's file. The server validates it and stores it under ITR_AGENT_HOME (default ~/.itr-agent), one folder per assessment year.

  • Show. show_ais renders the AIS as markdown, with Indian digit grouping and TDS totals.

  • Find what's missing. get_document_checklist works 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 in src/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 pytest

Run the server over stdio:

.venv/bin/itr-agent

License

MIT. See LICENSE.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    An 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.
    74
    61 PyPI
    67
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Local-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.
    12
    10 npm
    10
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Turns any MCP host into a finance & tax copilot for Indian taxpayers, using live keyless data and deterministic advisory.
    16
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Local MCP server for securely storing and sharing identity documents (passports, visas, licenses) with AI agents, requiring per-field user consent for each request.
    11
    21 npm
    MIT