Listes de l'agenda
Tool name
get_agenda_listsRead-onlyIdempotent
Returns the event types, site states and resources (people and equipment) of the planning or the calendar, with the identifiers the write tools expect.
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é.
Required access
- At least one of these permissions:
planning.list.vieworcalendar.list.vieworcalendar-hybrid.list.view - Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
kind | string | required | planning ou calendar : écran dont on veut les listes. |
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
| Name | Type | Presence | Description |
|---|---|---|---|
types | object[] | Types d'événement de l'écran (typeId). | |
types[].id | integer | Identifiant à passer en typeId. | |
types[].name | string | nullable | 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 | nullable | Nom affiché dans l'application (planifié, validé…). |
siteStates[].typeId | integer | nullable | 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 | nullable | Nom de la personne ou du matériel. |
resources[].group | string | nullable | 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. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Listes de l'agenda | Human-readable name shown by the MCP client. |
readOnlyHint | yes | The tool changes nothing. |
destructiveHint | no | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | yes | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"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
}
}