MCP-India-Stack

MCP server for Indian APIs — GSTIN, IFSC, PAN, UPI, pincode, HSN/SAC. Zero auth. Offline-first. For AI agents.

GitHub

mcp-india-stack

MCP server exposing Indian financial and government APIs - GSTIN, IFSC, PAN, UPI, pincode, HSN/SAC - for AI agents. Zero auth. Offline-first.

Status

CI

Update v0.2.0 under development.

Install

pip install mcp-india-stack

Run

mcp-india-stack

or

python -m mcp_india_stack

Tools

  • lookup_ifsc
  • validate_gstin
  • validate_pan
  • validate_upi_vpa
  • lookup_pincode
  • lookup_hsn_code
  • decode_state_code

Bundled Data Size

This package bundles static datasets for offline-first workflows.

  • IFSC dataset (Razorpay releases)
  • India pincode dataset (GeoNames IN postal dump, CC-BY)
  • HSN/SAC master (GST tutorial workbook transformed to CSV)
  • State codes and curated UPI handles

Expected install footprint includes approximately 10-11MB compressed static data.

Limitations

  • GSTIN validation checks format and checksum, not active GSTN status.
  • PAN validation is structural; PAN check character is not publicly algorithmic.
  • HSN/SAC rates are static references and may vary by conditions/notifications.

Legal and Attribution

See NOTICES for dataset attribution and licensing details.

Related Servers