gstinapi-mcp
An MCP server for gstinapi.in that exposes GSTIN, GST return/compliance, HSN/SAC, and MCA company lookup tools via authenticated API calls.
Verify a GSTIN live: legal/trade name, status, taxpayer type, constitution, registration date, address, and optional profile details.
Fetch GSTR-1/3B filing history, summarized compliance facts, and monthly vs QRMP filing preference for a financial year.
Look up HSN/SAC codes by code or search by description; no GST rate is returned.
Look up MCA companies by CIN, search companies by name/state/status with pagination, and get a probabilistic GSTIN-to-company match that is not authoritative.
Check today's API-key call count for free.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gstinapi-mcp Verify GSTIN 27AAPFU0939F1ZV and show the registered business name and address."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: gst-india-mcp
Tools
Tool | What it does |
| Live registration lookup: legal name, status, taxpayer type, address |
| GSTR-1/3B filing history for a financial year |
| Filing history summarised — counts, lag, last period |
| Monthly vs quarterly (QRMP), quarter by quarter |
| Official description for an HSN/SAC code |
| Find HSN/SAC codes from a description |
| Today's call count for the key (free) |
Full field-level reference: https://www.gstinapi.in/docs
More from gstinapi.in:
E-way bill and e-invoice API: every call explained, with error codes
GSTR-2B and GSTR-2A API: the ITC statement and the 12 GSTR-2A tables as JSON
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
Available Tools
10 toolsget_gstin_complianceA
The return filing history summarised per return type: filed count, last period filed, months since it, and average filing lag from period end. Facts only — no on-time percentage or defaulter flag is computed; apply your own thresholds, keeping in mind a quarterly (QRMP) filer legitimately shows multi-month gaps.
Inputs: gstin (required), financial_year (required).
get_gstin_filing_preferenceA
Whether the taxpayer files Monthly or Quarterly (QRMP), quarter by quarter, for the given financial year.
Inputs: gstin (required), financial_year (required).
get_gstin_returnsB
Every GSTR-1 / GSTR-3B (and other type) return a GSTIN filed in the given financial year, with period, filing date, status, and ARN.
Inputs: gstin (required), financial_year (required).
get_usage_statsA
How many calls this API key has made today. Free — does not consume a credit.
Inputs: no named parameters.
lookup_hsn_codeA
The official description for a 2-8 digit HSN (goods) or SAC (services) code, plus the chapter/heading/subheading it sits under. No GST rate is returned — the government's own master publishes no rate column, and a rate depends on more than the code alone.
Inputs: code (required).
lookup_mca_companyA
Direct company-master lookup by CIN (Corporate Identification Number) from India's ~3.67M registered companies (source: data.gov.in RoC-wise Company Master Data, refreshed roughly quarterly). Company master fields only — no directors, charges, filings, or financial statements.
Inputs: cin (required).
resolve_gstin_to_companyA
Matches a GSTIN to its probable company in the MCA registry. IMPORTANT: this match is probabilistic, not authoritative — no government dataset publishes a GSTIN-to-CIN mapping, so this is a scored guess from company-name similarity plus weak corroborating signals, returned with a high/medium/low confidence band. Never present the result as a confirmed fact; tell the user it is a probable match and point them to mca.gov.in to verify anything with legal, financial, or compliance consequence.
Inputs: gstin (required).
search_hsn_codesA
Find HSN/SAC codes from a free-text description. Exact code matches rank first, then descriptions starting with the term, then descriptions containing it.
Inputs: query (required), kind, limit.
search_mca_companiesB
Fuzzy company-name search over the MCA registry, optionally filtered by state and status, paginated.
Inputs: name (required), page, state, status.
verify_gstinA
Look up the live GST registration for a GSTIN: legal name, trade name, status, taxpayer type, constitution of business, registration date, and registered address. Every call queries the GST network in real time — nothing is served from a cache. Set include_profile for jurisdiction codes, e-invoicing status, nature of business, and additional places of business at no extra cost.
Inputs: gstin (required), include_profile.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Every tool targets a distinct action-entity pair: HSN code lookup vs search, MCA CIN lookup vs fuzzy search, live GSTIN verification, returns listing, compliance summary, filing preference, and the probabilistic cross-reference are clearly separable. Even the GSTIN-related tools differ in output granularity and purpose.
All tool names use lowercase snake_case with a clear action-object pattern: lookup/search pairs for registries, get_ for GSTIN financial facts, verify_ for live registration lookup, and resolve_ for the cross-domain match. The varying verbs reflect different operation types rather than inconsistent naming.
With 10 tools, the server is well-scoped: each tool covers a distinct lookup, search, verification, or analysis operation, and none feel redundant or unnecessary for the stated GSTIN/HSN/MCA domain.
The toolset covers HSN/SAC lookup and search, MCA company lookup and search, live GSTIN verification, returns history, compliance summaries, filing preference, and a GSTIN-to-company cross-reference. Minor gaps exist—such as no direct GSTIN search by name/PAN and no detailed MCA filings or director data—but these are explicitly out of scope and core verification/compliance workflows have no dead ends.
Maintenance
Related MCP Connectors
Identity resolution MCP server for phone/email lookups across 31+ services. Global + India coverage.
380+ live data, validation and utility APIs in one MCP server: IP, DNS, email, FX, weather and more.
AI for Tally Prime and Tally ERP 9. Hosted MCP server to ask your accounts in any language.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Related MCP Servers
- AlicenseAqualityBmaintenanceAn offline-first MCP server for Indian financial, tax, and government APIs, providing tools for identity validation (PAN, Aadhaar, GSTIN), tax calculations (Income Tax, TDS, GST), and master data lookups (IFSC, Pincode, HSN/SAC) with zero authentication required.7676 PyPI87MIT
- AlicenseAqualityBmaintenanceEnables India GST operations: verify GSTINs, search by PAN, track return filings, and with an OTP-based taxpayer session, access GSTR-2B/3B and cash/ITC ledgers.1316 npm2MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents and onboarding/KYB workflows to validate VAT and EORI numbers, look up companies, screen sanctions lists, and run combined checks through remote MCP tools and a pay-per-call API.MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to query public ICEGATE customs data without login, including shipping bill status, import duty calculations, CBIC exchange rates, code and trade-guide lookups, and GSTIN status.GPL 3.0