mcpField
G
gstinapi-mcp

gstinapi-mcp

Local
github.com/CsoftTarunFinance0Updated 1d ago
Repository

About gstinapi-mcp

gstinapi-mcp wraps the gstinapi.in REST API as an MCP server for users who need Indian GST data. It supports live GSTIN checks, return and compliance history, and HSN/SAC lookups, returning API responses directly.

Key features

  1. 01Look up live GSTIN registration details
  2. 02Retrieve GST return and compliance history
  3. 03Check monthly or quarterly filing preferences
  4. 04Find HSN/SAC codes by code or description
  5. 05Check daily API-key usage

Use cases

  1. 01Verify a business's GSTIN status and address
  2. 02Review filing records for a financial year
  3. 03Find HSN/SAC codes from a product description

MCP support

The MCP server exposes tools for GSTIN verification, return and compliance history, HSN/SAC lookup, and usage statistics. Each call makes an authenticated HTTP request to the gstinapi.in REST API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "csofttarun-gstinapi": {
      "command": "npx",
      "args": [
        "-y",
        "gstinapi-mcp"
      ],
      "env": {
        "GSTINAPI_API_KEY": "<GSTINAPI_API_KEY>"
      }
    }
  }
}
Run commandnpx -y gstinapi-mcp
Environment variables to set
GSTINAPI_API_KEYSecretYour gstinapi.in API key. Free at https://www.gstinapi.in/register — up to 100 free lookups, no card required.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmgstinapi-mcp1.0.2

Tools

7

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
gstinstringYes15-character GSTIN, e.g. 27AAPFU0939F1ZV
include_profilebooleanNo

Details

From the project 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

  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.

Tools

ToolWhat it does
verify_gstinLive registration lookup: legal name, status, taxpayer type, address
get_gstin_returnsGSTR-1/3B filing history for a financial year
get_gstin_complianceFiling history summarised — counts, lag, last period
get_gstin_filing_preferenceMonthly vs quarterly (QRMP), quarter by quarter
lookup_hsn_codeOfficial description for an HSN/SAC code
search_hsn_codesFind HSN/SAC codes from a description
get_usage_statsToday'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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.