cosmo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ERPNEXT_URL | Yes | URL of your ERPNext instance (e.g., https://erp.ma-boutique.com) | |
| ERPNEXT_API_KEY | Yes | API Key of the ERPNext account | |
| ERPNEXT_API_SECRET | Yes | API Secret of the ERPNext account |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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