itr-agent

● Active

io.github.Sagargupta16/itr-agent

Local-first Indian income tax filing agent: ITR form, tax computation, 26AS/AIS reconciliation

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "itr-agent": {
      "command": "npx",
      "args": [
        "-y",
        "itr-agent@0.7.0"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add itr-agent -- npx -y itr-agent@0.7.0
OpenAI Codex CLI
codex mcp add itr-agent -- npx -y itr-agent@0.7.0
VS Code
code --add-mcp '{"name":"itr-agent","type":"stdio","command":"npx","args":["-y","itr-agent@0.7.0"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Finance
Version
0.7.0
Registry
active
Published
11/14/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 18, 2026

Looks healthy: itr-agent is maintained, open source.

Maintained
Active
Last commit 8 days ago (Nov 14, 2026), 4 open issues.
Official registry
Active
Published as io.github.Sagargupta16/itr-agent in the official MCP registry, version 0.7.0.
Source
Open source, MIT
Public repository under the MIT licence, 11 stars, 2 forks.
Runs
On your machine
A local npm package started by your client; it can reach whatever your user account can.
Credentials
None declared
The registry entry declares no required environment variables.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 18, 2026
Stars
11
Forks
2
Last push
Nov 14, 2026
License
MIT

TypeScriptclaudeincome-taxindiaitrmcpmcp-servertypescript

From the README

itr-agent Local-first ITR filing agent for Indian income tax. Claude interviews you one question at a time, picks your ITR form, computes your tax deterministically on your machine, reconciles your documents, and walks you to the portal's submit button -- no accounts, no uploads, no cloud. Works with Claude Desktop, Claude Code, and any MCP client. Formerly published as itr-mcp. Those are the calls Claude makes during the interview, sent to the built server by scripts/demo.mjs. Every figure in the animation is one that run printed. Why Every Indian tax tool wants your data on their servers. itr-agent flips it: your documents stay local, the LLM never does arithmetic, and every number comes from a versioned rule pack you can audit. The agent layer drives the interview; the deterministic engine does the math. What it will never do: submit the return for you. India has no public filing API -- returns are filed by you on incometax.gov.in (or by an authorized ERI/CA). The agent takes you to that button with every number verified; you press it. The agent filemyitr (MCP prompt) runs the guided interview: 1. listtaxyears -> status: worked out from today's date in India, so the agent knows whether the return is on time or belated (and the s.234F fee) before anything else 2. Residency, age band -- one question at a time 3.…

Read the full README on GitHub →

The most-starred Finance servers in the index, with their live-check result.

ServerStarsLast pushLive check
CCXT44,949Nov 2026Local / not checked
QR Rápido7,477Nov 2026Needs sign-in
Finance Toolkit5,554Nov 2026Needs sign-in
AKQuant2,627Nov 2026Local / not checked
com.stripe MCP2,072Nov 2026Needs sign-in

itr-agent: questions people ask

Is itr-agent a remote or a local MCP server?
According to its entry in the official MCP registry, itr-agent ships as a local package (npm) that your client starts on your machine.
Is itr-agent safe to use?
Looks healthy: itr-agent is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: None declared. Serverdex check of Nov 18, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is itr-agent still maintained?
Active: the repository's last commit 8 days ago. Last push Nov 14, 2026, 11 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add itr-agent to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.

More from Sagargupta16

All 3 servers by Sagargupta16 →
  1. OrreryArchitecture diagrams with official AWS, Azure, GCP and Kubernetes icons, to SVG, PNG and draw.io★ 7
  2. Bedrock Multi-ModelAsk, compare and judge 35 Bedrock text models, generate and edit images, plus video and embeddings.★ 3
Browse all Finance →

Add the badge to your site

Show visitors that itr-agent is listed here — it’s also the link we check for a free listing.

itr-agent — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-sagargupta16-itr-agent?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="itr-agent — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![itr-agent — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-sagargupta16-itr-agent?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-sagargupta16-itr-agent) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-sagargupta16-itr-agent) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-sagargupta16-itr-agent)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-sagargupta16-itr-agent"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-sagargupta16-itr-agent"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-sagargupta16-itr-agent"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).