Vérifier un numéro de TVA

Tool namecheck_vat
WriteIdempotentOpen world

Checks a European VAT number with the European Commission's VIES service and returns the registered name and address, and the third parties that already use it.

Description

Exact text sent to the model by tools/list (French, the language of the data):

Vérifie un numéro de TVA européen auprès de VIES (service de la Commission européenne), comme le formulaire de tiers de l'application : renvoie le nom et l'adresse enregistrés pour ce numéro, et les tiers d'Oxygenius qui l'ont déjà. L'application note la date de vérification sur ces tiers. Un numéro invalide est renvoyé comme une erreur.

Required access

Parameters

NameTypePresenceDescription
vatNumberstringrequiredNuméro de TVA précédé du code pays, ex. BE0123456789 (espaces et points acceptés).

Result

The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.

Result fields
NameTypePresenceDescription
validbooleanVrai si VIES reconnaît le numéro (un numéro invalide est une erreur).
vatNumberstringNuméro vérifié, précédé du code pays.
namestringnullableNom enregistré pour ce numéro, tel que le donne VIES.
addressstringnullableAdresse enregistrée pour ce numéro, telle que la donne VIES (une seule chaîne).
checkedOnstring (date)nullableDate de la vérification (AAAA-MM-JJ).
existingTiersobject[]Tiers déjà enregistrés avec ce numéro de TVA : vérifier s'il ne s'agit pas du tiers recherché avant d'en créer un.
existingTiers[].idintegerIdentifiant technique du tiers (à passer à get_tiers).
existingTiers[].referencestringnullableRéférence du tiers.
existingTiers[].namestringDénomination : société, sinon nom et prénom.
existingTiers[].kindstringcompany (société renseignée) ou individual (personne).
existingTiers[].isSupplierbooleanVrai pour un fournisseur.
existingTiers[].isActivebooleanFaux si le tiers est en sommeil.
existingTiers[].emailstringnullableCourriel principal.
existingTiers[].phonestringnullableTéléphone principal.
existingTiers[].citystringnullableCode postal et localité.

MCP annotations

AnnotationValueMeaning
titleVérifier un numéro de TVAHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintyesCalling it again with the same arguments has no further effect.
openWorldHintyesThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "name": "check_vat",
  "title": "Vérifier un numéro de TVA",
  "description": "Vérifie un numéro de TVA européen auprès de VIES (service de la Commission européenne), comme le formulaire de tiers de l'application : renvoie le nom et l'adresse enregistrés pour ce numéro, et les tiers d'Oxygenius qui l'ont déjà. L'application note la date de vérification sur ces tiers. Un numéro invalide est renvoyé comme une erreur.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "vatNumber": {
        "description": "Numéro de TVA précédé du code pays, ex. BE0123456789 (espaces et points acceptés).",
        "type": "string"
      }
    },
    "required": [
      "vatNumber"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "valid": {
        "description": "Vrai si VIES reconnaît le numéro (un numéro invalide est une erreur).",
        "type": "boolean"
      },
      "vatNumber": {
        "description": "Numéro vérifié, précédé du code pays.",
        "type": "string"
      },
      "name": {
        "description": "Nom enregistré pour ce numéro, tel que le donne VIES.",
        "type": [
          "string",
          "null"
        ]
      },
      "address": {
        "description": "Adresse enregistrée pour ce numéro, telle que la donne VIES (une seule chaîne).",
        "type": [
          "string",
          "null"
        ]
      },
      "checkedOn": {
        "description": "Date de la vérification (AAAA-MM-JJ).",
        "type": [
          "string",
          "null"
        ],
        "format": "date"
      },
      "existingTiers": {
        "description": "Tiers déjà enregistrés avec ce numéro de TVA : vérifier s'il ne s'agit pas du tiers recherché avant d'en créer un.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant technique du tiers (à passer à get_tiers).",
              "type": "integer"
            },
            "reference": {
              "description": "Référence du tiers.",
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "description": "Dénomination : société, sinon nom et prénom.",
              "type": "string"
            },
            "kind": {
              "description": "company (société renseignée) ou individual (personne).",
              "type": "string"
            },
            "isSupplier": {
              "description": "Vrai pour un fournisseur.",
              "type": "boolean"
            },
            "isActive": {
              "description": "Faux si le tiers est en sommeil.",
              "type": "boolean"
            },
            "email": {
              "description": "Courriel principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "phone": {
              "description": "Téléphone principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "city": {
              "description": "Code postal et localité.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "kind",
            "isSupplier",
            "isActive"
          ]
        }
      }
    },
    "required": [
      "valid",
      "vatNumber"
    ]
  },
  "annotations": {
    "title": "Vérifier un numéro de TVA",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": false
  }
}