Rechercher des articles
Nom de l'outil
search_itemsLecture seuleIdempotent
Description
Liste ou recherche les articles Oxygenius (fournitures) et les ouvrages (composés d'articles), par ordre alphabétique, avec leur prix de vente et, si le module Stock est actif, la quantité en stock. Utiliser get_item pour le détail et get_item_stock pour le stock par emplacement.
Accès requis
- Permission :
item-job.list.view - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
query | string | facultatif | Mots-clés : désignation, références interne et externe, code-barres, description, marque. |
kind | string | facultatif | all (défaut), article (fournitures) ou job (ouvrages). |
category | string | facultatif | Fragment du nom de la catégorie ou de la famille d'articles. |
availability | string | facultatif | Module Stock : all (défaut), in-stock (en stock), out-of-stock (rupture) ou below-minimum (sous le stock minimum). |
includeInactive | boolean | facultatif | Inclure les articles désactivés (faux par défaut). |
limit | integer | facultatif | Nombre de résultats souhaités (10 par défaut, plafonné par le serveur). |
offset | integer | facultatif | Nombre de résultats à sauter pour la pagination (0 par défaut). |
Résultat
Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.
Champs du résultat
| Nom | Type | Présence | Description |
|---|---|---|---|
totalCount | integer | Nombre total d'éléments correspondant aux critères. | |
offset | integer | Position du premier élément de la page. | |
limit | integer | Taille de page appliquée (le serveur plafonne la valeur demandée). | |
hasMore | boolean | Vrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit. | |
items | object[] | Éléments de la page. | |
items[].id | integer | Identifiant de l'article (à passer à get_item ou get_item_stock). | |
items[].kind | string | article (fourniture stockable), job (ouvrage composé d'articles) ou other. | |
items[].name | string | peut être null | Désignation. |
items[].internalReference | string | peut être null | Référence interne. |
items[].externalReference | string | peut être null | Référence externe (fabricant, fournisseur). |
items[].category | string | peut être null | Catégorie (matériau, main d'œuvre…). |
items[].family | string | peut être null | Famille d'articles. |
items[].brand | string | peut être null | Marque. |
items[].unit | string | peut être null | Unité de vente. |
items[].salesPrice | number | peut être null | Prix de vente unitaire hors TVA, en euros. |
items[].vatRate | number | peut être null | Taux de TVA de vente en pourcents. |
items[].isActive | boolean | Faux pour un article désactivé. | |
items[].stockQuantity | number | peut être null | Quantité totale en stock, tous emplacements (articles ; absent sans le module Stock). |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Rechercher des articles | Nom lisible affiché par le client MCP. |
readOnlyHint | oui | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | oui | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur. |
Définition JSON
Entrée exacte de tools/list
{
"name": "search_items",
"title": "Rechercher des articles",
"description": "Liste ou recherche les articles Oxygenius (fournitures) et les ouvrages (composés d'articles), par ordre alphabétique, avec leur prix de vente et, si le module Stock est actif, la quantité en stock. Utiliser get_item pour le détail et get_item_stock pour le stock par emplacement.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"description": "Mots-clés : désignation, références interne et externe, code-barres, description, marque.",
"type": [
"string",
"null"
],
"default": null
},
"kind": {
"description": "all (défaut), article (fournitures) ou job (ouvrages).",
"type": [
"string",
"null"
],
"default": null
},
"category": {
"description": "Fragment du nom de la catégorie ou de la famille d'articles.",
"type": [
"string",
"null"
],
"default": null
},
"availability": {
"description": "Module Stock : all (défaut), in-stock (en stock), out-of-stock (rupture) ou below-minimum (sous le stock minimum).",
"type": [
"string",
"null"
],
"default": null
},
"includeInactive": {
"description": "Inclure les articles désactivés (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 de l'article (à passer à get_item ou get_item_stock).",
"type": "integer"
},
"kind": {
"description": "article (fourniture stockable), job (ouvrage composé d'articles) ou other.",
"type": "string"
},
"name": {
"description": "Désignation.",
"type": [
"string",
"null"
]
},
"internalReference": {
"description": "Référence interne.",
"type": [
"string",
"null"
]
},
"externalReference": {
"description": "Référence externe (fabricant, fournisseur).",
"type": [
"string",
"null"
]
},
"category": {
"description": "Catégorie (matériau, main d'œuvre…).",
"type": [
"string",
"null"
]
},
"family": {
"description": "Famille d'articles.",
"type": [
"string",
"null"
]
},
"brand": {
"description": "Marque.",
"type": [
"string",
"null"
]
},
"unit": {
"description": "Unité de vente.",
"type": [
"string",
"null"
]
},
"salesPrice": {
"description": "Prix de vente unitaire hors TVA, en euros.",
"type": [
"number",
"null"
]
},
"vatRate": {
"description": "Taux de TVA de vente en pourcents.",
"type": [
"number",
"null"
]
},
"isActive": {
"description": "Faux pour un article désactivé.",
"type": "boolean"
},
"stockQuantity": {
"description": "Quantité totale en stock, tous emplacements (articles ; absent sans le module Stock).",
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"kind",
"isActive"
]
}
}
},
"required": [
"totalCount",
"offset",
"limit",
"hasMore",
"items"
]
},
"annotations": {
"title": "Rechercher des articles",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}