EuroValidate MCP 서버

EuroValidate용 MCP(Model Context Protocol) 서버 — Claude, ChatGPT 및 모든 MCP 지원 에이전트가 EU VAT 번호(VIES), IBAN 및 EORI 통관 번호를 검증하고, 기업 데이터를 조회하며, VAT 세율을 확인할 수 있게 해주는 하나의 신뢰할 수 있는 REST API입니다.

왜 필요한가

유럽 비즈니스 데이터를 검증하려면 일반적으로 다섯 개의 분산된 정부 서비스를 조합해야 합니다: 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