gstinapi-mcp

gstinapi-mcp

gstinapi.in 用の MCP サーバーです。GSTIN の検証、GST 申告・コンプライアンス履歴の確認、HSN/SAC コードの検索を、Claude やその他の MCP クライアントから直接呼び出せます。

gstinapi.in/docs の REST API を薄くラップしたものです。独自のロジックはなく、各ツール呼び出しで認証済みの HTTP リクエストを 1 回送信し、レスポンスをそのまま返します。

セットアップ

1. 無料の API キーを取得します。最大 100 回まで無料で検索できます（登録時に 25 回、セットアップ手順を 3 つ完了するごとに 25 回）。カードは不要です：https://www.gstinapi.in/register
2. このサーバーを MCP クライアントの設定に追加します。たとえば、Claude Desktop／Claude Code の場合は（claude_desktop_config.json または .mcp.json）：

{
  "mcpServers": {
    "gstinapi": {
      "command": "npx",
      "args": ["-y", "gstinapi-mcp"],
      "env": {
        "GSTINAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

インストール手順はありません。初回使用時に npx が取得します。

ツール

ツール	機能
verify_gstin	登録情報をリアルタイムで照会します：正式名称、ステータス、納税者の種類、住所
get_gstin_returns	会計年度ごとの GSTR-1／3B 申告履歴を取得します
get_gstin_compliance	申告履歴を件数、遅延、直近の期間に要約します
get_gstin_filing_preference	月次と四半期ごと（QRMP）の申告方式を、四半期ごとに取得します
lookup_hsn_code	HSN/SAC コードの公式説明を取得します
search_hsn_codes	説明から HSN/SAC コードを検索します
get_usage_stats	キーの本日の呼び出し回数を確認します（無料）

フィールドごとの詳細なリファレンス：https://www.gstinapi.in/docs

精度に関する注意事項

• GSTIN を照会するたびに GST ネットワークへリアルタイムで問い合わせます。キャッシュはありません。
• HSN エンドポイントから GST 税率は返されません。税率はコードだけで決まるものではなく、政府の公式マスターにも税率の列はありません。

料金

gstinapi.in アカウントの従量課金クレジットを使用します。この MCP サーバーに別途料金はかかりません。料金：https://www.gstinapi.in/pricing

ライセンス

MIT