India Mcp Gst

🇮🇳 India MCP

[npm version] [TypeScript] [MCP Compatible] [License: MIT]

Collection of MCP (Model Context Protocol) servers for Indian APIs and services. Enable AI agents like Claude, Cursor, and OpenCode to operate natively in the Indian market with real-time data and specialized tools.

🇮🇳 Why India-MCP?

Indian digital infrastructure is powerful but fragmented. Many government and enterprise portals are:

• Unstable: Intermittent downtime and slow response times.
• Protected: Require specific headers and session management.
• Inconsistent: Varying data formats (HTML, JSON, XML).

India-MCP provides a unified, resilient, and AI-optimized layer over these services, enabling agents to verify identities, track logistics, analyze markets, and navigate the legal system with a single protocol.

🚀 Features

• Production Grade: Hardened servers with retry logic, request timeouts, and in-memory TTL caching.
• Resilient Data: Intelligent fallback strategies (e.g., NSE → Yahoo Finance) for maximum availability.
• Privacy First: Browser-compliant headers and respectful API usage patterns.
• Developer Friendly: Clean JSON-RPC interfaces and normalized tool responses.
• Unified Ecosystem: Shared utilities for banking, legal, and market data.

🛠 Available Servers

Detailed catalog: docs/SERVERS.md | Full Tool Index: docs/TOOLS.md

📦 Installation

npm install -g @samarth-23-eng/india-mcp

Quick start — launch any server with one command:

india-mcp stocks       # NSE/BSE stock dataindia-mcp gst          # GST validationindia-mcp ecourts      # Court case lookupindia-mcp fssai        # Food license verificationindia-mcp list         # Show all available serversindia-mcp --help       # Full usage guide

Or use npx without installing:

npx @samarth-23-eng/india-mcp stocks

🔌 MCP Client Configuration

Claude Desktop

Add this to your claude_desktop_config.json:

{  "mcpServers": {    "india-stocks": {      "command": "npx",      "args": ["-y", "@samarth-23-eng/india-mcp", "stocks"]    },    "india-ecourts": {      "command": "npx",      "args": ["-y", "@samarth-23-eng/india-mcp", "ecourts"]    },    "india-gst": {      "command": "npx",      "args": ["-y", "@samarth-23-eng/india-mcp", "gst"]    }  }}

Detailed guides: docs/EXAMPLES.md

🏗 Architecture

India-MCP uses a shared resilience layer to handle the instability of Indian government portals.

• Retries: 2 retries with exponential backoff for all network calls.
• Caching: TTL-based memory cache to prevent IP blocking.
• Fallbacks: Automatic switching to backup data sources.

Technical details: docs/ARCHITECTURE.md

🛤 Roadmap

Planned servers:

• eCourts (Extended): Supreme Court and High Court specific filters.
• FSSAI: Food license validation.
• CDSCO: Medicine registry verification.
• Land Records: Digital Bhulekh access.

🚀 Release Process

1. Bump Version: npm version patch --no-git-tag-version
2. Build: npm run build
3. Validate: npm run validate:publish
4. Publish to npm: npm publish --access public
5. Registry: mcp-publisher validate & mcp-publisher publish

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines to get started.

📄 License

MIT © Samarth-23-eng