VIES VAT Validator MCP

VIES VAT Validator MCP 🇪🇺

VIES VAT Validator MCP は、公式の無料 VIES SOAP API を通じて EU VAT 番号を検証します。ローカルでの形式事前チェック＋無料の TTL キャッシュと、バイリンガル（日本語／英語）のエラーコードを組み合わせています。越境 EC や貿易を行う販売者にとって、「規制対応に必須」のコンプライアンスツールです。

現在のバージョン：1.0.3 · ライセンス： MIT · 信頼性： 読み取り専用で構築され、秘密情報の外部送信はなく、バイリンガルエラーを自己修復します。

英語 — EU VAT を2段階で検証します。無料のオフライン形式事前チェックの後、VIES にリアルタイムで問い合わせ、バイリンガルのエラーコードを返します。 簡体字中国語 — EU VAT を2段階で検証します。無料のローカル形式事前チェック＋公式 VIES による実際の確認を行い、中国語と英語のエラーコードを返します。 繁体字中国語 — EU VAT を2段階で検証します。無料のローカル形式事前チェック＋公式 VIES による実際の確認を行い、中国語と英語のエラーコードを返します。

🌐 英語 · 簡体字中国語 · 繁体字中国語

所在地	リンク
MCP エンドポイント	https://neeenja--vies-vat-validator-mcp.apify.actor/mcp
Apify Store	https://apify.com/neeenja/vies-vat-validator-mcp
ソース	https://github.com/PanStories/vies-vat-validator-mcp
掲載先	Sartbot Featured

---

英語

このツールが作られた理由

• 規制対応に必須 — EU の B2B 取引では、取引相手の VAT 番号の確認（リバースチャージ／コンプライアンス証明）が必要です。
• VIES は遅く、不安定です — 公式の SOAP エンドポイントはリクエストを頻繁に制限し、よく停止するため、キャッシュと適切な縮退動作が不可欠です。
• コールドスタートのコストはゼロ — 無料の公式データソースを薄いレイヤーでラップし、説明可能なバイリンガル出力を提供します。イベント単位で利用できます。

提供的功能

功能	备注	料金
validate_vat	無料のローカル形式チェック後、任意で VIES によるリアルタイム検証を実行します。構造化されたエラーとバイリンガルのエラーを返します	1 イベントあたり $0.0005（→ 2026-11-06 から $0.005）
check_vat_format	ローカルのみで実行する正規表現による形式チェック — ネットワーク接続不要、無料	無料
list_supported_countries	対応国 — 現地語の名称 + 現地の VAT の呼称 + 中文/EN	無料
get_error_codes	エラーコードの完全なバイリンガル一覧	無料
リソース	vat://error-codes / vat://supported-countries / vat://spec	無料
プロンプト	vat_compliance_guide / explain_vat_result	無料

EU 27 か国 + GB + XI（北アイルランド）に対応しています。各国について、現地語の名称と、さらに便利なVAT 番号の現地での呼称も収録しています。これは実際に人々が検索する表現です。

コード Code	母語名 Native	現地の VAT の呼称 Local VAT term	中文	English	EU
AT	Österreich	UID-Nummer	オーストリア	Austria	✅
BE	België / Belgique	BTW-nummer / numéro de TVA	ベルギー	Belgium	✅
BG	България	ДДС номер	ブルガリア	Bulgaria	✅
CY	Κύπρος / Kıbrıs	Αριθμός ΦΠΑ	キプロス	Cyprus	✅
CZ	Česko	DIČ	チェコ	Czech Republic	✅
DE	Deutschland	USt-IdNr.	ドイツ	Germany	✅
DK	Danmark	CVR-nummer	デンマーク	Denmark	✅
EE	Eesti	KMKR number	エストニア	Estonia	✅
EL	Ελλάδα	Αριθμός ΦΠΑ	ギリシャ	Greece	✅
ES	España	NIF (IVA)	スペイン	Spain	✅
FI	Suomi	ALV-numero	フィンランド	Finland	✅
FR	France	numéro de TVA	フランス	France	✅
HR	Hrvatska	PDV broj	クロアチア	Croatia	✅
HU	Magyarország	ÁFA-szám	ハンガリー	Hungary	✅
IE	Ireland / Éire	VAT number	アイルランド	Ireland	✅
IT	Italia	Partita IVA	イタリア	Italy	✅
LT	Lietuva	PVM kodas	リトアニア	Lithuania	✅
LU	Lëtzebuerg / Luxembourg	numéro TVA	ルクセンブルク	Luxembourg	✅
LV	Latvija	PVN numurs	ラトビア	Latvia	✅
MT	Malta	VAT number	マルタ	Malta	✅
NL	Nederland	btw-nummer	オランダ	Netherlands	✅
PL	Polska	NIP	ポーランド	Poland	✅
PT	Portugal	NIF	ポルトガル	Portugal	✅
RO	România	cod de TVA	ルーマニア	Romania	✅
SE	Sverige	momsregistreringsnummer	スウェーデン	Sweden	✅
SI	Slovenija	ID za DDV	スロベニア	Slovenia	✅
SK	Slovensko	IČ DPH	スロバキア	Slovakia	✅
GB	United Kingdom	VAT registration number	英国	United Kingdom	—
XI	Northern Ireland	VAT registration number (XI)	北アイルランド	Northern Ireland	—

呼称は現地のビジネスで一般的な表記に基づいています。国によっては公式に認められている表記が複数ありますが、表には主な表記を記載しています。 呼称は現地のビジネスで一般的な用法に従っています。国によっては複数の表記が認められていますが、主な表記を示しています。

クイックスタート（ローカル）

npm install
npm run build
npm start            # stdio transport, connects to any MCP client
npm test             # vitest, all green
npm run verify       # generate verify-report.html with real payloads

MCP クライアントに接続する（stdio）

{
  "mcpServers": {
    "vat-validator": {
      "command": "node",
      "args": ["/abs/path/vies-vat-validator-mcp/dist/index.js"]
    }
  }
}

HTTP 経由で接続する（リモート / Apify）

MCP クライアントの接続先に Streamable HTTP エンドポイントを指定します。

https://neeenja--vies-vat-validator-mcp.apify.actor/mcp

ヘッダー Authorization: Bearer <APIFY_TOKEN> を指定します。

呼び出し例

形式の事前チェック（無料）

{ "name": "check_vat_format", "arguments": { "vat": "FR123456789" } }

→ { "formatValid": true, "normalized": "FR123456789", "pattern": "^([A-Z]{2})?\\d{9}$" }

リアルタイム検証（有料イベント）

{ "name": "validate_vat", "arguments": { "vat": "FR123456789", "useCache": true, "live": true } }

→ { "valid": true, "formatValid": true, "viesValid": true, "source": "vies", "name": "...", "address": "..." }

エラーコード（一部）

コード	中文	EN
VAT_FORMAT_INVALID	形式が一致しません	format mismatch
VAT_VIES_INVALID	VIES によると無効です	VIES says invalid
VIES_MS_UNAVAILABLE	加盟国のシステムが利用できません	member state down
VIES_TIMEOUT	タイムアウト	timeout
NETWORK_ERROR	ネットワークエラー	network error

完全な一覧は get_error_codes または vat://error-codes から確認できます。

デプロイ（Apify Pay-Per-Event）

npm run apify:login      # complete KYC yourself first (one-time)
npm run apify:validate   # validate actor.json
npm run apify:push       # publish to Apify Store

料金設定は .actor/actor.json → pricingEvents にあります。形式／エラー／国の照会は無料で、課金対象は mcp-validate-vat のみです。

設計上の譲れない方針

• express / soap / fast-xml-parser は使用しません。SOAP エンベロープは手作業で構築し、レスポンスは名前空間に依存しない正規表現で解析します。
• クラッシュさせません。VIES の障害やネットワークエラーは、バイリンガルのエラーコードに変換します。
• 無料レイヤー（形式チェック＋キャッシュ）により、コールドスタートのコストをゼロに抑えます。

契約の詳細は SPEC.md をご覧ください。

---

简体中文

このツールを作った理由

• 規制対応に不可欠 —— EU の B2B 取引では、取引相手の VAT 番号の確認が必要です（リバースチャージ／コンプライアンス証明）。
• VIES は遅く、不安定 —— 公式 SOAP インターフェースは頻繁にレート制限がかかり、時折停止します。そのため、キャッシュと適切なフォールバックは必須です。
• コールドスタートのコストはゼロ —— 無料の公式データソースに、ラッパーと説明付きのバイリンガル出力を組み合わせ、イベント単位で課金します。

利用できる機能

機能	説明	料金
validate_vat	まず無料のローカル形式チェックを行い、必要に応じて EU 公式 VIES インターフェースで有効性を確認します。構造化されたバイリンガルのエラーを返します	$0.0005 / 回（2026-11-06 より $0.005）
check_vat_format	ローカルの正規表現による形式チェックのみ。ネットワーク不要、無料	無料
list_supported_countries	対応国を返します（母語名＋現地での VAT の呼称＋中国語／英語）	無料
get_error_codes	中国語／英語の完全なエラーコード一覧を返します	無料
resources	vat://error-codes / vat://supported-countries / vat://spec	無料
prompts	vat_compliance_guide / explain_vat_result	無料

対象は EU 27 か国＋GB＋XI（北アイルランド）です。各国の母語名に加え、より実用的な現地での VAT 番号の呼称も掲載しています。現地の人が実際に検索するのは、こうした語句です。

コード Code	母語名 Native	現地の VAT 用語 Local VAT term	日本語	English	EU
AT	Österreich	UID-Nummer	オーストリア	Austria	✅
BE	België / Belgique	BTW-nummer / numéro de TVA	ベルギー	Belgium	✅
BG	България	ДДС номер	ブルガリア	Bulgaria	✅
CY	Κύπρος / Kıbrıs	Αριθμός ΦΠΑ	キプロス	Cyprus	✅
CZ	Česko	DIČ	チェコ	Czech Republic	✅
DE	Deutschland	USt-IdNr.	ドイツ	Germany	✅
DK	Danmark	CVR-nummer	デンマーク	Denmark	✅
EE	Eesti	KMKR number	エストニア	Estonia	✅
EL	Ελλάδα	Αριθμός ΦΠΑ	ギリシャ	Greece	✅
ES	España	NIF (IVA)	スペイン	Spain	✅
FI	Suomi	ALV-numero	フィンランド	Finland	✅
FR	France	numéro de TVA	フランス	France	✅
HR	Hrvatska	PDV broj	クロアチア	Croatia	✅
HU	Magyarország	ÁFA-szám	ハンガリー	Hungary	✅
IE	Ireland / Éire	VAT number	アイルランド	Ireland	✅
IT	Italia	Partita IVA	イタリア	Italy	✅
LT	Lietuva	PVM kodas	リトアニア	Lithuania	✅
LU	Lëtzebuerg / Luxembourg	numéro TVA	ルクセンブルク	Luxembourg	✅
LV	Latvija	PVN numurs	ラトビア	Latvia	✅
MT	Malta	VAT number	マルタ	Malta	✅
NL	Nederland	btw-nummer	オランダ	Netherlands	✅
PL	Polska	NIP	ポーランド	Poland	✅
PT	Portugal	NIF	ポルトガル	Portugal	✅
RO	România	cod de TVA	ルーマニア	Romania	✅
SE	Sverige	momsregistreringsnummer	スウェーデン	Sweden	✅
SI	Slovenija	ID za DDV	スロベニア	Slovenia	✅
SK	Slovensko	IČ DPH	スロバキア	Slovakia	✅
GB	United Kingdom	VAT registration number	イギリス	United Kingdom	—
XI	Northern Ireland	VAT registration number (XI)	北アイルランド	Northern Ireland	—

呼称は現地のビジネスで一般的な表記に従っています。国によっては複数の正式な表記が認められているため、表には主な表記を掲載しています。 呼称は現地のビジネスで一般的な表記に従っています。国によっては複数の形式が認められているため、主なものを掲載しています。

クイックスタート（ローカル）

npm install
npm run build
npm start            # stdio 传输，接任意 MCP 客户端
npm test             # vitest 全绿
npm run verify       # 生成真实 payload 验证报告 verify-report.html

MCP クライアントとの接続（stdio）

{
  "mcpServers": {
    "vat-validator": {
      "command": "node",
      "args": ["/abs/path/vies-vat-validator-mcp/dist/index.js"]
    }
  }
}

HTTP 経由の接続（リモート／Apify）

MCP クライアントを Streamable HTTP エンドポイントに接続します。

https://neeenja--vies-vat-validator-mcp.apify.actor/mcp

リクエストヘッダー Authorization: Bearer <APIFY_TOKEN> も指定してください。

呼び出し例

形式の事前チェック（無料）

{ "name": "check_vat_format", "arguments": { "vat": "FR123456789" } }

→ { "formatValid": true, "normalized": "FR123456789", "pattern": "^([A-Z]{2})?\\d{9}$" }

実際の照会（有料イベント）

{ "name": "validate_vat", "arguments": { "vat": "FR123456789", "useCache": true, "live": true } }

→ { "valid": true, "formatValid": true, "viesValid": true, "source": "vies", "name": "...", "address": "..." }

エラーコード（一部）

コード	日本語	EN
VAT_FORMAT_INVALID	形式が一致しません	format mismatch
VAT_VIES_INVALID	VIES により無効と判定されました	VIES says invalid
VIES_MS_UNAVAILABLE	加盟国のシステムが利用できません	member state down
VIES_TIMEOUT	タイムアウト	timeout
NETWORK_ERROR	ネットワークエラー	network error

完全な一覧は get_error_codes または vat://error-codes をご覧ください。

デプロイ（Apify Pay-Per-Event）

npm run apify:login      # 本人先完成 KYC（一次性）
npm run apify:validate   # 校验 actor.json
npm run apify:push       # 上架

課金の詳細は .actor/actor.json の pricingEvents をご覧ください。形式チェック／エラー／国の照会は無料で、mcp-validate-vat のみ課金対象です。

設計上の譲れない方針

• express / soap / fast-xml-parser は使用しません。SOAP エンベロープは手作業で構築し、レスポンスは名前空間に依存しない正規表現で解析します。
• クラッシュさせません。VIES の障害やネットワークエラーはすべて、バイリンガルのエラーコードに変換します。
• 無料レイヤー（形式チェック＋キャッシュ）により、コールドスタートのコストをゼロに抑えます。

契約の詳細は SPEC.md をご覧ください。

---

繁體中文

なぜ作ったのか

• 規制上の必須要件 —— EU の B2B 取引では、取引相手の VAT 番号の確認が求められます（リバースチャージ／コンプライアンス証憑）。
• VIES は遅く、不安定 —— 公式 SOAP インターフェースは頻繁にレート制限がかかり、ときどき停止するため、キャッシュと適切なフォールバックは必須です。
• コールドスタートコストゼロ —— 無料の公式データソースに、ラッパーと説明付きのバイリンガル出力を重ね、イベント単位で課金します。

利用できる機能

機能	説明	料金
validate_vat	まず無料のローカル形式チェックを行い、必要に応じて EU 公式 VIES インターフェースで実在性を確認します。構造化されたバイリンガルのエラーを返します	$0.0005 / 回（2026-11-06 以降 $0.005）
check_vat_format	純粋なローカル正規表現による形式チェックです。ネットワーク不要、コストゼロ	無料
list_supported_countries	対応国（母語名、現地での VAT の呼び方、中国語／英語）を返します	無料
get_error_codes	中国語・英語の完全なエラーコード一覧を返します	無料
resources	vat://error-codes / vat://supported-countries / vat://spec	無料
prompts	vat_compliance_guide / explain_vat_result	無料

EU 27 か国 + GB + XI（北アイルランド）に対応しています。各国の母語名に加えて、より実用的な現地での VAT 番号の呼び方も含まれています。現地の人が実際に検索する言葉です。

コード	母語名	現地での VAT の呼び方	日本語	英語	EU
AT	Österreich	UID-Nummer	オーストリア	オーストリア	✅
BE	België / Belgique	BTW-nummer / numéro de TVA	ベルギー	ベルギー	✅
BG	България	ДДС номер	ブルガリア	ブルガリア	✅
CY	Κύπρος / Kıbrıs	Αριθμός ΦΠΑ	キプロス	キプロス	✅
CZ	Česko	DIČ	チェコ	チェコ	✅
DE	Deutschland	USt-IdNr.	ドイツ	ドイツ	✅
DK	Danmark	CVR-nummer	デンマーク	デンマーク	✅
EE	Eesti	KMKR number	エストニア	エストニア	✅
EL	Ελλάδα	Αριθμός ΦΠΑ	ギリシャ	ギリシャ	✅
ES	España	NIF (IVA)	スペイン	スペイン	✅
FI	Suomi	ALV-numero	フィンランド	フィンランド	✅
FR	France	numéro de TVA	フランス	フランス	✅
HR	Hrvatska	PDV broj	クロアチア	クロアチア	✅
HU	Magyarország	ÁFA-szám	ハンガリー	ハンガリー	✅
IE	Ireland / Éire	VAT number	アイルランド	アイルランド	✅
IT	Italia	Partita IVA	イタリア	イタリア	✅
LT	Lietuva	PVM kodas	リトアニア	リトアニア	✅
LU	Lëtzebuerg / Luxembourg	numéro TVA	ルクセンブルク	ルクセンブルク	✅
LV	Latvija	PVN numurs	ラトビア	ラトビア	✅
MT	Malta	VAT number	マルタ	マルタ	✅
NL	Nederland	btw-nummer	オランダ	オランダ	✅
PL	Polska	NIP	ポーランド	ポーランド	✅
PT	Portugal	NIF	ポルトガル	ポルトガル	✅
RO	România	cod de TVA	ルーマニア	ルーマニア	✅
SE	Sverige	momsregistreringsnummer	スウェーデン	スウェーデン	✅
SI	Slovenija	ID za DDV	スロベニア	スロベニア	✅
SK	Slovensko	IČ DPH	スロバキア	スロバキア	✅
GB	United Kingdom	VAT registration number	イギリス	イギリス	—
XI	Northern Ireland	VAT registration number (XI)	北アイルランド	北アイルランド	—

呼び方は現地のビジネスで一般的な表記に準拠しています。一部の国では複数の表記が公式に認められており、表には主なものを記載しています。 用語は現地のビジネスで一般的な表記に準拠しています。一部の国では複数の形式が認められており、主なものを記載しています。

クイックスタート（ローカル）

npm install
npm run build
npm start            # stdio 傳輸，接任意 MCP 用戶端
npm test             # vitest 全綠
npm run verify       # 產生真實 payload 驗證報告 verify-report.html

MCP クライアントとの接続（stdio）

{
  "mcpServers": {
    "vat-validator": {
      "command": "node",
      "args": ["/abs/path/vies-vat-validator-mcp/dist/index.js"]
    }
  }
}

HTTP 経由での接続（リモート / Apify）

MCP クライアントを Streamable HTTP エンドポイントに向けます。

https://neeenja--vies-vat-validator-mcp.apify.actor/mcp

リクエストヘッダー Authorization: Bearer <APIFY_TOKEN> も付与してください。

呼び出し例

形式の事前チェック（無料）

{ "name": "check_vat_format", "arguments": { "vat": "FR123456789" } }

→ { "formatValid": true, "normalized": "FR123456789", "pattern": "^([A-Z]{2})?\\d{9}$" }

実際の確認（有料イベント）

{ "name": "validate_vat", "arguments": { "vat": "FR123456789", "useCache": true, "live": true } }

→ { "valid": true, "formatValid": true, "viesValid": true, "source": "vies", "name": "...", "address": "..." }

エラーコード（一部）

コード	日本語	英語
VAT_FORMAT_INVALID	形式が一致しません	format mismatch
VAT_VIES_INVALID	VIES が無効と判定しました	VIES says invalid
VIES_MS_UNAVAILABLE	加盟国のシステムを利用できません	member state down
VIES_TIMEOUT	タイムアウト	timeout
NETWORK_ERROR	ネットワークエラー	network error

完全な一覧は get_error_codes または vat://error-codes をご覧ください。

デプロイ（Apify Pay-Per-Event）

npm run apify:login      # 本人先完成 KYC（一次性）
npm run apify:validate   # 校驗 actor.json
npm run apify:push       # 上架

料金設定は .actor/actor.json の pricingEvents をご覧ください。形式チェック／エラー／国の照会は無料で、mcp-validate-vat のみ課金されます。

設計上の禁止事項

• express / soap / fast-xml-parser は導入しません。SOAP エンベロープは手書きし、レスポンスは名前空間に依存しない正規表現で抽出します。
• 決してクラッシュさせません。VIES の障害／ネットワークエラーはすべてバイリンガルのエラーコードにマッピングします。
• 無料枠（形式チェック + キャッシュ）により、コールドスタート時のコストゼロを保証します。

完全な仕様については SPEC.md をご覧ください。

---

ライセンス

MIT — LICENSE をご覧ください。

プライバシー

読み取り専用でステートレスです。アカウントは不要で、個人データも収集しません。送信された VAT 番号は EU 公式 VIES サービスに転送され、メモリのみのキャッシュに保持される場合があります。PRIVACY.md をご覧ください。

---

サポート · スポンサー · スポンサー

EN — VIES VAT Validator MCP はオープンソース（MIT）で、広告はありません。広告ではなく、コミュニティの支援によって運営されています。エージェントやワークフローを支えている場合は、ぜひご支援ください：

• ☕ Ko-fi（このリポジトリの Sponsor ❤️ ボタンからアクセスできます）：https://ko-fi.com/panstories

簡体中文 — VIES VAT Validator MCP はオープンソース（MIT）で、広告はありません。広告ではなく、コミュニティの支援によって運営されています。エージェントやワークフローを支えている場合は、ぜひご支援ください。このリポジトリの Sponsor ボタンをクリック（Ko-fi に移動）するか、https://ko-fi.com/panstories にアクセスしてください。

繁體中文 — VIES VAT Validator MCP はオープンソース（MIT）で、広告はありません。広告ではなく、コミュニティの支援によって運営されています。エージェントやワークフローを支えている場合は、ぜひご支援ください。このリポジトリの Sponsor ボタンをクリック（Ko-fi に移動）するか、https://ko-fi.com/panstories にアクセスしてください。

ありがとうございます！ · ありがとう · ありがとう 💙