India Mcp Gst

io.github.Samarth-23-engPublished by GitHub account Samarth-23-engv1.0.7Updated Oct 24, 2026

MCP server for India GST: validate GSTIN, search HSN, calculate tax.

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.Samarth-23-eng/india-mcp-gst
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account Samarth-23-eng for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Samarth-23-eng%2Findia-mcp-gst.svg)](https://sourceweft.com/mcp/io.github.Samarth-23-eng%2Findia-mcp-gst?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server for India GST that lets an assistant validate GSTINs, look up HSN codes and calculate tax.

What you can do: Validate GSTIN numbers and check their format and status through the GST server tools (5 tools in total). Look up HSN codes for goods and services classification. Calculate GST tax amounts. The package also bundles other India-focused servers (railways, RTO, banking, stocks, eCourts) launched by a subcommand, but this entry covers the GST server.
When to use it: Useful when working with Indian tax and invoicing data: checking whether a GSTIN is valid, classifying items by HSN code, or computing GST on an amount. Worth adding if your workflow touches Indian business compliance rather than general web lookups.
Requirements: Runs as a local process via npm package @samarth-23-eng/india-mcp over stdio; needs Node.js and npx or a global install. No accounts, API keys, environment variables or headers are declared. Network access is needed for the underlying lookups.

Before you install

The server queries external Indian government and enterprise portals, which the README describes as unstable and rate-limited; results may be slow or incomplete. Validation and tax figures are informational and should not replace official filings or professional advice. No credentials are requested, but requests go to third-party sites.

Installation

In SourceWeft

Open India Mcp Gst in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

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 | Full Tool Index: docs/TOOLS.md

📦 Installation

Quick start — launch any server with one command:

bash

india-mcp stocks       # NSE/BSE stock dataindia-mcp gst          # GST validationindia-mcp ecourts      # Court case lookupindia-mcp fssai        # Food license verificationindia-mcp list         # Show all available serversindia-mcp --help       # Full usage guide

india-mcp stocks       # NSE/BSE stock dataindia-mcp gst          # GST validationindia-mcp ecourts      # Court case lookupindia-mcp fssai        # Food license verificationindia-mcp list         # Show all available serversindia-mcp --help       # Full usage guide

Or use npx without installing:

🔌 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"]    }  }}

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

Bump Version: npm version patch --no-git-tag-version
Build: npm run build
Validate: npm run validate:publish
Publish to npm: npm publish --access public
Registry: mcp-publisher validate & mcp-publisher publish

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines to get started.

📄 License

Source: README.md at commit 0574fca

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.7LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts