Vat Validator MCP

by OjasKord

246 downloads
Not rated
GitHub

About

VAT number validation for AI agents. EU VIES, UK HMRC, and Australian ABN in one call. Catches invoice fraud and verifies supplier registrations.

Details

Author
OjasKord
Downloads
246
Categories
Other

- Validates VAT numbers against EU VIES, UK HMRC, and Australian ABR
- AI-powered fraud risk analysis with CLEAR/REVIEW/BLOCK recommendations
- AI-powered invoice detail comparison against official registry data
- Batch validation of up to 10 numbers (paid only)
- Current VAT rates for all 27 EU states, UK, and Australia
- Real-time data sourcing with source URL and timestamp in every response

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Vat Validator MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure the server in your MCP client with the URL https://vat-validator-mcp-production.up.railway.app or add it via Smithery using npx -y @smithery/cli@latest mcp add OjasKord/vat-validator-mcp. The free tier requires no API key; upgrade plans are available for higher call volumes.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "vat validator mcp": {
            "vat-validator-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli@latest",
                    "mcp",
                    "add",
                    "OjasKord/vat-validator-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "vat-validator-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli@latest",
            "mcp",
            "add",
            "OjasKord/vat-validator-mcp"
        ]
    }
}

VAT Validator MCP — Business Identity Verification & Invoice Fraud Detection

Validate EU, UK, and Australian VAT numbers against live government registries. Plus AI-powered fraud risk analysis and invoice verification — so your agent doesn't just know a VAT number is valid, it knows whether to proceed with the transaction.

Free tier: 20 calls/month. No API key required. Just connect and go.

Quick Start

{
  "vat-validator": {
    "url": "https://vat-validator-mcp-production.up.railway.app"
  }
}

Or via Smithery:

npx -y @smithery/cli@latest mcp add OjasKord/vat-validator-mcp

Why Use This

A VAT number is the most reliable identifier for a registered business in the EU, UK, and Australia. Validating it confirms the company is real and legally registered. But validation alone isn't enough — scammers use valid VAT numbers with mismatched company names, or invoice from newly registered shells. The AI tools in this server catch what raw validation misses.

Required for EU ViDA mandatory e-invoicing compliance from 2026.

Tools

validate_vat

Validate any EU, UK, or Australian VAT number against live government registries. Auto-detects country from prefix. Use before any B2B transaction, supplier onboarding, or invoice approval.

- EU (all 27 member states) via EU VIES (ec.europa.eu/taxation_customs/vies)
- UK (GB prefix) via UK HMRC (api.service.hmrc.gov.uk)
- Australia (AU prefix or 11-digit ABN) via Australian ABR (abr.business.gov.au)

{ "vat_number": "DE811128135" }

validate_uk_vat

UK-specific validation against HMRC live records. Returns HMRC consultation number for audit trail. Use when you need to prove compliance during a tax audit.
{ "vat_number": "GB123456789" }

get_vat_rates

Current VAT rates for all 27 EU member states, UK, and Australia. Use before generating any cross-border invoice or quote.
{ "country_code": "DE" }

batch_validate (Paid only)

Validate up to 10 VAT numbers in one call across any mix of EU, UK, and Australian numbers. Use for supplier onboarding batches and monthly vendor audits.
{ "vat_numbers": ["DE811128135", "GB123456789", "FR12345678901"] }

analyse_vat_risk (AI-powered — NOT a database lookup)

AI fraud risk assessment after validation. Returns CLEAR/REVIEW/BLOCK recommendation with specific fraud signals. Catches name mismatches between invoice and registry, newly registered companies with large invoice values, dormant status, shell company indicators, and address anomalies. Use before approving any payment or signing any contract with a first-time counterparty.
{
  "vat_number": "DE811128135",
  "validation_result": { "valid": true, "company_name": null, "country": "DE" },
  "invoice_amount": 50000,
  "invoice_company_name": "Deutsche Test GmbH"
}

compare_invoice_details (AI-powered — NOT a database lookup)

AI comparison of invoice details against official registry records. Flags discrepancies between the company name, address, and VAT number on an invoice versus registered government data. A name mismatch is one of the most common invoice fraud signals. Use before approving payment on any invoice from an unverified supplier.
{
  "invoice_company_name": "Deutsche Test GmbH",
  "invoice_vat_number": "DE811128135",
  "invoice_address": "Musterstrasse 1, Berlin",
  "validation_result": { "valid": true, "company_name": null, "country": "DE" }
}

Example Responses

validate_vat:

{
"valid": true,
"vat_number": "DE811128135",
"country": "DE",
"company_name": null,
"source": "VIES",
"source_url": "ec.europa.eu/taxation_customs/vies",
"checked_at": "2026-04-09T06:17:00Z"
}

analyse_vat_risk:

{
"recommendation": "REVIEW",
"risk_level": "MEDIUM",
"risk_score": 65,
"fraud_signals": ["Company name not available in registry despite valid VAT number", "Unable to verify invoice company name against registry data"],
"positive_indicators": ["VAT number validates as authentic in German registry"],
"recommended_action": "Request additional company documentation before processing payment.",
"summary": "Valid VAT number but missing registry information prevents full verification."
}

Recommended Workflows

Invoice processing (3 calls):
1. validate_vat — confirm VAT number is real and active
2. compare_invoice_details — AI checks invoice name/address against registry
3. analyse_vat_risk — AI fraud risk assessment with CLEAR/REVIEW/BLOCK
Only proceed with payment if recommendation is CLEAR.

Supplier onboarding (2 calls):
1. validate_vat — confirm registration
2. analyse_vat_risk — AI fraud signal check

Monthly vendor audit (1 call):
- batch_validate — re-validate all active suppliers. Registrations can lapse.

Data Sources

| Tool | Data Source | Update Frequency |
|---|---|---|
| validate_vat (EU) | EU VIES (ec.europa.eu/taxation_customs/vies) | Real-time |
| validate_vat (UK) | UK HMRC (api.service.hmrc.gov.uk) | Real-time |
| validate_vat (AU) | Australian ABR (abr.business.gov.au) | Real-time |
| analyse_vat_risk | Registry data + Claude AI analysis | Real-time |
| compare_invoice_details | Registry data + Claude AI analysis | Real-time |

Every response includes source_url and checked_at so agents can verify exactly where data came from and when.

Supported Jurisdictions

EU (27 member states): AT BE BG CY CZ DE DK EE EL ES FI FR HR HU IE IT LT LU LV MT NL PL PT RO SE SI SK

UK: GB prefix via HMRC

Australia: AU prefix or 11-digit ABN via ABR

Pricing

| Plan | Validations | Price |
|---|---|---|
| Free | 20/month | No API key required |
| Pro | 5,000/month | $39/month |
| Enterprise | Unlimited + batch | $199/month |

Upgrade at kordagencies.com

Reliability

- Uptime monitored every 5 minutes via UptimeRobot
- Version history documented in CHANGELOG.md
- Health endpoint: GET /health
- Note: EU VIES experiences periodic downtime — errors include explanation and retry guidance

Legal

Results sourced directly from official government VAT registries (EU VIES, UK HMRC, Australian ABR). We do not log or store your query content. Results are for informational purposes only and do not constitute legal or tax advice. Verify all results with a qualified tax advisor. Maximum liability limited to 3 months subscription fees. Full terms: kordagencies.com/terms.html

Connect

- Website: kordagencies.com
- Smithery: smithery.ai/server/OjasKord/vat-validator-mcp
- Contact: ojas@kordagencies.com

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.