English Français العربية

io.github.CsoftTarun/gstinapi-mcp

السجل الرسمي الأمن

GSTIN verification, GST filing history and HSN/SAC lookup for India.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package gstinapi-mcp
Claude Code 
claude mcp add gstinapi-mcp -e 'GSTINAPI_API_KEY=<your gstinapi_api_key>' -- npx -y gstinapi-mcp@1.0.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "gstinapi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "gstinapi-mcp@1.0.2"
            ],
            "env": {
                "GSTINAPI_API_KEY": "<your gstinapi_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • GSTINAPI_API_KEY إلزامي سري Your gstinapi.in API key. Free at https://www.gstinapi.in/register — up to 100 free lookups, no card required.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. gstinapi-mcp
  2. Setup
  3. Tools
  4. Accuracy notes
  5. Billing
  6. License

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

الأسئلة الشائعة

ما هو io.github.CsoftTarun/gstinapi-mcp؟

GSTIN verification, GST filing history and HSN/SAC lookup for India.

كيف أثبّت io.github.CsoftTarun/gstinapi-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add gstinapi-mcp -e 'GSTINAPI_API_KEY=<your gstinapi_api_key>' -- npx -y gstinapi-mcp@1.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CsoftTarun/gstinapi-mcp إلى مفتاح API؟

نعم. يتطلب GSTINAPI_API_KEY، وتضبطها في إعداداته.

هل io.github.CsoftTarun/gstinapi-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.CsoftTarun/gstinapi-mcp؟

ينشره CsoftTarun. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.