Listes de l'agenda
Nom de l'outil
get_agenda_listsLecture seuleIdempotent
Description
Renvoie, pour le planning ou le calendrier, les types d'événement, les états de chantier (planning) et les ressources (personnes et matériel) avec leur identifiant, à passer aux outils de création et de modification d'événements. isDefault marque le type retenu quand typeId est omis ; isCurrentUser désigne l'utilisateur connecté.
Accès requis
- Au moins une de ces permissions :
planning.list.viewoucalendar.list.viewoucalendar-hybrid.list.view - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
kind | string | obligatoire | planning ou calendar : écran dont on veut les listes. |
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 |
|---|---|---|---|
types | object[] | Types d'événement de l'écran (typeId). | |
types[].id | integer | Identifiant à passer en typeId. | |
types[].name | string | peut être null | Nom affiché dans l'application (chantier, rendez-vous, congé…). |
types[].isPrivate | boolean | Vrai pour le type « privé » : le contenu de l'événement reste caché aux autres utilisateurs. | |
types[].isDefault | boolean | Vrai pour le type retenu quand typeId est omis. | |
siteStates | object[] | États de chantier (siteStateId), pour le planning ; vide pour le calendrier. | |
siteStates[].id | integer | Identifiant à passer en siteStateId. | |
siteStates[].name | string | peut être null | Nom affiché dans l'application (planifié, validé…). |
siteStates[].typeId | integer | peut être null | Type d'événement (id de types) auquel l'état est réservé ; vide : état valable pour tous les types. |
resources | object[] | Personnes et matériel à qui affecter un événement (resourceIds). | |
resources[].id | integer | Identifiant à passer dans resourceIds. | |
resources[].name | string | peut être null | Nom de la personne ou du matériel. |
resources[].group | string | peut être null | Groupe de ressources (ouvriers, bureau, matériel…). |
resources[].isPerson | boolean | Vrai pour une personne, faux pour du matériel. | |
resources[].isCurrentUser | boolean | Vrai pour l'utilisateur connecté lui-même. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Listes de l'agenda | 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_agenda_lists",
"title": "Listes de l'agenda",
"description": "Renvoie, pour le planning ou le calendrier, les types d'événement, les états de chantier (planning) et les ressources (personnes et matériel) avec leur identifiant, à passer aux outils de création et de modification d'événements. isDefault marque le type retenu quand typeId est omis ; isCurrentUser désigne l'utilisateur connecté.",
"inputSchema": {
"type": "object",
"properties": {
"kind": {
"description": "planning ou calendar : écran dont on veut les listes.",
"type": "string"
}
},
"required": [
"kind"
]
},
"outputSchema": {
"type": "object",
"properties": {
"types": {
"description": "Types d'événement de l'écran (typeId).",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant à passer en typeId.",
"type": "integer"
},
"name": {
"description": "Nom affiché dans l'application (chantier, rendez-vous, congé…).",
"type": [
"string",
"null"
]
},
"isPrivate": {
"description": "Vrai pour le type « privé » : le contenu de l'événement reste caché aux autres utilisateurs.",
"type": "boolean"
},
"isDefault": {
"description": "Vrai pour le type retenu quand typeId est omis.",
"type": "boolean"
}
},
"required": [
"id"
]
}
},
"siteStates": {
"description": "États de chantier (siteStateId), pour le planning ; vide pour le calendrier.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant à passer en siteStateId.",
"type": "integer"
},
"name": {
"description": "Nom affiché dans l'application (planifié, validé…).",
"type": [
"string",
"null"
]
},
"typeId": {
"description": "Type d'événement (id de types) auquel l'état est réservé ; vide : état valable pour tous les types.",
"type": [
"integer",
"null"
]
}
},
"required": [
"id"
]
}
},
"resources": {
"description": "Personnes et matériel à qui affecter un événement (resourceIds).",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant à passer dans resourceIds.",
"type": "integer"
},
"name": {
"description": "Nom de la personne ou du matériel.",
"type": [
"string",
"null"
]
},
"group": {
"description": "Groupe de ressources (ouvriers, bureau, matériel…).",
"type": [
"string",
"null"
]
},
"isPerson": {
"description": "Vrai pour une personne, faux pour du matériel.",
"type": "boolean"
},
"isCurrentUser": {
"description": "Vrai pour l'utilisateur connecté lui-même.",
"type": "boolean"
}
},
"required": [
"id"
]
}
}
},
"required": [
"types",
"siteStates",
"resources"
]
},
"annotations": {
"title": "Listes de l'agenda",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}