lookup_ifscLABSCO 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
USE CASES
01
Checking a batch of vendor records before you import them
Run the bulk validators over the GSTINs, PANs and IFSC codes and see which rows are malformed.
02
Resolving a bank detail from a code
Look up the IFSC for its branch and bank, and the pincode for its location.
03
Working out what someone actually takes home
Compute the income tax with surcharge, the HRA exemption and the EPF and ESIC contributions.
04
Answering an invoicing question
Find the HSN code for the item, calculate the GST, and work out the late fee if the filing slipped.
05
Comparing what to do with savings
Project the SIP, the fixed deposit and the PPF side by side, or weigh buying against renting.
06
Building an Account Aggregator flow
Construct the consent request, validate the artifact that comes back, and decode the FI types in it.
78 tools
Listed in project docs. Your client may show a different list.
lookup_pincodelookup_hsn_codedecode_state_codelookup_bbps_billerlookup_bankvalidate_gstinvalidate_panvalidate_upi_vpavalidate_aadhaarvalidate_voter_idvalidate_driving_licensevalidate_passportvalidate_cinvalidate_dinvalidate_fssaivalidate_epf_codevalidate_esic_codevalidate_tanvalidate_pranvalidate_llpindecode_isindecode_digilocker_uridecode_pan_typevalidate_mobile_numberbulk_validate_gstinbulk_validate_panbulk_validate_ifscbulk_validate_aadhaarcalculate_income_taxcalculate_tdscalculate_gstcalculate_surchargecalculate_hra_exemptioncalculate_capital_gainscalculate_advance_taxcalculate_gst_late_feecalculate_income_tax_interestcalculate_presumptive_taxget_regulatory_deadlinescalculate_epf_esiccalculate_emicalculate_gratuitycalculate_ppf_maturitycalculate_fd_maturitycalculate_rd_maturitycalculate_sip_returnscalculate_step_up_sipcalculate_nps_projectioncalculate_sukanya_samriddhicalculate_home_vs_rentcalculate_leave_encashment_taxcalculate_professional_taxcalculate_salary_restructuringcalculate_neft_rtgs_imps_chargesget_stock_quoteget_stock_historydecode_cnr_numberlookup_court_establishment_codelookup_ipc_sectionlookup_bns_sectionlookup_crpc_sectionlookup_bnss_sectionlookup_evidence_act_sectionlookup_bsa_sectiondecode_ipc_bns_crosswalkcalculate_limitation_deadlinecalculate_court_feecalculate_stamp_dutycalculate_rti_feecalculate_rti_deadlinecalculate_rti_penalty_estimatedraft_rti_applicationdraft_first_appealdraft_second_appealbuild_aa_consent_requestvalidate_aa_consent_artifactdecode_aa_fi_typeBEFORE YOU INSTALL
What to know first
Tools you get
78 tools named in the project's documentation.
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install mcp-india-stackMCP Clients
Claude Desktop — Windows
CLAUDE DESKTOP — WINDOWS · JSON
{
"mcpServers": {
"mcp-india-stack": {
"command": "python",
"args": [
"-m",
"mcp_india_stack"
]
}
}
}Claude Desktop — macOS, Linux
CLAUDE DESKTOP — MACOS, LINUX · JSON
{
"mcpServers": {
"mcp-india-stack": {
"command": "python3",
"args": [
"-m",
"mcp_india_stack"
]
}
}
}
