io.github.OjasKord/vat-validator-mcp

Official2 tools

by OjasKord · JavaScript

VAT Validator MCP

Validate EU, UK, AU VAT numbers for AI agents. EU ViDA e-invoicing compliance.

Validates EU, UK, AU VAT numbers for e-invoicing compliance.

Topics

agentcompliancemcptaxvat

Captured live from the server via tools/list.

validate_vat

Validates a VAT number against live government registries. Call this BEFORE submitting any B2B payment via an agentic payment rail -- at the moment a VAT number appears on a supplier invoice and Stripe MPP, Alipay AI Pay, or Shopify UCP has not yet been called. Use this when a supplier invoice carries a VAT number and your agent must confirm it is registered to the correct entity before approving payment. Validates against EU VIES (ec.europa.eu), UK HMRC (api.service.hmrc.gov.uk), and AU ABR (abr.business.gov.au) live registries. Returns PROCEED / VERIFY_MANUALLY / HOLD verdict with fraud risk score 0-100 and name-match check. A settled B2B payment against an invalid or mismatched VAT number creates unrecoverable tax liability -- no agentic rail reverses a cleared cross-border transfer. Pass the country_code from this response to get_vat_rates. One call, machine-ready verdict, no further analysis needed.

Parameters (3)

vat_numberstringrequired
VAT number with country prefix. EU: DE123456789. UK: GB123456789. AU: ABN12345678901.
invoice_company_namestring
Company name as it appears on the invoice — if provided, cross-checks against registry and flags mismatches.
invoice_amountnumber
Invoice amount in local currency — used in fraud risk weighting.

get_vat_rates

Retrieves current VAT rates for a jurisdiction. Call this BEFORE calculating any invoice total or approving any VAT amount -- or immediately after validate_vat passing the country_code from that response. Use this when your agent needs to verify that the VAT rate on a supplier invoice matches the current official rate for that country before authorising payment. Returns current standard and reduced VAT rates for the jurisdiction. An agentic payment workflow that approves an invoice with an incorrect VAT rate creates a compounding compliance gap across every settled payment in that run -- VAT rates change without notice and cannot be sourced from training data. If the rate on the invoice differs from the rate returned here, do not approve payment.

Parameters (1)

country_codestring
ISO 2-letter code e.g. DE, FR, GB. Omit for all countries.

README.md3 KBView on GitHub

VAT Validator MCP

AI-powered VAT fraud detection and live VAT number validation for AI agents.

Validates EU, UK, and AU VAT numbers against authoritative live sources and uses AI pattern analysis to detect invoice fraud before payment is authorised. Built for compliance agents, invoice processing workflows, and supplier onboarding pipelines.

What This Solves

VAT fraud costs EU businesses €50bn annually. The most common attack vectors — missing trader fraud, carousel fraud, deregistered entity re-use — share one common signal: a VAT number that looks valid but isn't registered to the entity on the invoice.

Claude and other LLMs cannot reliably check live VAT registration status from training data. This tool calls the authoritative sources directly:

EU VIES — all 27 member states, real-time
UK HMRC VAT API v2 — OAuth2, authoritative
AU ABR — Australian Business Register

Tools

Tool	Free Tier	Use When
validate_vat	50/month	Before approving any EU, UK, or AU supplier invoice -- auto-detects jurisdiction, validates, and runs AI fraud analysis in one call
get_vat_rates	50/month	Before calculating cross-border invoice totals

Add to Your Agent

Claude Code — add to .mcp.json: { "mcpServers": { "vat-validator": { "type": "sse", "url": "https://vat-validator-mcp-production.up.railway.app/sse" } } }

LangChain: from langchain_mcp import MCPClient client = MCPClient( "https://vat-validator-mcp-production.up.railway.app/sse" )

OpenAI Agents SDK: from agents.mcp import MCPServerSse mcp_server = MCPServerSse( params={ "url": "https://vat-validator-mcp-production.up.railway.app/sse" } )

Pricing

Tier	Calls	Price
Free	50/month	No card required
Pay-as-you-go	Unlimited	$0.010/query, billed monthly
Bundle 500	500 calls, never expire	$8
Bundle 2000	2000 calls, never expire	$28

Upgrade: https://kordagencies.com

Search Terms

VAT number validation · EU VAT check · VIES lookup · HMRC VAT verification · VAT fraud detection · invoice VAT compliance · missing trader fraud · carousel fraud detection · cross-border invoice check · supplier VAT screening · VAT registration verification · EU invoice compliance · AU ABR lookup · UK VAT API · invoice fraud detection API · supplier VAT fraud risk · accounts payable compliance agent · VAT invoice audit · AI invoice compliance · MCP VAT validation

Install

Configuration

Environment variables

ANTHROPIC_API_KEYrequiredsecret

Anthropic API key for AI-powered fraud risk analysis

HMRC_CLIENT_IDsecret

HMRC Developer Hub client ID for UK VAT validation

HMRC_CLIENT_SECRETsecret

HMRC Developer Hub client secret for UK VAT validation

claude_desktop_config.json

{
  "mcpServers": {
    "vat-validator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vat-validator-mcp@2.0.30"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "HMRC_CLIENT_ID": "<YOUR_HMRC_CLIENT_ID>",
        "HMRC_CLIENT_SECRET": "<YOUR_HMRC_CLIENT_SECRET>"
      }
    }
  }
}