io.github.CsoftTarun/gstinapi-mcp
GSTIN verification, GST filing history and HSN/SAC lookup for India.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
gstinapi-mcpclaude mcp add gstinapi-mcp -e 'GSTINAPI_API_KEY=<your gstinapi_api_key>' -- npx -y gstinapi-mcp@1.0.2
{
"mcpServers": {
"gstinapi-mcp": {
"command": "npx",
"args": [
"-y",
"gstinapi-mcp@1.0.2"
],
"env": {
"GSTINAPI_API_KEY": "<your gstinapi_api_key>"
}
}
}
}
Variables d'environnement
GSTINAPI_API_KEYobligatoire secret Your gstinapi.in API key. Free at https://www.gstinapi.in/register — up to 100 free lookups, no card required.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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.jsonor.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
| 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
Questions fréquentes
Qu'est-ce que io.github.CsoftTarun/gstinapi-mcp ?
GSTIN verification, GST filing history and HSN/SAC lookup for India.
Comment installer io.github.CsoftTarun/gstinapi-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add gstinapi-mcp -e 'GSTINAPI_API_KEY=<your gstinapi_api_key>' -- npx -y gstinapi-mcp@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.CsoftTarun/gstinapi-mcp ?
Oui. Il attend GSTINAPI_API_KEY, à renseigner dans sa configuration.
io.github.CsoftTarun/gstinapi-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.CsoftTarun/gstinapi-mcp ?
Il est publié par CsoftTarun. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.