MCP-India-Stack
About
MCP server for Indian APIs — GSTIN, IFSC, PAN, UPI, pincode, HSN/SAC. Zero auth. Offline-first. For AI agents.
Details
- Author
- rehan1020
- Categories
- Other, API, Finance
Jump to
Setup
Install MCP-India-Stack in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/rehan1020/MCP-India-Stack
Follow the installation instructions in the repository README, then restart your MCP client.
A high-performance, offline-first Model Context Protocol (MCP) server equipping AI agents with Indian financial, tax, and government APIs. Zero authentication required.
- Problem Statement
- Tech Stack
- Architecture Diagram
- Demo & Links
- Key Features
- Quick Start
- Tool Catalog
- Agent Workflows & Resources
- Data Architecture & Freshness
- Limitations
- Legal & Attribution
- Launch Notes
- Fragmented Access:Indian fintech, identity, and tax APIs are heavily siloed, requiring multiple disjointed integrations.
- High Barriers to Entry:Existing solutions are plagued by paid subscriptions, strict rate limits, and complex API key management.
- No Native AI Integration:There is no MCP-native standard designed specifically for autonomous AI agents to validate GSTIN, PAN, IFSC, or compute tax data.
- Latency & Reliability Issues:Depending on remote third-party APIs for static/slow-moving datasets introduces unnecessary network delays and potential points of failure for AI workflows.
MCP Client ↔ MCP Server ↔ 58 offline-first tool modules
- Demo Video:https://youtu.be/KAy6043Co0w?si=FIFfVRM2y3Zwv8oK
- Deployment:https://pypi.org/project/mcp-india-stack/
- PPT:https://gamma.app/docs/Problem-India-lacks-native-fintech-primitives-for-AI-agents-d1izzfemlvfvkf0?mode=doc
- GitHub:https://github.com/rehan1020/MCP-India-Stack
- PyPI:https://pypi.org/project/mcp-india-stack/
- Offline-First Architecture: Bundles compressed datasets for zero-latency lookups (IFSC, Pincodes, HSN/SAC). No API rate limits.
- Zero Authentication: No API keys, secrets, or subscriptions required. All logic runs locally.
- Background Auto-Updates: Non-blocking CDN fetching ensures your datasets never go stale without impacting request latency.
- Comprehensive Coverage: 58 dedicated tools for identity validation (PAN, Aadhaar, GSTIN, TAN, PRAN), tax calculation (Income Tax, TDS, GST), savings calculators (EPF, PPF, SIP), and master data lookups.
- Enterprise-Ready: Thread-pool accelerated bulk validation tools for processing large batches of vendor or customer data.
Add the following to yourclaude_desktop_config.jsonfile to enable the India Stack in Claude Desktop:
Windows(%APPDATA%\Claude\claude_desktop_config.json):
{ "mcpServers": { "mcp-india-stack": { "command": "python", "args": ["-m", "mcp_india_stack"] } } }
macOS/Linux(~/Library/Application Support/Claude/claude_desktop_config.jsonor~/.config/Claude/claude_desktop_config.json):
{ "mcpServers": { "mcp-india-stack": { "command": "python3", "args": ["-m", "mcp_india_stack"] } } }
- lookup_ifsc— Bank branch details from IFSC code
- lookup_pincode— India pincode details and post offices
- lookup_hsn_code— HSN/SAC code lookup by code or keyword
- decode_state_code— GST state code metadata
- lookup_bbps_biller— BBPS biller directory lookup
- lookup_bank— Basic bank master lookup by name or code
- validate_gstin— GSTIN structure and checksum
- validate_pan— PAN format and entity type decode
- validate_upi_vpa— UPI VPA structure and provider decode
- validate_aadhaar— Aadhaar number with Verhoeff checksum (masked output)
- validate_voter_id— Voter ID (EPIC) format with legacy detection
- validate_driving_license— DL format with state/RTO/year decode
- validate_passport— Indian passport number format
- validate_cin— Company Identification Number with full field decode
- validate_din— Director Identification Number format
- validate_fssai— FSSAI license number validation and decode
- validate_epf_code— EPF establishment code validator
- validate_esic_code— ESIC employer code validator
- validate_tan— TAN validator
- validate_pran— PRAN validator for NPS
- validate_llpin— LLPIN validator
- decode_isin— ISIN decoder with Luhn validation
- decode_digilocker_uri— DigiLocker URI decoder and validator mapper
- decode_pan_type— Decode PAN entity type from the 4th character
- validate_mobile_number— Mobile number with operator/circle detection
- bulk_validate_gstin— Parallel GSTIN batch validation
- bulk_validate_pan— Parallel PAN batch validation
- bulk_validate_ifsc— Parallel IFSC batch validation
- [bulk_validate_aadhaar— Parallel Aadhaar batch validation
🧮 Tax & Financial Calculators (FY2025-26)
…
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
