{
  "markdown": "# 🇮🇳 India MCP\n\n[![npm version](https://img.shields.io/npm/v/@samarth-23-eng/india-mcp?style=flat)](https://www.npmjs.com/package/@samarth-23-eng/india-mcp)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nCollection 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.\n\n---\n\n## 🇮🇳 Why India-MCP?\n\nIndian digital infrastructure is powerful but fragmented. Many government and enterprise portals are:\n- **Unstable**: Intermittent downtime and slow response times.\n- **Protected**: Require specific headers and session management.\n- **Inconsistent**: Varying data formats (HTML, JSON, XML).\n\n**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.\n\n---\n\n## 🚀 Features\n\n- **Production Grade**: Hardened servers with retry logic, request timeouts, and in-memory TTL caching.\n- **Resilient Data**: Intelligent fallback strategies (e.g., NSE → Yahoo Finance) for maximum availability.\n- **Privacy First**: Browser-compliant headers and respectful API usage patterns.\n- **Developer Friendly**: Clean JSON-RPC interfaces and normalized tool responses.\n- **Unified Ecosystem**: Shared utilities for banking, legal, and market data.\n\n---\n\n## 🛠 Available Servers\n\n| Server | Domain | Tools | Description |\n| :--- | :--- | :---: | :--- |\n| **GST** | Taxation | 5 | Validate GSTINs, HSN codes, and tax calculations. |\n| **Railways** | Transport | 7 | Live train status, PNR enquiry, and schedules. |\n| **RTO** | Automotive | 6 | Vehicle registration details and road tax calculator. |\n| **Banking** | Fintech | 3 | IFSC search, UPI validation, and bank status. |\n| **Stocks** | Markets | 8 | NSE/BSE real-time quotes, indices, and history. |\n| **eCourts** | Legal | 6 | Court cases, orders, and cause list retrieval. |\n\nDetailed catalog: [docs/SERVERS.md](./docs/SERVERS.md) | Full Tool Index: [docs/TOOLS.md](./docs/TOOLS.md)\n\n---\n\n## 📦 Installation\n\n```bash\nnpm install -g @samarth-23-eng/india-mcp\n```\n\n**Quick start — launch any server with one command:**\n\n```bash\nindia-mcp stocks       # NSE/BSE stock data\nindia-mcp gst          # GST validation\nindia-mcp ecourts      # Court case lookup\nindia-mcp fssai        # Food license verification\nindia-mcp list         # Show all available servers\nindia-mcp --help       # Full usage guide\n```\n\nOr use `npx` without installing:\n\n```bash\nnpx @samarth-23-eng/india-mcp stocks\n```\n\n---\n\n## 🔌 MCP Client Configuration\n\n### Claude Desktop\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"india-stocks\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@samarth-23-eng/india-mcp\", \"stocks\"]\n    },\n    \"india-ecourts\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@samarth-23-eng/india-mcp\", \"ecourts\"]\n    },\n    \"india-gst\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@samarth-23-eng/india-mcp\", \"gst\"]\n    }\n  }\n}\n```\n\nDetailed guides: [docs/EXAMPLES.md](./docs/EXAMPLES.md)\n\n---\n\n## 🏗 Architecture\n\nIndia-MCP uses a shared resilience layer to handle the instability of Indian government portals.\n- **Retries**: 2 retries with exponential backoff for all network calls.\n- **Caching**: TTL-based memory cache to prevent IP blocking.\n- **Fallbacks**: Automatic switching to backup data sources.\n\nTechnical details: [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md)\n\n---\n\n## 🛤 Roadmap\n\nPlanned servers:\n- [ ] **eCourts (Extended)**: Supreme Court and High Court specific filters.\n- [ ] **FSSAI**: Food license validation.\n- [ ] **CDSCO**: Medicine registry verification.\n- [ ] **Land Records**: Digital Bhulekh access.\n\n---\n\n## 🚀 Release Process\n\n1. **Bump Version**: `npm version patch --no-git-tag-version`\n2. **Build**: `npm run build`\n3. **Validate**: `npm run validate:publish`\n4. **Publish to npm**: `npm publish --access public`\n5. **Registry**: `mcp-publisher validate` & `mcp-publisher publish`\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) to get started.\n\n---\n\n## 📄 License\n\nMIT © [Samarth-23-eng](https://github.com/Samarth-23-eng)\n\n",
  "bytes": 4604,
  "sha": "67de0371d60f10a2929386d8c73f812b804a1ffeecc0f25c9fd9520d3bd6b7d0",
  "repo_slug": "samarth-23-eng/india-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_samarth_23_eng_india_mcp_93f08582/readme"
}