Rechercher des dossiers

Tool namesearch_dossiers
Read-onlyIdempotent

Lists or searches the company's projects by reference, title, external references, site address and the name, address or phone of linked third parties, newest first.

Description

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

Liste ou recherche les dossiers (chantiers) de l'entreprise de l'utilisateur dans Oxygenius. La recherche porte sur la référence et l'intitulé du dossier, ses références externes, l'adresse du chantier, ainsi que le nom, la référence, l'adresse et le téléphone des tiers liés. Tous les mots du terme doivent être trouvés ; la casse et les accents sont ignorés. Les résultats sont triés du dossier le plus récent au plus ancien. Seuls les dossiers que l'utilisateur peut voir dans Oxygenius sont renvoyés. Utiliser get_dossier pour le détail d'un dossier.

Required access

Parameters

NameTypePresenceDescription
querystringoptionalMots-clés : référence de dossier, nom ou référence du client, rue, localité, code postal, téléphone… Laisser vide pour lister les dossiers les plus récents.
statusstringoptionalFiltre facultatif sur le libellé du statut du dossier (correspondance partielle).
limitintegeroptionalNombre de résultats souhaités (10 par défaut, plafonné par le serveur).
Default : 10
offsetintegeroptionalNombre de résultats à sauter pour la pagination (0 par défaut).
Default : 0

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
totalCountintegerNombre total d'éléments correspondant aux critères.
offsetintegerPosition du premier élément de la page.
limitintegerTaille de page appliquée (le serveur plafonne la valeur demandée).
hasMorebooleanVrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.
itemsobject[]Éléments de la page.
items[].idintegerIdentifiant technique du dossier.
items[].referencestringnullableRéférence du dossier, telle qu'affichée dans Oxygenius.
items[].indicationstringnullableIntitulé court du dossier (indication).
items[].statusstringnullableLibellé du statut du dossier.
items[].siteTypestringnullableType de chantier.
items[].isActivebooleanFaux si le dossier est désactivé.
items[].clientobjectnullableClient (tiers propriétaire) du dossier.
items[].client.idintegerIdentifiant technique du tiers.
items[].client.referencestringnullableRéférence du tiers.
items[].client.namestringDénomination : société, sinon prénom et nom.
items[].siteAddressstringnullableAdresse du chantier.
items[].externalReference1stringnullableRéférence externe 1 (référence client).
items[].externalReference2stringnullableRéférence externe 2.
items[].managerstringnullableNom du gestionnaire du dossier.
items[].creationDatestring (date)nullableDate de création du dossier (AAAA-MM-JJ).

MCP annotations

AnnotationValueMeaning
titleRechercher des dossiersHuman-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": "search_dossiers",
  "title": "Rechercher des dossiers",
  "description": "Liste ou recherche les dossiers (chantiers) de l'entreprise de l'utilisateur dans Oxygenius. La recherche porte sur la référence et l'intitulé du dossier, ses références externes, l'adresse du chantier, ainsi que le nom, la référence, l'adresse et le téléphone des tiers liés. Tous les mots du terme doivent être trouvés ; la casse et les accents sont ignorés. Les résultats sont triés du dossier le plus récent au plus ancien. Seuls les dossiers que l'utilisateur peut voir dans Oxygenius sont renvoyés. Utiliser get_dossier pour le détail d'un dossier.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "Mots-clés : référence de dossier, nom ou référence du client, rue, localité, code postal, téléphone… Laisser vide pour lister les dossiers les plus récents.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "status": {
        "description": "Filtre facultatif sur le libellé du statut du dossier (correspondance partielle).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "limit": {
        "description": "Nombre de résultats souhaités (10 par défaut, plafonné par le serveur).",
        "type": "integer",
        "default": 10
      },
      "offset": {
        "description": "Nombre de résultats à sauter pour la pagination (0 par défaut).",
        "type": "integer",
        "default": 0
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "totalCount": {
        "description": "Nombre total d'éléments correspondant aux critères.",
        "type": "integer"
      },
      "offset": {
        "description": "Position du premier élément de la page.",
        "type": "integer"
      },
      "limit": {
        "description": "Taille de page appliquée (le serveur plafonne la valeur demandée).",
        "type": "integer"
      },
      "hasMore": {
        "description": "Vrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.",
        "type": "boolean"
      },
      "items": {
        "description": "Éléments de la page.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant technique du dossier.",
              "type": "integer"
            },
            "reference": {
              "description": "Référence du dossier, telle qu'affichée dans Oxygenius.",
              "type": [
                "string",
                "null"
              ]
            },
            "indication": {
              "description": "Intitulé court du dossier (indication).",
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "description": "Libellé du statut du dossier.",
              "type": [
                "string",
                "null"
              ]
            },
            "siteType": {
              "description": "Type de chantier.",
              "type": [
                "string",
                "null"
              ]
            },
            "isActive": {
              "description": "Faux si le dossier est désactivé.",
              "type": "boolean"
            },
            "client": {
              "description": "Client (tiers propriétaire) du dossier.",
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "id": {
                  "description": "Identifiant technique du tiers.",
                  "type": "integer"
                },
                "reference": {
                  "description": "Référence du tiers.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "name": {
                  "description": "Dénomination : société, sinon prénom et nom.",
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name"
              ]
            },
            "siteAddress": {
              "description": "Adresse du chantier.",
              "type": [
                "string",
                "null"
              ]
            },
            "externalReference1": {
              "description": "Référence externe 1 (référence client).",
              "type": [
                "string",
                "null"
              ]
            },
            "externalReference2": {
              "description": "Référence externe 2.",
              "type": [
                "string",
                "null"
              ]
            },
            "manager": {
              "description": "Nom du gestionnaire du dossier.",
              "type": [
                "string",
                "null"
              ]
            },
            "creationDate": {
              "description": "Date de création du dossier (AAAA-MM-JJ).",
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            }
          },
          "required": [
            "id",
            "isActive"
          ]
        }
      }
    },
    "required": [
      "totalCount",
      "offset",
      "limit",
      "hasMore",
      "items"
    ]
  },
  "annotations": {
    "title": "Rechercher des dossiers",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}