io.github.Samarth-23-eng/india-mcp

🇮🇳 India MCP

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

🏗 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