manifest.fr.json•4.93 kB
{
"name": "Serveur MCP Kash.click",
"version": "1.2.0",
"description": "Expose l’API kash.click sous forme d’outils MCP, permettant un accès programmatique à l’authentification, à la création de ventes et à la consultation des données du commerce.",
"endpoints": [
{
"type": "http",
"url": "https://mcp.kash.click/mcp",
"supports_streaming": true
}
],
"auth": {
"type": "api_key",
"fields": {
"api_key": {
"name": "API key",
"in": "header",
"key": "Authorization",
"prefix": "Bearer "
},
"shop_id": {
"name": "Shop ID",
"in": "header",
"key": "X-Shop-Id"
}
}
},
"capabilities": {
"tools": true,
"resources": false,
"prompts": false
},
"tools": [
{
"name": "ping",
"description": "Vérifie l’état du serveur MCP. Retourne { result: 'OK' } si le serveur est opérationnel."
},
{
"name": "sale_create",
"description": "Crée une nouvelle vente pour l'établissement connecté. Prend en entrée le mode de paiement et la liste des articles. Chaque article peut être du type « catalogue » (avec productId) ou « rayon » (avec deptId) ou « libre » (avec titre et prix). Vérifier si le client n''existe déjà en utilisant data_list_clients et si le client existe préciser idClient. Si fourni, paymentMode doit correspondre à un ID de paiement de l'outil data_list_payments. Retourne un objet JSON de confirmation de la vente tel que fourni par l’API distante."
},
{
"name": "data_list_products",
"description": "Récupère la liste complète des articles (produits) enregistrés dans la boutique. Retourne un tableau d’articles contenant les champs id, titre, prix, rayon, TVA, etc. Le paramètre optionnel 'format' permet de choisir la sortie (json, csv ou html)."
},
{
"name": "data_list_departments",
"description": "Retourne la liste des rayons (catégories de produits) définis dans la boutique, avec leurs noms et taux de TVA associés. Compatible avec les formats json, csv ou html."
},
{
"name": "data_list_department_groups",
"description": "Récupère la liste des groupes de rayons, utilisés pour organiser les catégories de produits. Chaque groupe peut regrouper plusieurs rayons."
},
{
"name": "data_list_clients",
"description": "Retourne la liste des clients enregistrés dans la boutique, incluant leurs informations de contact, points de fidélité..."
},
{
"name": "data_list_variations",
"description": "Liste toutes les déclinaisons d’articles (par exemple : taille, couleur, grammage). Retourne un tableau d’objets indiquant les valeurs et écarts de prix éventuels."
},
{
"name": "data_list_delivery_men",
"description": "Récupère la liste des modes de livraison disponibles dans la boutique : retrait en magasin, livraison à domicile, transporteur, etc.."
},
{
"name": "data_list_payments",
"description": "Retourne la liste des moyens de paiement configurés dans la boutique (espèces, carte bancaire, paiement mobile, etc.)."
},
{
"name": "data_list_cashboxes",
"description": "Récupère la liste des caisses enregistrées (physiques ou virtuelles) associées à la boutique, avec leurs identifiants et leur état actuel."
},
{
"name": "data_list_delivery_zones",
"description": "Retourne toutes les zones de livraison configurées, incluant les noms de zone, codes postaux et éventuels frais de livraison associés."
},
{
"name": "data_list_relay_points",
"description": "Liste les points relais disponibles pour la livraison des commandes, avec leur nom, adresse, ville et code postal."
},
{
"name": "data_list_discounts",
"description": "Retourne l’ensemble des réductions ou suppléments disponibles dans la boutique, incluant leur nom, type (pourcentage ou fixe), valeur et conditions d’application."
},
{
"name": "data_list_users",
"description": "Récupère la liste des utilisateurs (vendeurs, gérants, etc.) rattachés à la boutique, avec leurs rôles et identifiants."
},
{
"name": "data_list_tables",
"description": "Retourne la liste des tables configurées dans l’application, utilisée notamment pour le mode restauration ou la gestion des tables en salle."
},
{
"name": "data_list_orders",
"description": "Listez soit les commandes non validées (les devis) dont la date de création est comprise entre from_date_ISO8601 et to_date_ISO8601, soit les commandes validées (dénommées commandes ou factures) dont la date de valeur est comprise entre from_date_ISO8601 et to_date_ISO8601. Vous pouvez également filtrer les modes de livraison (avec filterDeliveryMethod)."
}
]
}
