Planifier un événement

Tool namecreate_planning_event
Write

Creates a planning entry on one day or consecutive days, at the same times, for people or equipment. No confirmation is sent to the customer.

Description

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

Crée dans le planning Oxygenius un événement (chantier, visite…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, affecté à des personnes ou à du matériel (get_agenda_lists avec kind planning donne les types, états de chantier et ressources). Lié à un dossier, il a lieu par défaut à l'adresse de son chantier. Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.

Required access

Parameters

NameTypePresenceDescription
subjectstringrequiredObjet de l'événement (ex. Pose des châssis).
datestring (date)requiredPremier jour (AAAA-MM-JJ).
startTimestringrequiredHeure de début, heure locale belge (HH:mm, ex. 07:30).
endTimestringrequiredHeure de fin, le même jour (HH:mm).
resourceIdsinteger[]requiredRessources affectées (champ id de resources dans get_agenda_lists), 20 au plus.
endDatestring (date)optionalDernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus).
typeIdintegeroptionalType d'événement (id de types) ; par défaut, le type marqué isDefault.
siteStateIdintegeroptionalÉtat de chantier (id de siteStates) ; par défaut, le premier état valable pour le type.
dossierIdintegeroptionalDossier lié (champ id de search_dossiers).
estimateIdsinteger[]optionalDevis du dossier à lier (champ id de search_estimates), 10 au plus.
locationstringoptionalLieu ; par défaut, l'adresse du chantier du dossier lié.
descriptionstringoptionalDescription, en texte simple.

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
descriptionstringnullableDescription de l'événement (masquée pour un événement privé d'autrui).
dossierSiteAddressstringnullableAdresse du chantier du dossier lié.
dossierClientstringnullableClient (tiers propriétaire) du dossier lié.
estimatesobject[]Devis liés à l'événement (vide sans accès aux devis).
estimates[].estimateIdintegerIdentifiant du devis (à passer à get_estimate).
estimates[].referencestringnullableRéférence du devis.
idintegerIdentifiant de l'événement (à passer à get_planning_event ou get_calendar_event).
kindstringplanning ou calendar : écran d'origine de l'événement.
subjectstringnullableObjet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.
startstring (date-time)Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).
endstring (date-time)Fin, en heure locale belge avec son décalage UTC.
typestringnullableType d'événement (chantier, rendez-vous, congé, intervention…).
siteStatestringnullableÉtat de chantier (planifié, validé…), pour le planning.
locationstringnullableLieu saisi sur l'événement (masqué pour un événement privé d'autrui).
isPrivatebooleanVrai pour un événement privé.
dossierIdintegernullableIdentifiant du dossier lié (à passer à get_dossier).
dossierReferencestringnullableRéférence du dossier lié.
dossierIndicationstringnullableIntitulé court du dossier lié.
assigneesstring[]Personnes affectées à cette occurrence.

MCP annotations

AnnotationValueMeaning
titlePlanifier un événementHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling 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": "create_planning_event",
  "title": "Planifier un événement",
  "description": "Crée dans le planning Oxygenius un événement (chantier, visite…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, affecté à des personnes ou à du matériel (get_agenda_lists avec kind planning donne les types, états de chantier et ressources). Lié à un dossier, il a lieu par défaut à l'adresse de son chantier. Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "subject": {
        "description": "Objet de l'événement (ex. Pose des châssis).",
        "type": "string"
      },
      "date": {
        "description": "Premier jour (AAAA-MM-JJ).",
        "type": "string",
        "format": "date"
      },
      "startTime": {
        "description": "Heure de début, heure locale belge (HH:mm, ex. 07:30).",
        "type": "string"
      },
      "endTime": {
        "description": "Heure de fin, le même jour (HH:mm).",
        "type": "string"
      },
      "resourceIds": {
        "description": "Ressources affectées (champ id de resources dans get_agenda_lists), 20 au plus.",
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "endDate": {
        "description": "Dernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus).",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      },
      "typeId": {
        "description": "Type d'événement (id de types) ; par défaut, le type marqué isDefault.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "siteStateId": {
        "description": "État de chantier (id de siteStates) ; par défaut, le premier état valable pour le type.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "dossierId": {
        "description": "Dossier lié (champ id de search_dossiers).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "estimateIds": {
        "description": "Devis du dossier à lier (champ id de search_estimates), 10 au plus.",
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": "integer"
        },
        "default": null
      },
      "location": {
        "description": "Lieu ; par défaut, l'adresse du chantier du dossier lié.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "description": {
        "description": "Description, en texte simple.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      }
    },
    "required": [
      "subject",
      "date",
      "startTime",
      "endTime",
      "resourceIds"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "description": {
        "description": "Description de l'événement (masquée pour un événement privé d'autrui).",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierSiteAddress": {
        "description": "Adresse du chantier du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierClient": {
        "description": "Client (tiers propriétaire) du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "estimates": {
        "description": "Devis liés à l'événement (vide sans accès aux devis).",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "estimateId": {
              "description": "Identifiant du devis (à passer à get_estimate).",
              "type": "integer"
            },
            "reference": {
              "description": "Référence du devis.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "estimateId"
          ]
        }
      },
      "id": {
        "description": "Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event).",
        "type": "integer"
      },
      "kind": {
        "description": "planning ou calendar : écran d'origine de l'événement.",
        "type": "string"
      },
      "subject": {
        "description": "Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.",
        "type": [
          "string",
          "null"
        ]
      },
      "start": {
        "description": "Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).",
        "type": "string",
        "format": "date-time"
      },
      "end": {
        "description": "Fin, en heure locale belge avec son décalage UTC.",
        "type": "string",
        "format": "date-time"
      },
      "type": {
        "description": "Type d'événement (chantier, rendez-vous, congé, intervention…).",
        "type": [
          "string",
          "null"
        ]
      },
      "siteState": {
        "description": "État de chantier (planifié, validé…), pour le planning.",
        "type": [
          "string",
          "null"
        ]
      },
      "location": {
        "description": "Lieu saisi sur l'événement (masqué pour un événement privé d'autrui).",
        "type": [
          "string",
          "null"
        ]
      },
      "isPrivate": {
        "description": "Vrai pour un événement privé.",
        "type": "boolean"
      },
      "dossierId": {
        "description": "Identifiant du dossier lié (à passer à get_dossier).",
        "type": [
          "integer",
          "null"
        ]
      },
      "dossierReference": {
        "description": "Référence du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierIndication": {
        "description": "Intitulé court du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "assignees": {
        "description": "Personnes affectées à cette occurrence.",
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "id",
      "kind",
      "start",
      "end",
      "isPrivate"
    ]
  },
  "annotations": {
    "title": "Planifier un événement",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}