Skip to main content
Glama
jonathanARMS23

cosmo-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ERPNEXT_URLYesURL of your ERPNext instance (e.g., https://erp.ma-boutique.com)
ERPNEXT_API_KEYYesAPI Key of the ERPNext account
ERPNEXT_API_SECRETYesAPI Secret of the ERPNext account

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_item_stockA

Obtenir le niveau de stock actuel d'un produit spécifique. Utiliser quand l'utilisateur demande 'combien il reste de X', 'quel est le stock de Y', 'est-ce qu'on a encore du Z', 'il reste combien de [produit]'. Préférer ce tool à get_all_stock quand le produit est identifié.

get_low_stock_itemsA

Lister tous les produits dont le stock est sous le seuil minimum de réapprovisionnement. Utiliser pour les alertes de réapprovisionnement, les rapports du matin, ou quand l'utilisateur demande 'qu'est-ce qu'on doit commander', 'quels produits manquent', 'qu'est-ce qui est en rupture', 'liste des produits critiques'.

get_expiring_itemsA

Lister les produits dont la date d'expiration approche dans les prochains N jours. Utiliser quand l'utilisateur demande les produits qui vont expirer, pour planifier des promos de déstockage, ou pour faire le point avant une commande. Par défaut vérifie les 30 prochains jours.

search_itemsA

Rechercher des produits dans le catalogue par nom, code ou marque. Utiliser pour trouver un produit avant une vente, avant une commande fournisseur, ou pour vérifier si un produit existe dans le système. Retourne le prix et le stock de chaque résultat.

receive_stockA

Enregistrer une réception de marchandise fournisseur dans le stock. Utiliser quand l'utilisateur dit 'on vient de recevoir X unités de Y', 'livraison reçue de [fournisseur]', 'entrée stock', 'on a reçu la commande'. Crée une Stock Entry de type Material Receipt dans ERPNext. IMPORTANT : ne pas utiliser pour des corrections d'inventaire, utiliser adjust_stock.

adjust_stockA

Corriger le niveau de stock après un inventaire ou une perte (casse, vol). Utiliser UNIQUEMENT pour des corrections (inventaire physique, casse, vol), PAS pour des réceptions fournisseur (utiliser receive_stock pour ça). Demander confirmation à l'utilisateur avant d'exécuter car action irréversible.

create_itemA

Créer un nouveau produit dans le catalogue ERPNext. Utiliser quand un nouveau produit est référencé pour la première fois, quand l'utilisateur dit 'ajoute ce produit', 'nouveau produit à créer'. Toujours demander confirmation des informations avant de créer.

update_item_priceA

Mettre à jour le prix de vente d'un produit. Utiliser quand l'utilisateur dit 'change le prix de X à Y', 'nouveau prix pour Z'. Demander confirmation avant d'appliquer le changement.

create_saleA

Créer une vente / facture client dans ERPNext. Utiliser quand l'utilisateur dit 'vendre X à Y', 'créer une facture pour', 'encaisser', 'vends [produit] à [client]', 'facture : [liste produits]'. IMPORTANT : toujours présenter un récapitulatif clair et demander confirmation AVANT de créer. Format de confirmation : 'Je vais créer cette vente : [détail]. Total : [montant]. Confirmer ?'

get_daily_salesB

Obtenir le résumé des ventes du jour ou d'une date spécifique. Utiliser pour 'combien on a fait aujourd'hui', 'chiffre du jour', 'résumé des ventes', 'bilan journalier', 'CA du jour'.

get_sales_periodA

Analyser les ventes sur une période personnalisée. Utiliser pour les bilans semaine/mois, comparaisons de périodes, analyses de tendances. Retourne CA total, top produits et répartition par catégorie.

get_invoiceA

Récupérer le détail complet d'une facture par son numéro. Utiliser quand l'utilisateur mentionne un numéro de facture spécifique ou veut vérifier une vente passée.

cancel_invoiceA

Annuler une facture existante. Action IRREVERSIBLE. Toujours demander confirmation avec le numéro de facture et le motif. Ne jamais annuler sans confirmation explicite de l'utilisateur. Utiliser uniquement en cas d'erreur avérée.

find_or_create_customerA

Trouver un client existant ou en créer un nouveau. Utiliser avant create_sale si l'utilisateur mentionne un nom de client. Chercher d'abord par nom, puis par téléphone avant de proposer la création. Exemple : 'Mme Rakoto', 'cliente avec le numéro 034...', 'nouvelle cliente'.

get_customer_profileA

Voir le profil complet d'une cliente : historique achats, produits favoris, dernière visite, montant total dépensé. Utiliser pour personnaliser le service ou préparer une relance.

get_inactive_customersA

Lister les clients qui n'ont pas acheté depuis X jours. Utiliser pour planifier des relances, des campagnes de fidélisation, ou quand l'utilisateur demande 'qui n'est pas venue depuis longtemps'.

get_top_customersA

Lister les meilleures clientes par chiffre d'affaires sur une période. Utiliser pour identifier les VIP, les fidéliser, ou faire des offres exclusives. Exemple : 'qui sont nos meilleures clientes ce mois', 'top 10 clientes'.

create_supplier_orderA

Créer une commande fournisseur dans ERPNext. Utiliser quand l'utilisateur veut commander des produits auprès d'un fournisseur. Toujours vérifier le stock actuel des produits concernés avant de créer la commande. Présenter un récapitulatif complet et demander confirmation avant de créer.

get_pending_ordersA

Voir les commandes fournisseurs en cours (envoyées mais pas encore reçues). Utiliser pour le suivi des livraisons, ou quand l'utilisateur demande 'les commandes en attente', 'qu'est-ce qu'on attend comme livraison'.

get_suppliersA

Lister les fournisseurs actifs avec leurs produits habituels. Utiliser pour savoir auprès de qui commander un produit, ou avant de créer une commande fournisseur.

identify_product_from_imageA

Identifier un produit cosmétique dans ERPNext à partir des données extraites d'une image. WORKFLOW : 1) Hermes analyse d'abord l'image avec vision_analyze pour extraire marque/nom/type, 2) Hermes appelle CE tool avec les données extraites, 3) Ce tool cherche dans ERPNext et retourne le résultat. Utiliser quand l'utilisateur envoie une photo de produit et demande 'c'est quoi ce produit', 'combien coûte ça', 'on l'a en stock ?'.

process_supplier_invoice_imageA

Enregistrer une facture fournisseur dont les données ont été extraites d'une image par Hermes. WORKFLOW : 1) Hermes analyse la photo avec vision_analyze, 2) Hermes appelle CE tool avec les données structurées extraites, 3) Ce tool crée un Cosmo OCR Invoice dans ERPNext et propose une Purchase Invoice. Utiliser quand l'utilisateur envoie une photo de facture fournisseur.

create_item_from_imageA

Créer une fiche produit à partir des données extraites d'une photo de produit non référencé. Utiliser après identify_product_from_image quand le produit n'est pas trouvé dans ERPNext et que l'utilisateur confirme vouloir l'ajouter au catalogue.

get_dashboardA

Obtenir le résumé complet de la boutique : ventes du jour, stock critique, produits expirant bientôt, top produit du jour. Utiliser pour le briefing matinal, les questions générales sur l'état de la boutique, 'comment ça se passe aujourd'hui ?', 'point boutique', 'résumé du jour'.

get_revenue_trendA

Voir l'évolution du chiffre d'affaires sur les derniers N jours. Utiliser pour analyser les tendances, identifier les bons/mauvais jours, comparer les semaines, ou quand l'utilisateur demande 'comment ça évolue'.

get_category_performanceA

Analyser les ventes et performances par catégorie de produits cosmétiques. Utiliser pour savoir quelle catégorie se vend le mieux, ajuster les commandes fournisseurs selon les tendances, ou optimiser l'espace en rayon.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jonathanARMS23/cosmo-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server