Veriport: EU VAT number, IBAN, VAT rates and e-invoice checks について
Veriportは、欧州のVAT、IBAN、企業、Peppol、税率、電子請求書を確認するエージェント向けstdio MCPサーバーです。Veriport APIを通じて6種類のツールを提供し、検証内容と情報源を返します。
主な機能
- 01VIESによるVAT番号の検証
- 02IBANの構造とチェックサムの検証
- 03国別またはカテゴリ別のEU VAT税率
- 04電子請求書のスキーマとルール検証
- 05フランス企業登記情報の検索
- 06Peppol参加者と受信文書の確認
活用シーン
- 01VAT番号を確認し公開済みの登録情報を取得
- 02IBANの構造とSEPA対応状況を確認
- 03対応プロファイルに基づく電子請求書の検証
- 04フランス企業またはPeppolの請求書受信可否を検索
MCP 対応
Veriportはstdio方式のMCPサーバーで、Veriport APIを使った6種類の決定的な確認ツールを提供します。MCPクライアントは`@veriport/mcp`で接続でき、APIキーは任意です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @veriport/mcpVERIPORT_API_KEYシークレットYour Veriport API key (vp_live_…, free at https://veriport.io/signup). Optional: without it the API answers 20 calls a day per address.VERIPORT_API_BASEThe API base URL; defaults to https://veriport.io/api/v1.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
6掲載時のツール一覧 · 1 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| number | string | はい | VAT 番号。2 文字のプレフィックスは省略可能で、スペースやピリオドも使用できます(例:"DE136695976")。 |
| record | boolean | いいえ | この検証結果をアカウントの保存記録として保持します(有料プラン)。 |
| country | string | いいえ | 番号にプレフィックスがない場合の、2 文字の加盟国コード。 |
| requester | string | いいえ | VIES 照会番号を取得するための、お客様自身の EU VAT 番号(有料プラン)。 |
詳細
Veriport MCP サーバー
依存関係がなく、ファイルは1つだけ、Node 18+で動作する、stdio経由の最小限のModel Context Protocolサーバーです。Veriport APIを利用して、エージェントに4つの決定論的なチェック機能を提供します。
| ツール | 機能 |
|---|---|
validate_vat | 構造と各国のチェックディジットを確認し、欧州委員会のVIESでリアルタイム照会します。valid、公開されている場合は登録名と住所、日付、データの出所(source.kindはlive/cache/structure_only、source.stale)を返します。有料キーでは、requesterを含むVIES照会番号も返します。 |
validate_iban | IBANの5つのチェック(文字、国、長さ、mod 97-10、BBANパターン)と失敗したルール、銀行識別子と支店識別子、SEPAフラグを確認します。口座が存在するかどうかは判定しません。 |
vat_rate | EU加盟国1か国の標準、軽減、超軽減、駐車場税率を、7つのカテゴリーヒント、verifiedOn、公式情報源とともに返します。または、27か国にわたる1つのカテゴリーの税率を返します。 |
validate_einvoice | 電子請求書(テキスト形式のxml、またはpdf_base64のZUGFeRD/Factur-X PDF)を、プロファイルのXMLスキーマと公式シュトロンに照らして検証します(CEN EN 16931 1.3.16、XRechnung 3.0.2、Peppol BIS 3.0.21)。valid、プロファイル、構文、公開済みルールIDとXPathを含むエラーを返し、最初に1行の要約を表示します。1回のチェックにつき5回の呼び出しが必要です(キーなしの場合は1日4回)。ネットワークに送信されることも、保存されることもありません。 |
french_company | 公式登録機関(Recherche d'entreprises、フォールバックとしてINSEE Sirene)からSIREN(9桁)またはSIRET(14桁)でフランス企業を検索します。名称、法的形態、NAF活動、営業中または廃業済みの状況と日付、本社住所、SIRETの場合は事業所、SIRENから算出したVAT番号、登録機関の情報を参照した日時を返します。1回の呼び出しです。 |
peppol_participant | この企業はPeppol請求書を受信できますか?idにはPeppol ID(0208:0202239951)、または0208と9925で検索するベルギーの企業番号またはVAT番号を指定します。登録状況、受信する文書(Peppol BIS Billing 3.0のreceives.invoice、receives.creditNote)、Peppol Directoryに登録されたプロバイダーと名称を返し、最初に1行の要約を表示します。1回の呼び出しです。ネットワークに送信されることはありません。 |
制限は例外ではなく、ツールエラーとして返されます。429は再試行できる時刻を、402は無料利用枠を使い切ったことを、503は応答しなかった上流サービスを示します。
1行でインストール
claude mcp add veriport -e VERIPORT_API_KEY=vp_live_… -- npx -y @veriport/mcp
(パッケージがnpmに公開された後はnpx -y @veriport/mcpを実行してください。それまでは、リポジトリをチェックアウトしてnode mcp/server.mjsを実行してください。)
環境変数:VERIPORT_API_KEY(省略可能。vp_live_…。指定しない場合、APIの利用回数はアドレスごとに1日20回です)、VERIPORT_API_BASE(既定値はhttps://veriport.io/api/v1)。
Claude Desktop / Claude Code
{
"mcpServers": {
"veriport": {
"command": "npx",
"args": ["-y", "@veriport/mcp"],
"env": { "VERIPORT_API_KEY": "vp_live_…" }
}
}
}
claude mcp add veriport -e VERIPORT_API_KEY=vp_live_… -- npx -y @veriport/mcp
Cursor、Windsurf、Zed、Continue
クライアントのMCP設定で、同じcommand/args/envブロックを指定してください。このサーバーはstdioトランスポートでプロトコルバージョン2025-06-18を使用し、toolsのみをアドバタイズします。
テスト
node --test mcp/test/*.test.mjs
テストではローカルポートで偽のAPIを起動し、stdio経由でサーバーを実行します。initialize、tools/list、6つのツール(無効な電子請求書と有効な電子請求書、XMLとPDF)、429/503/422/引数不足の各状態を確認します。
レジストリのマニフェストと掲載情報
このフォルダーの server.json は、公式 MCP レジストリのマニフェストです(スキーマ 2025-12-11、名前 io.veriport/veriport、stdio 経由の npm パッケージ @veriport/mcp、2 つの環境変数)。公開は所有者が次の順序で行います。このフォルダーから npm publish --access public を実行し(レジストリは package.json の mcpName フィールドとサーバー名を照合します)、続けてこのフォルダーから mcp-publisher login github と mcp-publisher publish を実行します。掲載ディレクトリ(glama.ai、Smithery、Cursor)は、同じマニフェストと npm パッケージを参照します。
掲載情報:名前 veriport、カテゴリは金融/データ、ライセンスは MIT、公開者は Janolab Studio LLC(テキサス州オースティン)、ホームページは https://veriport.io/docs、ソースは https://github.com/zenomoung/veriport-sdk(フォルダー mcp)。欧州委員会、SWIFT、INSEE、INPI とは関係ありません。税務に関する助言ではありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。