check_vat
Pack: vies-eu · Endpoint: https://gateway.pipeworx.io/vies-eu/mcp
Validate an EU VAT number against VIES. Returns whether the number is a valid/registered EU VAT registration, plus the registered name and address when the member state publishes them (many states return ”---” or empty even for valid numbers). A false result means not registered/invalid. If the national service is temporarily down, userError is MS_UNAVAILABLE/MS_MAX_CONCURRENT_REQ etc. — treat that as “could not check”, not “invalid”.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
countryCode | string | yes | 2-letter EU member-state code = the VAT prefix, e.g. “DE”, “FR”, “IT”. Greece is “EL” (not “GR”). |
vatNumber | string | yes | The VAT number WITHOUT the country prefix, e.g. “811569869”. If you include the prefix (e.g. “DE811569869”) it is stripped automatically. |
Example call
curl -X POST https://gateway.pipeworx.io/vies-eu/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_vat","arguments":{}}}'Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"vies-eu": {
"url": "https://gateway.pipeworx.io/vies-eu/mcp"
}
}
}See Getting Started for client-specific install steps.