VAT number validation for AI agents. EU VIES, UK HMRC, Australian ABN
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add vat-validator --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env HMRC_CLIENT_ID='<HMRC_CLIENT_ID>' --env HMRC_CLIENT_SECRET='<HMRC_CLIENT_SECRET>' -- npx -y vat-validator-mcp~/.codex/config.toml
[mcp_servers.vat-validator]
command = "npx"
args = ["-y", "vat-validator-mcp"]
env = { ANTHROPIC_API_KEY = "<ANTHROPIC_API_KEY>", HMRC_CLIENT_ID = "<HMRC_CLIENT_ID>", HMRC_CLIENT_SECRET = "<HMRC_CLIENT_SECRET>" }
# codex mcp add vat-validator --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env HMRC_CLIENT_ID='<HMRC_CLIENT_ID>' --env HMRC_CLIENT_SECRET='<HMRC_CLIENT_SECRET>' -- npx -y vat-validator-mcp~/.cursor/mcp.json
{
"mcpServers": {
"vat-validator": {
"command": "npx",
"args": [
"-y",
"vat-validator-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"HMRC_CLIENT_ID": "<HMRC_CLIENT_ID>",
"HMRC_CLIENT_SECRET": "<HMRC_CLIENT_SECRET>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"vat-validator": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vat-validator-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"HMRC_CLIENT_ID": "<HMRC_CLIENT_ID>",
"HMRC_CLIENT_SECRET": "<HMRC_CLIENT_SECRET>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"vat-validator": {
"command": "npx",
"args": [
"-y",
"vat-validator-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"HMRC_CLIENT_ID": "<HMRC_CLIENT_ID>",
"HMRC_CLIENT_SECRET": "<HMRC_CLIENT_SECRET>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"vat-validator": {
"command": "npx",
"args": [
"-y",
"vat-validator-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"HMRC_CLIENT_ID": "<HMRC_CLIENT_ID>",
"HMRC_CLIENT_SECRET": "<HMRC_CLIENT_SECRET>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"vat-validator": {
"command": "npx",
"args": [
"-y",
"vat-validator-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"HMRC_CLIENT_ID": "<HMRC_CLIENT_ID>",
"HMRC_CLIENT_SECRET": "<HMRC_CLIENT_SECRET>"
}
}
}
}Remote
claude mcp add --transport http vat-validator https://vat-validator-mcp-production.up.railway.app~/.codex/config.toml
[mcp_servers.vat-validator]
url = "https://vat-validator-mcp-production.up.railway.app"
# codex mcp add vat-validator --url https://vat-validator-mcp-production.up.railway.app~/.cursor/mcp.json
{
"mcpServers": {
"vat-validator": {
"url": "https://vat-validator-mcp-production.up.railway.app"
}
}
}.vscode/mcp.json
{
"servers": {
"vat-validator": {
"type": "http",
"url": "https://vat-validator-mcp-production.up.railway.app"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"vat-validator": {
"httpUrl": "https://vat-validator-mcp-production.up.railway.app"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"vat-validator": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://vat-validator-mcp-production.up.railway.app"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"vat-validator": {
"url": "https://vat-validator-mcp-production.up.railway.app"
}
}
}Environment variables
ANTHROPIC_API_KEYHMRC_CLIENT_IDHMRC_CLIENT_SECRET
Replace the placeholders with your own credentials and keep them out of version control.