Listes de référence
Nom de l'outil
get_reference_listsLecture seuleIdempotent
Description
Renvoie les valeurs actives des listes de choix des formulaires de tiers et de dossier, avec leur identifiant : régimes de TVA et conditions de paiement (create_tiers, update_tiers, et délai de paiement d'update_invoice), rôles d'un tiers lié à un dossier, types de chantier et procédures (create_dossier, update_dossier). isDefault marque la valeur retenue quand le paramètre est omis.
Accès requis
- Au moins une de ces permissions :
tiers.new-tiers.createoutiers.tiers.editoudossier.new-dossier.createoudossier-detail.dossier.editouinvoice.list.view - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
Cet outil ne prend aucun paramètre.
Résultat
Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.
Champs du résultat
| Nom | Type | Présence | Description |
|---|---|---|---|
vatRegimes | object[] | Régimes de TVA d'un tiers (vatRegimeId de create_tiers et update_tiers). | |
vatRegimes[].id | integer | Identifiant à passer à l'outil d'écriture. | |
vatRegimes[].name | string | peut être null | Nom affiché dans l'application. |
vatRegimes[].description | string | peut être null | Description, si elle est renseignée. |
vatRegimes[].isDefault | boolean | Vrai pour la valeur retenue quand le paramètre correspondant est omis. | |
paymentTerms | object[] | Conditions de paiement d'un tiers (paymentTermId). | |
tiersRoles | object[] | Rôles d'un tiers lié à un dossier (contact, architecte…), hors client et provenance qui ont leurs propres paramètres. | |
siteTypes | object[] | Types de chantier d'un dossier (siteTypeId). | |
procedures | object[] | Procédures qui fixent les étapes d'un nouveau dossier (procedureId). |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Listes de référence | Nom lisible affiché par le client MCP. |
readOnlyHint | oui | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | oui | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur. |
Définition JSON
Entrée exacte de tools/list
{
"name": "get_reference_lists",
"title": "Listes de référence",
"description": "Renvoie les valeurs actives des listes de choix des formulaires de tiers et de dossier, avec leur identifiant : régimes de TVA et conditions de paiement (create_tiers, update_tiers, et délai de paiement d'update_invoice), rôles d'un tiers lié à un dossier, types de chantier et procédures (create_dossier, update_dossier). isDefault marque la valeur retenue quand le paramètre est omis.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {
"vatRegimes": {
"description": "Régimes de TVA d'un tiers (vatRegimeId de create_tiers et update_tiers).",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant à passer à l'outil d'écriture.",
"type": "integer"
},
"name": {
"description": "Nom affiché dans l'application.",
"type": [
"string",
"null"
]
},
"description": {
"description": "Description, si elle est renseignée.",
"type": [
"string",
"null"
]
},
"isDefault": {
"description": "Vrai pour la valeur retenue quand le paramètre correspondant est omis.",
"type": "boolean"
}
},
"required": [
"id"
]
}
},
"paymentTerms": {
"description": "Conditions de paiement d'un tiers (paymentTermId).",
"type": "array",
"items": {
"$ref": "#/properties/vatRegimes/items"
}
},
"tiersRoles": {
"description": "Rôles d'un tiers lié à un dossier (contact, architecte…), hors client et provenance qui ont leurs propres paramètres.",
"type": "array",
"items": {
"$ref": "#/properties/vatRegimes/items"
}
},
"siteTypes": {
"description": "Types de chantier d'un dossier (siteTypeId).",
"type": "array",
"items": {
"$ref": "#/properties/vatRegimes/items"
}
},
"procedures": {
"description": "Procédures qui fixent les étapes d'un nouveau dossier (procedureId).",
"type": "array",
"items": {
"$ref": "#/properties/vatRegimes/items"
}
}
},
"required": [
"vatRegimes",
"paymentTerms",
"tiersRoles",
"siteTypes",
"procedures"
]
},
"annotations": {
"title": "Listes de référence",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}