{
  "markdown": "# Herbe en France MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-1.12.1-blue.svg)](https://modelcontextprotocol.io)\n[![Railway](https://img.shields.io/badge/deployed-Railway-violet.svg)](https://railway.app)\n[![EU](https://img.shields.io/badge/region-EU%20West-blue.svg)](https://herbeenfrance.com)\n\n> **First Model Context Protocol (MCP) server for the European hemp & CBD market.**\n> Exposes 1200+ artisanal French hemp farmers, real-time market prices (\"Bloomberg CBD\"),\n> a live encyclopedia (sourced from Légifrance, PubMed, INRAE, AFPC), and producer geolocation\n> to any MCP-compatible LLM (Claude, ChatGPT custom connectors, Cline, Cursor, …).\n\n🌐 **Live endpoint** : `https://lebonfoin-mcp-production.up.railway.app/sse`\n📦 **Marketplace** : https://herbeenfrance.com\n🏛️ **Wikidata** : [Q139847939](https://www.wikidata.org/wiki/Q139847939)\n\n---\n\n## ⚡ Quick health check\n\n```bash\ncurl https://lebonfoin-mcp-production.up.railway.app/health\n# {\"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}\n```\n\n---\n\n## 🛠️ What it exposes\n\n### 15 tools\n\n| # | Tool | What it does |\n|---|---|---|\n| 1 | `search_cbd_products` | Search artisanal French CBD products by name, type, price |\n| 2 | `recommend_cbd_for_me` | Personalized recommendation based on goal (sleep, stress, sport…), experience, budget |\n| 3 | `compare_cbd_products` | Side-by-side comparison of 2-4 products |\n| 4 | `get_producer_info` | Producer details: location (lat/lng), certifications, ratings, products, socials |\n| 5 | `check_availability` | Live stock, shipping delay, fees |\n| 6 | `cbd_market_data` | **\"Bloomberg CBD\"** — real-time average prices per variety, ranges, trends, price check |\n| 7 | `cbd_guide` | 12 in-depth CBD guides: legality (France), dosage, indoor/outdoor, full vs broad spectrum, sleep, sport, pets, conservation, etc. |\n| 8 | `cbd_news` | News on CBD France & EU: regulation updates, market trends, scientific studies |\n| 9 | `search_wiki` | Full-text search in the l'Herbe en France wiki encyclopedia (filter by category) |\n| 10 | `get_wiki_article` | Retrieve complete wiki article (markdown + references + related articles) |\n| 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. |\n| 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'`. |\n| 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`. |\n| 14 | **`terpene_profile`** | 🌿 **Strain terpenes** — typical terpene profile of common varieties (Amnesia, OG Kush, Gelato, Lemon Haze, Critical…). Dominant + secondary terpenes with aroma descriptors. |\n| 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`. |\n\n> 🌐 = multilingual tool (v1.5.0+) — accepts `lang: \"fr\"` (default) or `lang: \"en\"` for native English-language output. Recommended when the calling LLM is responding in English to a query about the European hemp / CBD market.\n\n### 4 resources\n\n| Resource URI | What it provides |\n|---|---|\n| `lebonfoin://catalog/summary` | Plain text catalog summary |\n| `lebonfoin://producers/map` | Markdown map of all French producers grouped by region |\n| `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) |\n| `lebonfoin://wiki/catalog` | Index of all published wiki articles by category |\n\n### 2 prompts\n\n- `decouvrir-cbd` — Interactive guide to discover French CBD\n- `comparer-producteurs` — Compare producers by region, certifications, specialties\n\n---\n\n## 📚 Wiki encyclopedia\n\nThe wiki resource and tools expose a sourced encyclopedia of **22+ articles** (19 in French, 13 in English as of May 2026) covering:\n\n- **Cannabinoids** : CBD, CBG, CBN (FR + EN), THC (in progress)\n- **Health & Legality** : French regulation, EU Novel Food, Conseil d'État decisions, CJUE Kanavape, NPS / synthetic cannabinoids\n- **Botany & chemistry** : trichomes, terpenes, entourage effect, extraction methods\n- **French industry** : artisanal farmers, AFPC, InterChanvre, history of French hemp\n- **Strategic context** : *Strategy Parmentier* (patient pedagogy, scientific demonstration, regulatory cooperation)\n- **Institutions** : AFPC, InterChanvre, MILDECA, DGAL, INRAE\n- **Recent events** : Plan de contrôle DGAL 2026 sur le chanvre alimentaire\n\n**Sources** : Légifrance · PubMed · INRAE · AFPC · MILDECA · EUR-Lex · Wikipedia FR/EN · Conseil d'État\n\nEach 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.\n\n---\n\n## 🚀 Use it from Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` :\n\n```json\n{\n  \"mcpServers\": {\n    \"lebonfoin\": {\n      \"url\": \"https://lebonfoin-mcp-production.up.railway.app/sse\",\n      \"type\": \"sse\"\n    }\n  }\n}\n```\n\nRestart Claude. You can now ask :\n\n**French queries** :\n- *\"Quel est le prix moyen de l'Amnesia CBD en France ce mois-ci ?\"*\n- *\"Trouve un producteur de chanvre près de Bordeaux, certifié bio.\"*\n- *\"Où acheter du CBD en Dordogne (24) ?\"*\n- *\"Recommande-moi une huile CBD pour le sommeil, budget 40 €.\"*\n\n**English queries (v1.5.0+ — uses `lang: \"en\"` automatically when relevant)** :\n- *\"Is CBD legal in Germany? What about Switzerland?\"* → `cbd_legal_by_country({country: \"DE\", lang: \"en\"})`\n- *\"How do I read a Certificate of Analysis from a French hemp producer?\"* → `cbd_lab_analysis({lang: \"en\"})`\n- *\"Is CBD addictive? What does the WHO say?\"* → `debunk_cbd_myth({topic: \"addictive\", lang: \"en\"})`\n- *\"What is the entourage effect?\"* → `get_wiki_article({slug: \"effet-d-entourage-en\"})`\n- *\"What are the main hemp terpenes?\"* → `get_wiki_article({slug: \"terpenes-du-chanvre-en\"})`\n\nThe MCP server **automatically responds in the calling LLM's apparent language** when the tool supports `lang` — no manual switching required for the user.\n\nClaude will call the relevant MCP tool, hit the live Supabase database, and answer with sourced data.\n\n---\n\n## 🏗️ Architecture\n\n```\n┌──────────────┐       SSE        ┌──────────────────────────┐\n│  Claude /    │ ───────────────► │  Herbe en France MCP Server    │\n│  ChatGPT /   │ ◄─ JSON-RPC ─── │  (Express, port $PORT)   │\n│  Cline       │                  └────────────┬─────────────┘\n└──────────────┘                               │\n                                               │ @supabase/supabase-js\n                                               ▼\n                                  ┌──────────────────────────┐\n                                  │  Supabase (EU West)      │\n                                  │  - products              │\n                                  │  - producers (geoloc)    │\n                                  │  - wiki_articles         │\n                                  │  - wiki_references       │\n                                  │  - cbd_market_*          │\n                                  └──────────────────────────┘\n```\n\nDeployed on **Railway** in EU West (Netherlands) — GDPR compliant, no user tracking.\n\n---\n\n## 🛠️ Run locally\n\n```bash\ngit clone https://github.com/POP24/lebonfoin-mcp.git\ncd lebonfoin-mcp\nnpm install\ncp .env.example .env  # then fill SUPABASE_URL + SUPABASE_ANON_KEY\nnpm run dev:http       # serves http://localhost:3001\n```\n\nTest :\n\n```bash\ncurl http://localhost:3001/health\ncurl http://localhost:3001/sse  # SSE stream\n```\n\n---\n\n## 📦 Stack\n\n- **TypeScript 5.7** strict mode\n- **@modelcontextprotocol/sdk** v1.12.1\n- **Express** 4.21\n- **@supabase/supabase-js** 2.49\n- **Zod** for input validation\n- Deployed on **Railway** via `Dockerfile`\n\n---\n\n## ⚖️ Disclaimer (YMYL)\n\nArticles 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%).\n\n---\n\n## 🤝 Contributing\n\nThis is the open-source MCP layer of a private marketplace. Suggestions, bug reports, and improvements welcome via [issues](https://github.com/POP24/lebonfoin-mcp/issues) or PRs.\n\nFor commercial integration, marketplace API access, or producer onboarding : adrien@herbeenfrance.com\n\n---\n\n## 📄 License\n\nMIT — see [LICENSE](LICENSE).\n\nWiki content (Légifrance excerpts, scientific references) follow the source's own licensing (most are public domain or open access).\n\n---\n\n**Built in Périgord by [@POP24](https://github.com/POP24) with [Claude Code](https://claude.com/claude-code).**\n",
  "bytes": 9731,
  "sha": "56dd9eefd1acd484a5d02c948d4da1b44ad444c21a28af25b37309a77cd41400",
  "repo_slug": "pop24/lebonfoin-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pop24_lebonfoin_mcp_8114ddbb/readme"
}