Koskamo

Zovo VAT Number Check MCP

This MCP server allows agents to validate EU VAT numbers against live VIES records and published structural tables. It returns consultation status, names, and addresses where available, and supports downloading dated XLSX or CSV validation logs for up to 100 VAT numbers per request.

Visit Zovo

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Zovo VAT Number Check MCP logo, by ZovoCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by Zovo
MCP endpoint (Streamable HTTP)
https://vat-check.zovo.one/mcp
Vendor documentation

What you can do with it

  • Check EU customer VAT numbers against VIES
  • Download dated validation logs in XLSX format
  • Verify VAT number structure and status

Source and maintenance

Community listingRegistry 1.0.0
mcp-registry: io.github.theluckystrike/vat-check@1.0.0Project website

Protocol and capabilities

Server
vat-check 1.0.0
MCP protocol
2025-06-18
Tools
2 advertised
Resources
1 advertised
Resource templates
1 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Show per-status counts, warnings, source and consultation time, and both download links. Unavailable is not invalid. Do not decide whether reverse charge applies.

Tools

2 advertised

check_vat_numbers — Check EU VAT numbers
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Use this when the user asks for a vat number check, vies vat validation, or eu vat number lookup with dated XLSX and CSV logs. Checks 1 to 100 EU or XI VAT numbers against published structures and live VIES; no national checksum test. Do not use for deciding whether reverse charge applies.

check_vat_numbers input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "numbers"
  ],
  "properties": {
    "numbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The VAT numbers with country prefixes, 1 to 100 items of 4 to 40 characters; for example [\"IE6388047V\", \"fr 40 303265045\"]."
    },
    "requester_vat": {
      "type": "string",
      "description": "Your own EU business VAT number with country prefix for consultation numbers; for example IE6388047V. Leave out to check without requester details."
    },
    "default_country": {
      "enum": [
        "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",
        "XI"
      ],
      "type": "string",
      "description": "Country code for a number without a prefix; for example IE. Use EL for Greece."
    }
  }
}
check_vat_numbers output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "summary",
    "rows",
    "availability",
    "retrievedUtc",
    "downloads",
    "warnings"
  ],
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "row",
          "vat",
          "status",
          "reason"
        ],
        "properties": {
          "row": {
            "type": "number"
          },
          "vat": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "summary": {
      "type": "object",
      "required": [
        "numbers",
        "valid",
        "invalid",
        "unavailable",
        "error"
      ],
      "properties": {
        "error": {
          "type": "number"
        },
        "valid": {
          "type": "number"
        },
        "invalid": {
          "type": "number"
        },
        "numbers": {
          "type": "number"
        },
        "unavailable": {
          "type": "number"
        }
      },
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "downloads": {
      "type": "object",
      "required": [
        "xlsx",
        "csv"
      ],
      "properties": {
        "csv": {
          "type": "string"
        },
        "xlsx": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "availability": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "country",
          "availability"
        ],
        "properties": {
          "country": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "retrievedUtc": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
check_vat_numbers annotations
{
  "title": "Check EU VAT numbers",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
check_vies_availability — Check VAT service availability
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Use this when the user asks for a vies check, vat number validation, or bulk vat number check after unavailable answers and needs member-state service status. Reads VIES status for 28 country services, cached for 120 seconds. Do not use for validating an individual VAT number.

check_vies_availability input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
check_vies_availability output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "available",
    "countries",
    "retrievedUtc",
    "source"
  ],
  "properties": {
    "source": {
      "type": "string"
    },
    "available": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "country",
          "availability"
        ],
        "properties": {
          "country": {
            "type": "string"
          },
          "availability": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "retrievedUtc": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
check_vies_availability annotations
{
  "title": "Check VAT service availability",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

vat-check-widget — Zovo VAT Number Check view

Advertised by the server during the last successful anonymous check.

Interactive view for Zovo VAT Number Check.

vat-check-widget URI
ui://widget/vat-check-v3-1.0.0-67d00e841d4f23566ac7ba98c153e5515e674827ea3c52c9483a60bf0402fd91.html

MIME type: text/html;profile=mcp-app

vat-check-widget-legacy — Zovo VAT Number Check view (previous versions)

Advertised by the server during the last successful anonymous check.

vat-check-widget-legacy URI template
ui://widget/vat-check-{version}.html

MIME type: text/html;profile=mcp-app

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
765 ms
95th percentile latency
765 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 765 ms · metadata changed · 2 tool(s), 1 resource(s), 1 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http zovo-vat-number-check-mcp https://vat-check.zovo.one/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add zovo-vat-number-check-mcp --url https://vat-check.zovo.one/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable zovo-vat-number-check-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "zovo-vat-number-check-mcp": {
      "url": "https://vat-check.zovo.one/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "zovo-vat-number-check-mcp": {
      "type": "streamableHttp",
      "url": "https://vat-check.zovo.one/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start zovo-vat-number-check-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "zovo-vat-number-check-mcp": {
      "type": "http",
      "url": "https://vat-check.zovo.one/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http zovo-vat-number-check-mcp https://vat-check.zovo.one/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "zovo-vat-number-check-mcp": {
      "url": "https://vat-check.zovo.one/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "zovo-vat-number-check-mcp": {
      "serverUrl": "https://vat-check.zovo.one/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Zovo VAT Number Check MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 499