Labsco
MCP SERVER

India-Stack MCP

by rehan1020

Validate and compute the Indian identifiers and money maths an agent keeps running into — GSTIN, PAN, IFSC, income tax, EMI — offline and without a key.

Developer Conversions, Encoding & Test DataVerified
Summary
Runs offline against bundled data, which is why it is fast and keyless — and why the validators tell you about format, not about status.

For the common cases — is this GSTIN well-formed, which bank is this IFSC, what is the tax on this salary — a local lookup beats a rate-limited third-party API on every axis. Read the boundary carefully before you build on it: a valid checksum means the number is well-formed, not that the registration is live, so anything that turns on active status still needs the government source.

What it is

An offline-first server bundling India's static reference data and its statutory calculations: identifier validators, lookups over bundled datasets, and financial and tax calculators.

What you get
  • Identifier validation across the stack — GSTIN, PAN with its type decoded, Aadhaar with the Verhoeff checksum and masked output, UPI VPA, voter ID, driving licence, passport, CIN, DIN, LLPIN, TAN, FSSAI, EPF and ESIC codes, PRAN, ISIN and mobile numbers, with bulk variants for the ones you run in batches
  • Lookups over bundled datasets: IFSC codes, banks, pincodes, HSN and SAC codes, state codes and BBPS billers
  • Tax computation: income tax with surcharge, TDS, GST, advance tax, capital gains, HRA exemption, presumptive tax, professional tax and leave-encashment tax, plus late fees and interest
  • Payroll and benefits maths — EPF and ESIC contributions, gratuity, and salary restructuring
  • Savings and lending calculators: EMI, fixed and recurring deposit maturity, PPF, SIP and step-up SIP returns, NPS projection, Sukanya Samriddhi, a home-versus-rent comparison, and NEFT, RTGS and IMPS charges
  • Account Aggregator support: consent requests built, consent artifacts validated, FI types decoded, and DigiLocker URIs decoded
  • Regulatory deadlines retrieved rather than remembered
Requirements

No authentication and no API keys. Installed from PyPI as mcp-india-stack and run over stdio; the static datasets covering IFSCs, pincodes, HSN and SAC masters and curated UPI handles ship with the package. Validation is structural: GSTIN, Aadhaar, voter ID, driving licence, passport, CIN and DIN checks confirm format and checksum, and do not confirm active registration with the issuing authority.

Setup effort

One command — pip install mcp-india-stack