Rechercher des tiers

Tool namesearch_tiers
Read-onlyIdempotent

Lists or searches customers, suppliers and contacts by reference, name, e-mail, address or phone.

Description

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

Liste ou recherche les tiers (clients, fournisseurs, contacts) de l'entreprise de l'utilisateur dans Oxygenius. La recherche porte sur la référence, la raison sociale, le nom, le prénom, les courriels, l'adresse et les téléphones. Tous les mots du terme doivent être trouvés ; la casse et les accents sont ignorés. Résultats triés par dénomination. Utiliser get_tiers pour le détail d'un tiers.

Required access

Parameters

NameTypePresenceDescription
querystringoptionalMots-clés : nom, société, référence, courriel, localité, téléphone… Laisser vide pour lister les tiers.
rolestringoptionalcustomer (clients, c.-à-d. non fournisseurs), supplier (fournisseurs) ou all (défaut).
kindstringoptionalcompany (sociétés), individual (personnes) ou all (défaut).
includeInactivebooleanoptionalInclure les tiers en sommeil (faux par défaut).
Default : false
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 tiers (à passer à get_tiers).
items[].referencestringnullableRéférence du tiers.
items[].namestringDénomination : société, sinon nom et prénom.
items[].kindstringcompany (société renseignée) ou individual (personne).
items[].isSupplierbooleanVrai pour un fournisseur.
items[].isActivebooleanFaux si le tiers est en sommeil.
items[].emailstringnullableCourriel principal.
items[].phonestringnullableTéléphone principal.
items[].citystringnullableCode postal et localité.

MCP annotations

AnnotationValueMeaning
titleRechercher des tiersHuman-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_tiers",
  "title": "Rechercher des tiers",
  "description": "Liste ou recherche les tiers (clients, fournisseurs, contacts) de l'entreprise de l'utilisateur dans Oxygenius. La recherche porte sur la référence, la raison sociale, le nom, le prénom, les courriels, l'adresse et les téléphones. Tous les mots du terme doivent être trouvés ; la casse et les accents sont ignorés. Résultats triés par dénomination. Utiliser get_tiers pour le détail d'un tiers.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "Mots-clés : nom, société, référence, courriel, localité, téléphone… Laisser vide pour lister les tiers.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "role": {
        "description": "customer (clients, c.-à-d. non fournisseurs), supplier (fournisseurs) ou all (défaut).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "kind": {
        "description": "company (sociétés), individual (personnes) ou all (défaut).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "includeInactive": {
        "description": "Inclure les tiers en sommeil (faux par défaut).",
        "type": "boolean",
        "default": false
      },
      "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 tiers (à passer à get_tiers).",
              "type": "integer"
            },
            "reference": {
              "description": "Référence du tiers.",
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "description": "Dénomination : société, sinon nom et prénom.",
              "type": "string"
            },
            "kind": {
              "description": "company (société renseignée) ou individual (personne).",
              "type": "string"
            },
            "isSupplier": {
              "description": "Vrai pour un fournisseur.",
              "type": "boolean"
            },
            "isActive": {
              "description": "Faux si le tiers est en sommeil.",
              "type": "boolean"
            },
            "email": {
              "description": "Courriel principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "phone": {
              "description": "Téléphone principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "city": {
              "description": "Code postal et localité.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "kind",
            "isSupplier",
            "isActive"
          ]
        }
      }
    },
    "required": [
      "totalCount",
      "offset",
      "limit",
      "hasMore",
      "items"
    ]
  },
  "annotations": {
    "title": "Rechercher des tiers",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}