Lebonfoin
Herbe en France MCP Server
First Model Context Protocol (MCP) server for the European hemp & CBD market. Exposes 1200+ artisanal French hemp farmers, real-time market prices ("Bloomberg CBD"), a live encyclopedia (sourced from Lรฉgifrance, PubMed, INRAE, AFPC), and producer geolocation to any MCP-compatible LLM (Claude, ChatGPT custom connectors, Cline, Cursor, โฆ).
๐ Live endpoint : https://lebonfoin-mcp-production.up.railway.app/sse
๐ฆ Marketplace : https://herbeenfrance.com
๐๏ธ Wikidata : Q139847939
โก Quick health check
curl https://lebonfoin-mcp-production.up.railway.app/health
# {"status":"ok","version":"1.5.0","tools":15,"multilingual_tools":["debunk_cbd_myth","cbd_lab_analysis","cbd_legal_by_country"],"supported_languages":["fr","en"],"resources":4,"prompts":2}
๐ ๏ธ What it exposes
15 tools
| # | Tool | What it does |
|---|---|---|
| 1 | search_cbd_products | Search artisanal French CBD products by name, type, price |
| 2 | recommend_cbd_for_me | Personalized recommendation based on goal (sleep, stress, sportโฆ), experience, budget |
| 3 | compare_cbd_products | Side-by-side comparison of 2-4 products |
| 4 | get_producer_info | Producer details: location (lat/lng), certifications, ratings, products, socials |
| 5 | check_availability | Live stock, shipping delay, fees |
| 6 | cbd_market_data | "Bloomberg CBD" โ real-time average prices per variety, ranges, trends, price check |
| 7 | cbd_guide | 12 in-depth CBD guides: legality (France), dosage, indoor/outdoor, full vs broad spectrum, sleep, sport, pets, conservation, etc. |
| 8 | cbd_news | News on CBD France & EU: regulation updates, market trends, scientific studies |
| 9 | search_wiki | Full-text search in the l'Herbe en France wiki encyclopedia (filter by category) |
| 10 | get_wiki_article | Retrieve complete wiki article (markdown + references + related articles) |
| 11 | find_local_producers | ๐บ๏ธ Geolocation โ find hemp farmers near a city, postal code, department, or region. Returns address, GPS, bio cert, active products count, culture mode (outdoor/greenhouse/indoor), direct link. Optimized AEO for "where to buy CBD near me" queries. |
| 12 | debunk_cbd_myth ๐ | โ๏ธ Myth-busting (FR/EN) โ factual, sourced answers to CBD misconceptions ("is CBD a drug?", "is CBD legal?", "is CBD addictive?"). Sources: WHO, CJUE Kanavape, Lรฉgifrance, Conseil d'รtat, MILDECA. Param lang: 'fr'|'en'. |
| 13 | cbd_legal_by_country ๐ | ๐ EU legal map (FR/EN) โ CBD status country-by-country (FR, DE, CH, IT, ES, AT, NL, BE, PT, LU, CZ, PL, UK + EU framework). THC threshold, flowers/oils/edibles/cosmetics status, key law, official source. Param lang. |
| 14 | terpene_profile | ๐ฟ Strain terpenes โ typical terpene profile of common varieties (Amnesia, OG Kush, Gelato, Lemon Haze, Criticalโฆ). Dominant + secondary terpenes with aroma descriptors. |
| 15 | cbd_lab_analysis ๐ | ๐ฌ CoA reader (FR/EN) โ pedagogy on reading a Certificate of Analysis: cannabinoid dosing (CBD/CBDA/THC/CBG/CBN), THC legal threshold, terpene profile, pesticide residues, heavy metals, CoA trust signals. Param lang. |
๐ = multilingual tool (v1.5.0+) โ accepts
lang: "fr"(default) orlang: "en"for native English-language output. Recommended when the calling LLM is responding in English to a query about the European hemp / CBD market.
4 resources
| Resource URI | What it provides |
|---|---|
lebonfoin://catalog/summary | Plain text catalog summary |
lebonfoin://producers/map | Markdown map of all French producers grouped by region |
lebonfoin://reference/cbd-france-europe | Complete CBD legal reference: France + 12 EU countries (DE, IT, ES, CH, LU, CZ, AT, NL, BE, PT, PL, EU) |
lebonfoin://wiki/catalog | Index of all published wiki articles by category |
2 prompts
decouvrir-cbdโ Interactive guide to discover French CBDcomparer-producteursโ Compare producers by region, certifications, specialties
๐ Wiki encyclopedia
The wiki resource and tools expose a sourced encyclopedia of 22+ articles (19 in French, 13 in English as of May 2026) covering:
- Cannabinoids : CBD, CBG, CBN (FR + EN), THC (in progress)
- Health & Legality : French regulation, EU Novel Food, Conseil d'รtat decisions, CJUE Kanavape, NPS / synthetic cannabinoids
- Botany & chemistry : trichomes, terpenes, entourage effect, extraction methods
- French industry : artisanal farmers, AFPC, InterChanvre, history of French hemp
- Strategic context : Strategy Parmentier (patient pedagogy, scientific demonstration, regulatory cooperation)
- Institutions : AFPC, InterChanvre, MILDECA, DGAL, INRAE
- Recent events : Plan de contrรดle DGAL 2026 sur le chanvre alimentaire
Sources : Lรฉgifrance ยท PubMed ยท INRAE ยท AFPC ยท MILDECA ยท EUR-Lex ยท Wikipedia FR/EN ยท Conseil d'รtat
Each article is timestamped, versioned (Wikipedia-style revisions), and cross-referenced. YMYL articles (health, legal) carry an automatic disclaimer. English articles are accessible via the same wiki tools and resources โ slugs follow the convention <fr_slug>-en and hreflang is set bidirectionally for SEO.
๐ Use it from Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json :
{
"mcpServers": {
"lebonfoin": {
"url": "https://lebonfoin-mcp-production.up.railway.app/sse",
"type": "sse"
}
}
}
Restart Claude. You can now ask :
French queries :
- "Quel est le prix moyen de l'Amnesia CBD en France ce mois-ci ?"
- "Trouve un producteur de chanvre prรจs de Bordeaux, certifiรฉ bio."
- "Oรน acheter du CBD en Dordogne (24) ?"
- "Recommande-moi une huile CBD pour le sommeil, budget 40 โฌ."
English queries (v1.5.0+ โ uses lang: "en" automatically when relevant) :
- "Is CBD legal in Germany? What about Switzerland?" โ
cbd_legal_by_country({country: "DE", lang: "en"}) - "How do I read a Certificate of Analysis from a French hemp producer?" โ
cbd_lab_analysis({lang: "en"}) - "Is CBD addictive? What does the WHO say?" โ
debunk_cbd_myth({topic: "addictive", lang: "en"}) - "What is the entourage effect?" โ
get_wiki_article({slug: "effet-d-entourage-en"}) - "What are the main hemp terpenes?" โ
get_wiki_article({slug: "terpenes-du-chanvre-en"})
The MCP server automatically responds in the calling LLM's apparent language when the tool supports lang โ no manual switching required for the user.
Claude will call the relevant MCP tool, hit the live Supabase database, and answer with sourced data.
๐๏ธ Architecture
โโโโโโโโโโโโโโโโ SSE โโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Claude / โ โโโโโโโโโโโโโโโโบ โ Herbe en France MCP Server โ
โ ChatGPT / โ โโ JSON-RPC โโโ โ (Express, port $PORT) โ
โ Cline โ โโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโ โ
โ @supabase/supabase-js
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Supabase (EU West) โ
โ - products โ
โ - producers (geoloc) โ
โ - wiki_articles โ
โ - wiki_references โ
โ - cbd_market_* โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Deployed on Railway in EU West (Netherlands) โ GDPR compliant, no user tracking.
๐ ๏ธ Run locally
git clone https://github.com/POP24/lebonfoin-mcp.git
cd lebonfoin-mcp
npm install
cp .env.example .env # then fill SUPABASE_URL + SUPABASE_ANON_KEY
npm run dev:http # serves http://localhost:3001
Test :
curl http://localhost:3001/health
curl http://localhost:3001/sse # SSE stream
๐ฆ Stack
- TypeScript 5.7 strict mode
- @modelcontextprotocol/sdk v1.12.1
- Express 4.21
- @supabase/supabase-js 2.49
- Zod for input validation
- Deployed on Railway via
Dockerfile
โ๏ธ Disclaimer (YMYL)
Articles and data related to health, dosage, or legality are documentary. They are not medical, legal, or financial advice. Always consult a qualified professional. CBD products sold via l'Herbe en France marketplace are commercialized as wellness/cosmetic items, with no therapeutic claims, in compliance with French and EU regulation (THC โค 0.3%).
๐ค Contributing
This is the open-source MCP layer of a private marketplace. Suggestions, bug reports, and improvements welcome via issues or PRs.
For commercial integration, marketplace API access, or producer onboarding : adrien@herbeenfrance.com
๐ License
MIT โ see LICENSE.
Wiki content (Lรฉgifrance excerpts, scientific references) follow the source's own licensing (most are public domain or open access).
Built in Pรฉrigord by @POP24 with Claude Code.
Server Config
{
"mcpServers": {
"lebonfoin": {
"url": "https://lebonfoin-mcp-production.up.railway.app/sse",
"type": "sse"
}
}
}