Gstinapi Mcp

io.github.CsoftTarunPublished by GitHub account CsoftTarunv1.0.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.CsoftTarun/gstinapi-mcp
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 CsoftTarun 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.CsoftTarun%2Fgstinapi-mcp.svg)](https://sourceweft.com/mcp/io.github.CsoftTarun%2Fgstinapi-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local MCP server that lets an assistant verify Indian GSTINs, check GST filing and compliance history, and look up HSN/SAC codes via gstinapi.in.

What you can do: Verify GSTINs: live registration lookup with legal name, status, taxpayer type and address, plus today's usage count for the key. Check filing history: GSTR-1/3B returns for a financial year, a summarised compliance view with counts, lag and last period, and monthly versus quarterly (QRMP) filing preference. Look up HSN/SAC codes: official description for a code, and find codes from a description.
When to use it: Useful when an assistant needs to check whether an Indian business's GST registration is valid, review a supplier's or customer's GST filing record, or resolve HSN/SAC codes for invoicing and classification work.
Requirements: Runs locally via npx (Node.js) over stdio, configured in the MCP client. Requires a gstinapi.in API key supplied in the GSTINAPI_API_KEY environment variable; a free key allows up to 100 lookups. Network access to gstinapi.in is needed for every call.

Before you install

The API key is a secret passed in the environment; keep it out of shared configs. Lookups are billed as pay-per-use credits on the gstinapi.in account once free lookups run out. Every GSTIN query goes live to the GST network and is sent to gstinapi.in, so taxpayer details leave your machine. HSN results do not include GST rates.

Installation

In SourceWeft

Open Gstinapi Mcp 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

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

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
Add this server to your MCP client config, e.g. for Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):

json

{  "mcpServers": {    "gstinapi": {      "command": "npx",      "args": ["-y", "gstinapi-mcp"],      "env": {        "GSTINAPI_API_KEY": "your-api-key-here"      }    }  }}

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

Tool	What it does
`verify_gstin`	Live registration lookup: legal name, status, taxpayer type, address
`get_gstin_returns`	GSTR-1/3B filing history for a financial year
`get_gstin_compliance`	Filing history summarised — counts, lag, last period
`get_gstin_filing_preference`	Monthly vs quarterly (QRMP), quarter by quarter
`lookup_hsn_code`	Official description for an HSN/SAC code
`search_hsn_codes`	Find HSN/SAC codes from a description
`get_usage_stats`	Today'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

Source: README.md at commit 43a1bd4

Tools

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

Version history

v1.0.2LatestSep 20, 2026
v1.0.1Sep 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