MCP-India-Stack: Offline-first server for Indian financial data in AI agents

What this is

MCP-India-Stack is an offline-first MCP (Model Context Protocol) server designed specifically for AI agents that need to interact with Indian financial and government data. It eliminates the need for external API calls by bundling datasets locally, meaning no API keys, rate limits, or data sent to third-party endpoints.

Key features and tools

The server provides three main categories of functionality:

Tax & Finance Calculators (FY2025-26)

• Compute income tax (old vs. new regime)
• Calculate TDS (Tax Deducted at Source)
• GST calculations
• Surcharge computations

Validation Tools

• PAN (Permanent Account Number) validation with format and checksum verification
• GSTIN (Goods and Services Tax Identification Number) validation
• UPI VPA (Virtual Payment Address) validation
• Aadhaar (Indian identity number) validation
• Voter ID validation
• Corporate IDs (CIN/DIN) validation

Lookup Tools

• IFSC (Indian Financial System Code) code resolution
• Pincode lookups
• HSN/SAC (Harmonized System Nomenclature/Service Accounting Code) code resolution

Technical approach

The server implements an offline-first architecture where all necessary datasets are bundled locally. This approach provides several advantages for AI agent development:

• No external API dependencies or rate limits
• No sensitive data leaves the local environment
• Instant response times for lookups and calculations
• Zero authentication requirements

The tool is particularly useful for developers building AI applications in the Indian finance space, as it enables models to handle complex computations and business validations without relying on external services.

The project is available on GitHub at https://github.com/rehan1020/MCP-India-Stack.