io.github.Samarth-23-eng/india-mcp-gst
MCP server for India GST: validate GSTIN, search HSN, calculate tax.
Open source Open in the app JSON README (API)
About
MCP server for India GST: validate GSTIN, search HSN, calculate tax.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- samarth-23-eng
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.7
- Stars
- 1
- Last push
- 2026-05-08T08:47:14Z
- Repository state
- ativo
- Language
- Go
- License
- MIT
- Added
- 2026-08-29 03:02:13
- Updated
- 2026-08-29 03:02:13
- Origin id
io.github.Samarth-23-eng/india-mcp-gst
README
# 🇮🇳 India MCP
[](https://www.npmjs.com/package/@samarth-23-eng/india-mcp)
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io/)
[](https://opensource.org/licenses/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
| Server | Domain | Tools | Description |
| :--- | :--- | :---: | :--- |
| **GST** | Taxation | 5 | Validate GSTINs, HSN codes, and tax calculations. |
| **Railways** | Transport | 7 | Live train status, PNR enquiry, and schedules. |
| **RTO** | Automotive | 6 | Vehicle registration details and road tax calculator. |
| **Banking** | Fintech | 3 | IFSC search, UPI validation, and bank status. |
| **Stocks** | Markets | 8 | NSE/BSE real-time quotes, indices, and history. |
| **eCourts** | Legal | 6 | Court cases, orders, and cause list retrieval. |
Detailed catalog: [docs/SERVERS.md](./docs/SERVERS.md) | Full Tool Index: [docs/TOOLS.md](./docs/TOOLS.md)
---
## 📦 Installation
```bash
npm install -g @samarth-23-eng/india-mcp
```
**Quick start — launch any server with one command:**
```bash
india-mcp stocks # NSE/BSE stock data
india-mcp gst # GST validation
india-mcp ecourts # Court case lookup
india-mcp fssai # Food license verification
india-mcp list # Show all available servers
india-mcp --help # Full usage guide
```
Or use `npx` without installing:
```bash
npx @samarth-23-eng/india-mcp stocks
```
---
## 🔌 MCP Client Configuration
### Claude Desktop
Add this to your `claude_desktop_config.json`:
```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](./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](./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](CONTRIBUTING.md) to get started.
---
## 📄 License
MIT © [Samarth-23-eng](https://github.com/Samarth-23-eng)