English Français العربية

io.github.CsoftTarun/gstinapi-mcp

Official registry Security

GSTIN verification, GST filing history and HSN/SAC lookup for India.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package gstinapi-mcp
Claude Code 
claude mcp add gstinapi-mcp -e 'GSTINAPI_API_KEY=<your gstinapi_api_key>' -- npx -y gstinapi-mcp@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "gstinapi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "gstinapi-mcp@1.0.2"
            ],
            "env": {
                "GSTINAPI_API_KEY": "<your gstinapi_api_key>"
            }
        }
    }
}

Environment variables

  • GSTINAPI_API_KEY required secret Your gstinapi.in API key. Free at https://www.gstinapi.in/register — up to 100 free lookups, no card required.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. gstinapi-mcp
  2. Setup
  3. Tools
  4. Accuracy notes
  5. Billing
  6. License

gstinapi-mcp

An MCP server for gstinapi.in — GSTIN verification, GST return/compliance history and HSN/SAC code lookup, callable directly from Claude and other MCP clients.

This is a thin wrapper around the REST API at gstinapi.in/docs. It holds no logic of its own — every tool call is one authenticated HTTP request, and the response is returned as-is.

Setup

  1. Get a free API key — up to 100 free lookups (25 on signup, 25 for each of three setup steps), no card required: https://www.gstinapi.in/register
  2. Add this server to your MCP client config, e.g. for Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):
{
  "mcpServers": {
    "gstinapi": {
      "command": "npx",
      "args": ["-y", "gstinapi-mcp"],
      "env": {
        "GSTINAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

No install step — npx fetches it on first use.

Tools

ToolWhat it does
verify_gstinLive registration lookup: legal name, status, taxpayer type, address
get_gstin_returnsGSTR-1/3B filing history for a financial year
get_gstin_complianceFiling history summarised — counts, lag, last period
get_gstin_filing_preferenceMonthly vs quarterly (QRMP), quarter by quarter
lookup_hsn_codeOfficial description for an HSN/SAC code
search_hsn_codesFind HSN/SAC codes from a description
get_usage_statsToday's call count for the key (free)

Full field-level reference: https://www.gstinapi.in/docs

Accuracy notes

  • Every GSTIN lookup queries the GST network live — nothing is cached.
  • No GST rate is returned from the HSN endpoints — a rate depends on more than the code alone, and the government's own master publishes no rate column.

Billing

Pay-per-use credits on your gstinapi.in account, no separate charge for this MCP server. Pricing: https://www.gstinapi.in/pricing

License

MIT

Frequently asked questions

What is io.github.CsoftTarun/gstinapi-mcp?

GSTIN verification, GST filing history and HSN/SAC lookup for India.

How do I install io.github.CsoftTarun/gstinapi-mcp?

It runs on your machine. In Claude Code: claude mcp add gstinapi-mcp -e 'GSTINAPI_API_KEY=<your gstinapi_api_key>' -- npx -y gstinapi-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.CsoftTarun/gstinapi-mcp need an API key?

Yes. It expects GSTINAPI_API_KEY, which you set in its configuration.

Is io.github.CsoftTarun/gstinapi-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.CsoftTarun/gstinapi-mcp?

It is published by CsoftTarun. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.