VAT Validation

check-vat-vies-mcp

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jazib-but-check-vat-vies-mcp-jazib": {
      "command": "node",
      "args": [
        "/path/to/check-vat-vies-mcp/dist/index.js"
      ],
      "env": {
        "PORT": "3000",
        "API_KEY": "secret",
        "NODE_ENV": "production",
        "RATE_LIMIT": "60",
        "ALLOWED_ORIGINS": "*"
      }
    }
  }
}

You can validate EU VAT numbers in real time and access AI-powered assistance through an MCP Server that integrates the VAT validation workflow into Claude Desktop. This server exposes a REST API for validation and provides an MCP endpoint so Claude can orchestrate VAT checks locally with auto-detection and status monitoring.

How to use

You will configure Claude Desktop to connect to the MCP Server, then use the MCP command to perform VAT validations. The server auto-detects country codes from VAT numbers and returns validation results, company details, and address information when available. Use it for quick one-off checks, batch validation via your automation tooling, or integration with your existing workflows.

How to install

Prerequisites you need installed on your system:

Node.js (version 14+ recommended)
npm (comes with Node.js)
Git

Option A — Run the API and MCP server locally (recommended for development and testing):

# Clone the repository
git clone https://github.com/jazib/check-vat-vies-mcp.git
cd check-vat-vies-mcp

# Install dependencies
npm install

# Build TypeScript to JavaScript (if project uses TS)
npm run build

# Start the API server in development/production as needed
node api-server.js

Option B — Run with Docker (production-ready option):

# Using Docker Compose
docker-compose up

# Or build and run manually
docker build -f Dockerfile.api -t vat-api .
docker run -p 3000:3000 vat-api

Option C — Use a pre-built Docker image (quick start):

docker run -p 3000:3000 ghcr.io/jazib/check-vat-vies-mcp:latest

Additional configuration and MCP setup

The MCP server is designed to work with Claude Desktop. You will add a small runtime configuration to Claude Desktop to point to the local MCP server. This enables Claude to invoke VAT validation on demand and incorporate the results into your AI-driven workflows.

MCP Server configuration (Claude Desktop)

{
  "mcpServers": {
    "vies_vat_check": {
      "command": "node",
      "args": ["/path/to/check-vat-vies-mcp/dist/index.js"],
      "env": {},
      "description": "EU VAT validation"
    }
  }
}

Notes on environment and usage

Environment variables you may use include PORT for the API server, NODE_ENV to specify the environment, RATE_LIMIT to throttle requests, ALLOWED_ORIGINS for CORS, and API_KEY for optional authentication. When you configure Claude Desktop, you can keep these as part of your local runtime environment or pass them through the MCP runner as needed.

Available tools

validateVat

Validates an EU VAT number using the VIES service and returns validity, country, and VAT details.

autoDetectVat

Automatically extract country code from a VAT number and validate it.

healthCheck

Check the health/status of the VIES service and the VAT validation endpoint.

getMemberStates

List all EU member states supported by the VAT validation server.