Listes de l'agenda

Tool nameget_agenda_lists
Read-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

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

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

Parameters

NameTypePresenceDescription
kindstringrequiredplanning 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
NameTypePresenceDescription
typesobject[]Types d'événement de l'écran (typeId).
types[].idintegerIdentifiant à passer en typeId.
types[].namestringnullableNom affiché dans l'application (chantier, rendez-vous, congé…).
types[].isPrivatebooleanVrai pour le type « privé » : le contenu de l'événement reste caché aux autres utilisateurs.
types[].isDefaultbooleanVrai pour le type retenu quand typeId est omis.
siteStatesobject[]États de chantier (siteStateId), pour le planning ; vide pour le calendrier.
siteStates[].idintegerIdentifiant à passer en siteStateId.
siteStates[].namestringnullableNom affiché dans l'application (planifié, validé…).
siteStates[].typeIdintegernullableType d'événement (id de types) auquel l'état est réservé ; vide : état valable pour tous les types.
resourcesobject[]Personnes et matériel à qui affecter un événement (resourceIds).
resources[].idintegerIdentifiant à passer dans resourceIds.
resources[].namestringnullableNom de la personne ou du matériel.
resources[].groupstringnullableGroupe de ressources (ouvriers, bureau, matériel…).
resources[].isPersonbooleanVrai pour une personne, faux pour du matériel.
resources[].isCurrentUserbooleanVrai pour l'utilisateur connecté lui-même.

MCP annotations

AnnotationValueMeaning
titleListes de l'agendaHuman-readable name shown by the MCP client.
readOnlyHintyesThe 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.
openWorldHintnoThe 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
  }
}