mcpField
I
india-mcp-gst

india-mcp-gst

Local
github.com/Samarth-23-engFinance1Updated 25w ago
Repository

About india-mcp-gst

india-mcp-gst is an MCP server for Indian Goods and Services Tax tasks, intended for agents that need to verify tax details or calculate amounts. It supports GSTIN validation, HSN search, and tax calculations.

Key features

  1. 01Validate GSTINs
  2. 02Search HSN codes
  3. 03Calculate tax

Use cases

  1. 01Verify a business GSTIN
  2. 02Find an item's HSN code
  3. 03Calculate tax on goods or services

MCP support

It exposes GSTIN validation, HSN search, and tax calculation tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "samarth-23-eng-india-mcp-gst": {
      "command": "npx",
      "args": [
        "-y",
        "@samarth-23-eng/india-mcp"
      ]
    }
  }
}
Run commandnpx -y @samarth-23-eng/india-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@samarth-23-eng/india-mcp1.0.7

Tools

5

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

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

ServerDomainToolsDescription
GSTTaxation5Validate GSTINs, HSN codes, and tax calculations.
RailwaysTransport7Live train status, PNR enquiry, and schedules.
RTOAutomotive6Vehicle registration details and road tax calculator.
BankingFintech3IFSC search, UPI validation, and bank status.
StocksMarkets8NSE/BSE real-time quotes, indices, and history.
eCourtsLegal6Court cases, orders, and cause list retrieval.

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.