India MCP

🇮🇳 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

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

Quick start — launch any server with one command:

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:

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](./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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Samarth-23-eng
• Source: Samarth-23-eng/India-MCP
• License: MIT
• Homepage: https://india-mcp.vercel.app

Install and usage instructions live in the source repository linked above.