La Carotte — Produits Locaux & Circuits Courts

by juaniyyoo

267 downloads
Not rated
GitHub

About

Accédez au catalogue La Carotte directement depuis votre agent IA. Recherchez des fruits, légumes, fromages et produits de la ferme, vérifiez les stocks en temps réel, contrôlez les zones de livraison et gérez un panier : le tout en circuits courts depuis Poitiers.

Details

Author
juaniyyoo
Downloads
267
Categories
Other

- Public endpoint, no API key required.
- Search products with filters (category, producer, label, price).
- Real‑time stock verification for a specific product.
- Check delivery zone and list nearby pickup points.
- Create and manage persistent shopping baskets.
- Exposes a store-context resource for agent context.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name La Carotte — Produits Locaux & Circuits Courts
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure the server in your MCP client (Claude Desktop, Cursor, VS Code) by adding the URL https://mcp.la-carotte.fr/mcp (Streamable HTTP) or https://mcp.la-carotte.fr/sse (SSE legacy). No API key is required. Then use natural language queries such as “Cherche des fromages disponibles en livraison à Poitiers” or “Crée un panier et ajoute 2 kg de carottes” to interact.

search_products

Recherche dans le catalogue de produits locaux LaCarotte. QUAND L'UTILISER : l'utilisateur cherche des produits, mentionne une catégorie, un producteur, ou demande ce qui est disponible. CE QUE C'EST : recherche enrichie avec infos producteur, labels, distance. CE QUE CE N'EST PAS : une vérification de stock précise, ni une commande.

check_stock

Vérification du stock en temps réel pour un produit LaCarotte. QUAND L'UTILISER : le client demande si un produit est en stock ou veut connaître la quantité disponible. CE QUE C'EST : vérification temps réel du stock avec alternatives si rupture. CE QUE CE N'EST PAS : une recherche de produit, ni une réservation.

check_delivery_zone

Vérification de la zone de livraison et des points de retrait LaCarotte. QUAND L'UTILISER : le client demande si on livre chez lui ou quels sont les points de retrait. CE QUE C'EST : vérification des zones couvertes avec options de retrait. CE QUE CE N'EST PAS : une planification de livraison, ni une commande.

get_product

Fiche complète d'un produit LaCarotte par son ID. QUAND L'UTILISER : on connaît l'ID du produit et on veut tous ses détails (prix, unité, producteur, description). CE QUE C'EST : fiche produit complète. CE QUE CE N'EST PAS : une recherche — utiliser search_products pour chercher par mots-clés.

list_partners

Liste des producteurs en ligne sur LaCarotte avec leurs produits disponibles et leurs phrases de présentation. QUAND L'UTILISER : l'utilisateur veut connaître les producteurs, leurs engagements, leurs produits. CE QUE C'EST : liste des partenaires actifs avec ID produits, liens produits, phrases whyThisJob et whyCarotte. CE QUE CE N'EST PAS : une fiche produit — utiliser get_product pour les détails d'un produit.

list_categories

Arborescence des catégories et types produit du catalogue LaCarotte avec liens. QUAND L'UTILISER : l'utilisateur veut naviguer par rayon, connaître les catégories disponibles, ou filtrer search_products par catégorie. CE QUE C'EST : liste des catégories (racine + sous-catégories) et types produit associés, avec URLs vers les pages de la boutique. CE QUE CE N'EST PAS : une liste de produits — utiliser search_products avec le paramètre category pour trouver des produits.

get_checkout_info

Récapitulatif de panier pour le checkout LaCarotte. QUAND L'UTILISER : le client veut voir le résumé de son panier avant paiement. CE QUE C'EST : sous-total, articles, options de livraison, URL de paiement. CE QUE CE N'EST PAS : une action de paiement. Ne déclenche aucune transaction.

create_basket

Création d'un panier persistant avec lien partageable. QUAND L'UTILISER : le client veut commencer ses courses ou créer un panier. CE QUE C'EST : création d'un panier vide avec tokens de partage. CE QUE CE N'EST PAS : un ajout de produit (utiliser add_to_basket ensuite).

add_to_basket

Ajout d'un produit à un panier LaCarotte existant. QUAND L'UTILISER : le client veut ajouter un produit à son panier. CE QUE C'EST : ajout avec vérification de stock et snapshot du prix. CE QUE CE N'EST PAS : une commande ni un paiement.

get_basket

Consultation d'un panier LaCarotte. QUAND L'UTILISER : le client veut voir le contenu de son panier. CE QUE C'EST : liste des articles, total, statut du panier. CE QUE CE N'EST PAS : une modification du panier.

remove_from_basket

Retrait d'un produit d'un panier LaCarotte. QUAND L'UTILISER : le client veut retirer un produit de son panier. CE QUE C'EST : suppression d'un article du panier. CE QUE CE N'EST PAS : une annulation de commande.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "la carotte \u2014 produits locaux & circuits courts": {
            "lacarotte": {
                "url": "https://mcp.la-carotte.fr/mcp"
            }
        }
    }
}

McpServers

{
    "lacarotte": {
        "url": "https://mcp.la-carotte.fr/mcp"
    }
}

LaCarotte MCP Server

Accédez au catalogue de produits locaux La Carotte directement depuis votre agent IA. La Carotte est une plateforme de vente en circuits courts basée à Poitiers (Nouvelle-Aquitaine) — fruits, légumes, fromages, viandes, épicerie, directement des producteurs locaux. Endpoint public, sans clé API. ---

Configuration

Claude Desktop / Cursor / VS Code

``json { "mcpServers": { "lacarotte": { "url": "https://mcp.la-carotte.fr/mcp" } } } `

SSE (clients legacy MCP)

`json { "mcpServers": { "lacarotte": { "url": "https://mcp.la-carotte.fr/sse" } } } ` ---

Prompts d'exemple

> "Cherche des fromages de yaourts disponibles en livraison à Poitiers" > "Crée un panier et ajoute 2 kg de carottes et 1 bouteille de jus de pomme" > "Est-ce que vous livrez au 86000 ? Sinon, quels sont les points de retrait proches ?" > "Montre-moi les producteurs qui ont du stock cette semaine" ---

Tools disponibles

🔍 search_products

Recherche enrichie dans le catalogue. | Paramètre | Type | Description | |---|---|---| |
query | string | Mot-clé libre (ex: "pommes de terre") | | category | string | Catégorie produit | | producer | string | Nom du producteur/partenaire | | label | string | Label qualité : bio, Bleu-Blanc-Coeur, Label Rouge… | | price_max_eur | number | Prix maximum en euros | | sort_by | enum | pertinence \| prix_asc \| prix_desc \| distance \| fraicheur | | page | integer | Page (défaut: 1) | | per_page | integer | Résultats par page, max 20 (défaut: 10) | ---

📦 check_stock

Vérification du stock en temps réel pour un produit précis. | Paramètre | Type | Description | |---|---|---| |
product_id | string | Requis. Identifiant du produit | | quantity | integer | Quantité souhaitée (défaut: 1) | ---

📍 check_delivery_zone

Vérifie si une adresse est livrée et liste les points de retrait disponibles. | Paramètre | Type | Description | |---|---|---| |
postal_code | string | Code postal à vérifier | | city | string | Nom de la ville | ---

🛒 create_basket

Crée un panier persistant avec token de partage. | Paramètre | Type | Description | |---|---|---| |
label | string | Nom du panier (ex: "Commande semaine du 12 mai") | Retourne : basket_id, owner_token, share_token, share_url. ---

➕ add_to_basket

Ajoute un produit au panier avec vérification de stock. | Paramètre | Type | Description | |---|---|---| |
basket_id | string | Requis. Identifiant du panier | | product_id | string | Requis. Identifiant du produit | | quantity | integer | Quantité (défaut: 1) | | added_by | string | Prénom du participant (défaut: "Client") | | owner_token | string | Token propriétaire | ---

👁 get_basket

Consulte le contenu d'un panier. | Paramètre | Type | Description | |---|---|---| |
basket_id | string | Requis. Identifiant du panier | | owner_token | string | Token propriétaire (lecture/écriture) | | share_token | string | Token de partage (lecture seule) | ---

❌ remove_from_basket

Retire un produit du panier. | Paramètre | Type | Description | |---|---|---| |
basket_id | string | Requis. Identifiant du panier | | product_id | string | Requis. Identifiant du produit | | owner_token | string | Requis. Token propriétaire | ---

🧾 get_checkout_info

Récapitulatif complet du panier pour finaliser la commande. | Paramètre | Type | Description | |---|---|---| |
basket_id | string | Requis. Identifiant du panier | ---

Ressource MCP

Le serveur expose une ressource
store-context qui fournit aux agents le contexte général : producteurs actifs, labels disponibles, zones de livraison et configuration du magasin. ---

Transport

- Streamable HTTP (
/mcp) — conforme spec MCP 2025-03-26, sessions per-request - SSE (/sse + /messages`) — compatible clients MCP legacy ---

Liens

- 🌐 Site : www.la-carotte.fr - 💻 Repo : github.com/juaniyyoo/lacarotte-mcp-public - ❤️ Health : mcp.la-carotte.fr/health
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.