Vatnode

vatnode-mcp

vatnode の公式 Model Context Protocol サーバーです。AI エージェント向けに、VAT の検証と EU の税務データを提供します。

AI アシスタント（Claude Desktop、Cursor、ChatGPT、Continue、Cline、…）は、チャットから離れることなく VAT 税率の検索、VAT 番号形式の確認、EU VIES サービスを利用した VAT ID の検証を行えます。

• 無料、オフライン対応 — アカウント不要で、欧州45か国の VAT 税率と形式を確認できます
• リアルタイム検証 — VIES に対して EU の VAT 番号を検証し、登録企業と VIES 照会番号を取得できます（無料の vatnode API キーが必要です。照会番号は、ダッシュボードの Account details で申請者として自身の VAT 番号を設定すると発行されます）
• 用途を絞った5つのツール — エージェントがツールを正確に選択できるよう、詳細に説明されています
• stdio のみで動作し、ホストされた依存関係はゼロ。npx でローカル実行できます

---

ツール

ツール	無料	説明
get_country_vat_rates	✅	国ごとの標準税率／軽減税率／超軽減税率／駐車税率と VAT 番号形式
list_eu_vat_rates	✅	EU 加盟27か国（北アイルランドの XI を含む）の税率をまとめて取得
check_vat_format	✅	国別の正規表現に基づく VAT 番号のオフライン構文チェック
list_supported_countries	✅	対応する45か国すべてと、VIES による完全な検証に対応している国を一覧表示
validate_vat_number	🔑	VIES によるリアルタイム検証。妥当性、企業名、住所、登録日、および（ダッシュボードの Account details で申請者の VAT 番号を設定した場合）VIES 照会番号を返します

無料ツールは完全にオフラインで動作します。データは eu-vat-rates-data に同梱されており、欧州委員会の TEDB から毎日更新されます。

validate_vat_number には vatnode API キーが必要です。無料プランには月間リクエスト上限が含まれています — 30秒で取得できます。

---

インストール

Claude Desktop

claude_desktop_config.json に追加します（macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "vatnode": {
      "command": "npx",
      "args": ["-y", "vatnode-mcp"],
      "env": {
        "VATNODE_API_KEY": "vat_live_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。ツールの選択画面に vatnode ツールが表示されます。

無料ツール（税率、形式チェック）のみを使用する場合は、VATNODE_API_KEY を省略できます。

Cursor

Settings → MCP → Add new server：

{
  "mcpServers": {
    "vatnode": {
      "command": "npx",
      "args": ["-y", "vatnode-mcp"],
      "env": { "VATNODE_API_KEY": "vat_live_your_key_here" }
    }
  }
}

ChatGPT（カスタムコネクター／Apps SDK）

同じ npx -y vatnode-mcp コマンドを使用して、stdio MCP サーバーとして設定します。Apps SDK のドキュメント を参照してください。

Continue／Cline／その他のクライアント

MCP 互換のクライアントであれば接続できます。npx -y vatnode-mcp を指定し、必要に応じて環境変数で VATNODE_API_KEY を渡してください。

---

API キーを取得する

validate_vat_number の利用には vatnode アカウントが必要です。このプラットフォームでは、MCP が公開していない以下の機能も提供しています。

• VAT ステータス変更の Webhook（顧客の VAT を継続的に監視）
• 一括検証
• VIES が停止している場合の各国データベースへのフォールバック
• VIES 照会番号（VIES に対してチェックを行ったことを示す、タイムスタンプ付きの記録）
• キーごとのレート制限とダッシュボード分析

無料で登録 →

---

使用例

あなた： フィンランドとドイツのVAT税率はいくつですか？

(エージェントが FI と DE の get_country_vat_rates を呼び出します（無料、キー不要）。)

エージェント： フィンランドの標準VAT税率は25.5％、ドイツは19％です。フィンランドには14％と10％の軽減税率があり、ドイツには7％の軽減税率があります。

あなた： IE6388047V は有効なVAT番号ですか？

(エージェントが validate_vat_number を呼び出します（APIキーが必要です）。)

エージェント： はい、有効です。Dublin 4 の Barrow Street、Gordon House にある GOOGLE IRELAND LIMITED に登録されています。

---

設定

環境変数	必須	デフォルト	用途
VATNODE_API_KEY	validate_vat_number の場合	—	https://vatnode.dev から取得した API キー
VATNODE_API_URL	いいえ	https://api.vatnode.dev	API のベース URL を上書きします（セルフホスト／ステージング）

---

コントリビューション

バグ報告や PR を歓迎します。方向性をすり合わせられるよう、大きな変更の場合はまず Issue を作成してください。

git clone https://github.com/vatnode/vatnode-mcp.git
cd vatnode-mcp
npm install
npm test

リリース

リリースは Trusted Publishing を介して npm に公開されます。NPM_TOKEN シークレットは不要で、すべてのリリースは npm provenance によって署名されます。

# bump the version in ALL of: package.json, src/index.ts (VERSION),
# and server.json (top-level "version" + packages[0].version — the MCP
# Registry publish reads server.json and rejects a duplicate version).
# Commit, then:
git tag v0.3.2
git push --tags

.github/workflows/release.yml の CI がタグを検知して公開します。

ライセンス

MIT