gstinapi-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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. |
| 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. |
| get_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. |
| get_gstin_filing_preferenceA | Whether the taxpayer files Monthly or Quarterly (QRMP), quarter by quarter, for the given financial year. |
| 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. |
| 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. |
| 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. |
| 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. |
| search_mca_companiesB | Fuzzy company-name search over the MCA registry, optionally filtered by state and status, paginated. |
| get_usage_statsA | How many calls this API key has made today. Free — does not consume a credit. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.