TaxBrainAI MCP server
io.github.harshil-projects/taxbrainai-mcp·v0.1.18 offline Indian income-tax MCP tools: deterministic compute, regimes, citations, notices.
0 stars22 downloads/wk
Reviews
Write oneNobody has reviewed TaxBrainAI MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
TaxBrainAI MCP tools (8)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cite_sectionResolve a section number to its title + a formatted statutory citation.
classify_noticeClassify an income-tax notice: section, type, deadline + canonical guidance (deterministic pattern-match, no LLM).
compare_actsMap a section across IT Act 1961 <-> IT Act 2025 via the equivalence graph.
compute_taxDeterministically compute Indian income-tax liability for a structured input (salary, capital gains, deductions, age, residency, regime).
find_case_lawSearch an optional (bring-your-own) Indian case-law metadata index.
reconcile_documentsReconcile pre-extracted Form 16 / Form 26AS / AIS fields and flag mismatches.
regime_compareCompare old vs new regime for the same inputs; recommend the cheaper.
simulate_scenarioWhat-if simulation: apply changes to a base input and compare tax.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan11 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 82 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How TaxBrainAI MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 70% of 48,255 servers
- Tools
- 8
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 22
- more than 8% of 12,191 servers with a package
What its tools let an agent do: 8 read
Install TaxBrainAI MCP in Claude Code, Cursor or VS Code
claude mcp add taxbrainai-mcp -- uvx taxbrainai-mcp
What the publisher says
From the TaxBrainAI MCP repository's README, as published. We do not edit it. Read it on GitHub
taxbrainai-mcp
A standalone MCP server exposing 8 tools for Indian personal income-tax work (ITR-1/2/3/4 + post-filing notices). It is built on FastMCP as a thin wrapper over the deterministic taxbrainai-compute engine plus a small statute graph that ships inside the package.
It runs fully offline with no API keys — every tool here is deterministic or an optional bring-your-own-index lookup. There is no LLM call anywhere in this package.
This is the extracted, self-contained MCP surface of the larger TaxBrainAI project.
In the full product, three of these tools are backed by an LLM / vision model and a
hosted case-law corpus; here those halves are replaced by deterministic equivalents
(or made optional), so the package installs and starts with no private backend, no
secrets, and no redistributed third-party data. See "Honesty about each tool" below.
The 8 tools
Honesty about each tool
property-tested taxbrainai-compute library (Hypothesis-verified, cross-checked against the official Income-Tax Dept ITR utilities). The server never authors a number.
- Deterministic Decimal compute (1–3): all math flows through the
1961↔2025 statute graph (nodes.csv + edges.csv, shipped inside the package).
- Deterministic statute graph (4–5): answered from a vendored snapshot of the
LLM/vision-backed (a model reads the notice / extracts document fields). This standalone server keeps only the deterministic halves — a section/keyword matcher and a field-level reconciliation diff — so no model or key is required.
- Deterministic table / diff (6–7): in the full TaxBrainAI product these are
bundled (third-party data is not redistributed here). It degrades gracefully to an empty result set unless you point it at your own index.
- Optional retrieval (8): findcaselaw needs a case-law index, which is not
Install
pip install "taxbrainai-mcp[mcp]" # server + FastMCP SDK
pip install taxbrainai-mcp # tool library only (no SDK; importable + testable)taxbrainai-compute is a hard dependency and is installed automatically.
Run
# installed console script
taxbrainai-mcpShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
TaxBrainAI MCP: common questions
- Is TaxBrainAI MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the TaxBrainAI MCP safety report
- How do I install TaxBrainAI MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does TaxBrainAI MCP need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is TaxBrainAI MCP maintained?
- The last commit was 121 days ago (2026-07-06). The latest release is v0.1.1.
- How does TaxBrainAI MCP compare with other MCP servers?
- safety score 85/100 (higher than 70% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.