Skip to main content
Glama

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.

Related MCP server: gst-india-mcp

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

More from gstinapi.in:

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 tools
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.

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

    A3.9/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      An 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.
      76
      76 PyPI
      87
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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