🇮🇳 MCP India Stack

A high-performance, offline-first Model Context Protocol (MCP) server equipping AI agents with Indian financial, tax, and government APIs. Zero authentication required.

📑 Table of Contents

• 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

---

📌 Problem Statement

• 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.

---

🛠️ Tech Stack

Layer	Technology
Protocol	MCP (FastMCP)
Runtime	Python
Distribution	PyPI / Smithery
Hosting	Render
Datasets	Offline-bundled (jsDelivr CDN sync)

---

🏗️ Architecture Diagram

MCP Client ↔ MCP Server ↔ 76 offline-first tool modules

---

🔗 Links

• 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/

✨ Key Features

• 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: 76 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.

---

🚀 Quick Start

Installation

pip install mcp-india-stack

Claude Desktop Configuration

Add the following to your claude_desktop_config.json file 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"]
    }
  }
}