EuroValidate MCP Server

EuroValidate 向けの MCP (Model Context Protocol) サーバー — Claude、ChatGPT、および MCP 対応の任意のエージェントが、EU の VAT 番号 (VIES)、IBAN、EORI 通関番号の検証、企業データの検索、VAT 税率の取得を、信頼性の高い単一の REST API を通じて行えるようにします。

なぜ

ヨーロッパの企業データの検証は、通常、5つの断片化された政府サービスをやりくりすることを意味します: VIES SOAP API (常にタイムアウトし、ドイツだけでそのエラーの95%を生成)、EC EORI エンドポイント、HMRC、GLEIF、および各国の登録機関です。EuroValidate はこれらを、国ごとのサーキットブレーカーとグレースフルデグラデーションを備えたキャッシュファーストの JSON API にまとめ、この MCP サーバーはそれを LLM エージェントにすぐ使えるツールとして公開します。

Related MCP server: eu-company-mcp-server

ツール

セットアップ

1. eurovalidate.com で無料の API キーを取得します (月100リクエスト、クレジットカード不要)。

2. サーバーを MCP クライアントに追加します:

Claude Desktop / Claude Code

{
  "mcpServers": {
    "eurovalidate": {
      "command": "uvx",
      "args": ["eurovalidate-mcp"],
      "env": { "EUROVALIDATE_API_KEY": "your_api_key" }
    }
  }
}

Claude Code ワンライナー:

claude mcp add eurovalidate -e EUROVALIDATE_API_KEY=your_api_key -- uvx eurovalidate-mcp

その他の MCP クライアント

stdio で実行:

EUROVALIDATE_API_KEY=your_api_key uvx eurovalidate-mcp

または恒久的にインストール: pip install eurovalidate-mcp → eurovalidate-mcp。

プロンプト例

• "VAT 番号 DE811569869 を検証して、その背後にある会社を教えてください"

• "この IBAN が有効かどうか、どの銀行に属するかを確認してください: DE89 3704 0044 0532 0130 00"

• "今ドイツで VIES はダウンしていますか?"

• "ポルトガルの VAT 税率はいくらですか?"

• "請求書を発行する前に、これら5つのサプライヤーの VAT 番号を検証してください"

エージェント (および人間) 向けの注意事項

• ドイツとスペインは VIES 経由で会社名/住所を返しません (データ保護法) — フォールバックとして lookup_company_by_vat を使用してください。

• ギリシャは VIES では EL ですが、ISO 3166 では GR です — 両方受け入れられます。

• すべてのレスポンスには confidence: HIGH|MEDIUM|LOW|UNKNOWN と上流の source が含まれるため、政府サービスがダウンしているときにエージェントはデータの鮮度を推論できます。

• 無料プラン: 月100リクエスト。有料プランは月額 €19 から (月500,000リクエスト) eurovalidate.com で。

環境変数

ライセンス

MIT

mcp-name: io.github.Nitrych/eurovalidate-mcp