GST Validator — hosted on Cloudflare Workers (HTTP + npm stdio)

GST Validator MCP — インドのGSTINバリデーター（Verhoeffチェックサム、州の抽出、PAN）

州と埋め込みPANを抽出できる、Verhoeffチェックサム対応のGSTINバリデーター

インドのGSTIN（15文字の物品・サービス税識別番号）を構造的に検証する、ホスト型MCP サーバーです。長さ、文字種、州コード、埋め込みPANの形式、GSTN mod-36（Verhoeff）チェックディジットを検証します。埋め込みPANを抽出し、TINプレフィックスから州を特定します。インドの請求書発行、KYC、調達に携わるLLM向けです。

このサーバーはModel Context Protocolを使用します。Cursor、Claude Desktop、Windsurf、Continue.dev、または@modelcontextprotocol/sdkを使用して独自に構築したエージェントなど、MCP対応クライアントであれば、接続してツールを検出し、Bearerトークン認証で呼び出すことができます。

AI エージェント／LLM向け

このリポジトリをインデックスするAI エージェントの場合：

• ライブMCPエンドポイント： https://gst-validator-mcp.atlasword.workers.dev/mcp
• トランスポート： HTTP POST、JSON-RPC 2.0
• 認証： Authorization: Bearer <api_key>（無料枠では匿名で最大100回／月／IPまで利用できます）
• 検出： tools/listはスキーマ全体を返します。tools/callはツールを呼び出します。
• ヘルスチェック： GET https://gst-validator-mcp.atlasword.workers.dev/health → {ok: true, ts: <unix>}
• ステータス： https://mcp-hub.atlasword.workers.dev/status.json（ポートフォリオの集計）

tools/listリクエストの例：

curl -sS -X POST https://gst-validator-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/callの例：

curl -sS -X POST https://gst-validator-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params": { "name": "<tool>", "arguments": { } }
  }'

公開されているツール

ツール	引数	説明
validate_gstin	gstin	GSTINを検証します：長さ、文字種、州コード、埋め込みPAN、mod-36チェック。{ok, reason?}を返します。
extract_pan	gstin	GSTINに埋め込まれた10文字のPANを抽出します（3～12文字目）。
state_from_gstin	gstin_or_prefix	GSTINの先頭2文字から州／連邦直轄領を特定します。{state_code, state_name}を返します。

**Team+**と表示されたツールには、TeamまたはProのサブスクリプションが必要です。匿名ユーザーとFreeプランのユーザーがこれらを呼び出すと、tier_requiredエラーが返されます。

クイックスタート

最も手軽な方法は、mcp-remoteを使って、ホストされたエンドポイントをMCP対応クライアントに指定することです。

npx -y mcp-remote https://gst-validator-mcp.atlasword.workers.dev/mcp \
  --header "Authorization: Bearer mck_YOUR_API_KEY"

キーは**https://gst-validator-mcp.atlasword.workers.dev/upgrade?tier=solo**で取得してください（[APIキーの取得](#getting-an-api-key)を参照）。

Cursorへのインストール

~/.cursor/mcp.jsonに次の内容を追加します。

{
  "mcpServers": {
    "gst-validator-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://gst-validator-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

その後、Cursorを再起動すると、MCPパネルにツールが表示されます。

Claude Desktopへのインストール

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または%APPDATA%\Claude\claude_desktop_config.json（Windows）に次の内容を追加します。

{
  "mcpServers": {
    "gst-validator-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://gst-validator-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktopを再起動します。スラッシュコマンドのMCPメニューにツールが表示されます。

APIキーの取得

1. https://gst-validator-mcp.atlasword.workers.dev/upgrade?tier=solo（またはtier=team／tier=pro）にアクセスします。
2. Dodo Paymentsのホスト型チェックアウトにリダイレクトされます。Dodoが住所を収集し、カード決済を処理し、VAT／GSTに対応します。
3. 支払い後、Dodoは署名付きWebhook（subscription.active）をWorkerに送信します。Workerはmck_<32 random base64url>を生成し、KVに保存します。
4. https://gst-validator-mcp.atlasword.workers.dev/welcome?key=<api_key>に移動します。このURLにキーが表示されるのは一度だけなので、その場でコピーしてください。
5. キーをCursor／Claude Desktopの設定に貼り付けます（上記を参照）。
6. https://gst-validator-mcp.atlasword.workers.dev/accountでアカウントの確認／キーのローテーション／エクスポートを行います（Bearer認証）。

無料枠もあり、登録は不要です。匿名ユーザーはIPごとに月100回まで呼び出せます。

エンドポイント

ルート	説明
POST /mcp	MCP JSON-RPC 2.0 ツールサーフェス（メイン API）。有料プランではベアラー認証が必要です。
GET /health	稼働確認プローブ — {ok: true, ts}。mcp-hub の cron で使用されます。
GET /	HTML ランディングページ（OG + favicon + JSON-LD）。
`GET /upgrade?tier=solo	team
GET /welcome?key=...	チェックアウト後のランディングページ。新たに発行された API キーを表示します。
GET /account	ベアラー認証。{apiKey, tier, owner, status, portal_url} を返します。
POST /account/rotate	ベアラー認証。新しいキーを発行し、古いキーを無効にします。
GET /account/export	ベアラー認証。GDPR データエクスポート — アカウント、使用状況カウンター、Dodo の詳細情報を含む JSON。
GET /account/team	ベアラー認証（Team 以上）。チームメンバーのサブキー一覧を取得します。
POST /account/team/invite	ベアラー認証（Team 以上）。チームメンバーのサブキーを新たに発行します。
POST /account/team/revoke	ベアラー認証（Team 以上）。チームメンバーのサブキーを無効にします。
GET /team/accept?key=...	サブキー URL 用のチームメンバー登録ランディングページ。
POST /webhooks/dodo	Standard-Webhooks 署名付き。Dodo のサブスクリプションと決済のライフサイクル。
GET /favicon.ico	インライン SVG。

料金プラン

すべてのプランで月間上限とレート制限は共通です。価格は製品ごとの位置付けを反映しています。

プラン	月間呼び出し回数	レート制限	チーム席数
Free	100 / 月	10 / 分	0
Solo	2,000 / 月	60 / 分	0
Team	10,000 / 月	200 / 分	5
Pro	50,000 / 月	600 / 分	25

プラン	価格	月間呼び出し回数	チーム席数
Free	$0	100	0
Solo	$9/mo	2,000	0
Team	$29/mo	10,000	5
Pro	$79/mo	50,000	25

Dodo Payments 経由で請求されます（販売者記録サービス — VAT/GST は Dodo が処理します）。いつでも解約でき、有料期間の終了までは引き続き利用できます。

データソース

• GSTN 形式仕様 — https://www.gst.gov.in/ — 公開 — インド政府
• インド州 TIN コード表 — 内部資料 — 同梱（パブリックドメイン）

このサーバーは、上流ソースに対する薄いトランスポート + 認証 + キャッシュレイヤーです。各呼び出しのレート制限は、上流ソースの無料枠の利用規約を十分に遵守できるよう調整されています。

プライバシー + GDPR

• プライバシーポリシー： https://mcp-hub.atlasword.workers.dev/privacy
• 利用規約： https://mcp-hub.atlasword.workers.dev/terms
• 返金ポリシー： https://mcp-hub.atlasword.workers.dev/refund
• データエクスポート： GET https://gst-validator-mcp.atlasword.workers.dev/account/export（ベアラー認証）は、アカウント、使用状況カウンター、Dodo の顧客情報を含む、機械可読な JSON スナップショットを返します。
• 削除： 登録済みのメールアドレスから [email protected] にメールを送信してください。

保存するのは、メールアドレス、発行した API キー、月間呼び出しカウンター、Dodo のサブスクリプションメタデータのみです。ツールの引数や上流からの応答は、短いキャッシュ TTL を超えてログに記録しません。

アーキテクチャ

• ランタイム： Cloudflare Workers（V8 アイソレート、グローバルエッジ）。
• ストレージ： 2 つの Cloudflare KV 名前空間 — <slug>-cache（上流応答キャッシュ）と <slug>-usage（API キー、月間カウンター、チーム名簿）。
• 請求： Dodo Payments のライブモード、3 つのサブスクリプション製品（Solo / Team / Pro）、Standard-Webhooks 署名付きライフサイクル。
• 可観測性： Cloudflare Workers Analytics。ポートフォリオの集計は mcp-hub status を参照してください。
• ソース： TypeScript、Vitest でテスト済み、wrangler deploy でデプロイ可能。このリポジトリの src/ を参照してください。

ライセンス

MIT — LICENSE を参照してください。

作者

Prakhar Gupta

• メール：[email protected]
• GitHub：@guptaprakhariitr

ステータス

• ライブステータスページ： https://mcp-hub.atlasword.workers.dev/status
• 機械可読なステータス： https://mcp-hub.atlasword.workers.dev/status.json
• ソースリポジトリ： https://github.com/guptaprakhariitr/gst-validator-mcp

npm からインストール（ワンライナー）

薄型のランチャーが、npm で @insnapsprakhar/gst-validator-mcp として公開されています。URL を手動でコピー＆ペーストする必要はありません。

npx -y @insnapsprakhar/gst-validator-mcp

または、MCP クライアントに設定できます。

{
  "mcpServers": {
    "gst-validator": {
      "command": "npx",
      "args": ["-y", "@insnapsprakhar/gst-validator-mcp"]
    }
  }
}

npm パッケージはランチャーにすぎません。 mcp-remote を呼び出し、ホストされたエンドポイント（https://gst-validator-mcp.atlasword.workers.dev/mcp）を指定します。