leadbay · ArtyETH06 · Aug 17, 2026 · Aug 17, 2026 · Aug 17, 2026
diff --git a/fr/leadbay-mcp/example-prompts.md b/fr/leadbay-mcp/example-prompts.md
@@ -8,6 +8,20 @@ Leadbay MCP fonctionne mieux quand vous parlez à Claude comme à un collègue
 
 ---
 
+## C'est votre première fois
+
+> *Fais-moi découvrir Leadbay.*
+
+> *Je débute — comment ça marche ?*
+
+> *Fais-moi visiter.*
+
+Claude déroule une visite guidée sur votre propre compte plutôt que de vous l'expliquer : vérifier votre compte, voir les leads du jour, rédiger un premier email au meilleur d'entre eux, puis trouver à qui l'envoyer. Un bouton par étape. Rien n'est envoyé, rien n'est dépensé sans votre accord, et taper autre chose à n'importe quel moment met fin à la visite et vous donne ce que vous avez demandé.
+
+Vous voulez l'explication sans les clics ? Demandez plutôt *« donne-moi un aperçu de ma prospection »*.
+
+---
+
 ## Commencer votre journée
 
 > *Montre-moi les leads du jour.*

diff --git a/fr/leadbay-mcp/quickstart.md b/fr/leadbay-mcp/quickstart.md
@@ -41,6 +41,37 @@ C'est toute la connexion — aucun jeton, aucun fichier de config. Claude est d
 
 ---
 
+## Vous débutez ? Faites le tour guidé
+
+Vous ne savez pas quoi demander en premier ? Tapez :
+
+> _Fais-moi découvrir Leadbay._
+
+Claude déroule une courte visite guidée sur votre propre compte — quatre étapes, un bouton chacune, et c'est vous qui cliquez pour avancer :
+
+| Étape | Ce que ça fait |
+|---|---|
+| **Vérifier mon compte** | Sur quel compte vous êtes, et ce qu'il vous reste de quota IA cette semaine. |
+| **Voir les leads du jour** | Le batch du jour issu de votre lens — classé, avec une ligne expliquant pourquoi chacun colle. |
+| **Rédiger le premier email** | Écrit un premier email à la meilleure entreprise. Rien n'est envoyé. |
+| **Trouver à qui l'envoyer** | Montre les rôles qui existent chez elle, puis révèle la vraie personne — uniquement si vous confirmez. |
+
+Chaque étape est une vraie action sur votre vrai compte, pas une démo. Vous pouvez vous arrêter à tout moment avec **J'ai terminé pour l'instant**, ou simplement taper ce que vous vouliez vraiment — la visite s'efface et Claude vous suit.
+
+{% hint style="info" %}
+**Rien n'est dépensé sans votre accord.** Les trois premières étapes sont gratuites, tout comme l'aperçu des rôles que vous _pourriez_ contacter. Révéler un vrai email ou un vrai téléphone coûte un crédit par contact, et la visite vous annonce le coût avant que vous décidiez.
+{% endhint %}
+
+<!-- CAPTURE (optionnelle) — la première étape de la visite : la carte du compte
+     et le widget de choix à deux options. Déposez l'image dans
+     .gitbook/assets/mcp-walkthrough-gate1.png et décommentez :
+<figure><img src="../../.gitbook/assets/mcp-walkthrough-gate1.png" alt="Claude affichant la carte du compte Leadbay avec un bouton Vérifier mon compte et une sortie J'ai terminé pour l'instant"><figcaption><p>Étape 1 du tour guidé : votre compte et votre quota, puis un bouton pour continuer.</p></figcaption></figure>
+-->
+
+Vous préférez aller droit au but ? Sautez la visite et passez à l'Étape 3.
+
+---
+
 ## Étape 3 — Demandez vos premiers leads
 
 Ouvrez une nouvelle conversation et tapez :

diff --git a/fr/leadbay-mcp/tools-reference.md b/fr/leadbay-mcp/tools-reference.md
@@ -14,6 +14,7 @@ Ils ne modifient jamais votre compte, on peut donc les autoriser sans risque.
 
 | Outil | Ce qu'il fait |
 |------|--------------|
+| `leadbay_getting_started` | Déroule la visite guidée de première utilisation — quatre étapes sur votre propre compte, un bouton chacune |
 | `leadbay_pull_leads` | Récupère le lot de leads frais du jour, scoré et classé |
 | `leadbay_pull_followups` | Récupère les leads qui nécessitent une action de relance |
 | `leadbay_account_status` | Vérifie votre quota, vos crédits et l'état de votre compte |
@@ -137,6 +138,7 @@ Vous ne choisissez pas les outils — vous décrivez le résultat. Quelques exem
 
 | Vous dites… | Claude appelle… |
 |----------|---------------|
+| « Fais-moi découvrir Leadbay » | `leadbay_getting_started` |
 | « Montre-moi les leads du jour » | `leadbay_pull_leads` |
 | « Quels leads dois-je relancer ? » | `leadbay_pull_followups` |
 | « Parle-moi de acme.com » | `leadbay_research_lead_by_name_fuzzy` |

diff --git a/leadbay-mcp/example-prompts.md b/leadbay-mcp/example-prompts.md
@@ -8,6 +8,20 @@ Leadbay MCP works best when you talk to Claude the way you'd talk to a colleague
 
 ---
 
+## First time here
+
+> *Walk me through Leadbay.*
+
+> *I'm new — how do I use this?*
+
+> *Give me a tour.*
+
+Claude runs a guided walkthrough on your own account rather than explaining it at you: check your account, pull today's leads, draft a first email to the best one, then find out who to send it to. One button per step. Nothing is sent, nothing is spent without your say-so, and typing something else at any point ends the tour and gets you what you asked for instead.
+
+Want the explanation without the clicking? Ask *"give me an overview of my prospecting"* instead.
+
+---
+
 ## Start your day
 
 > *Show me today's leads.*

diff --git a/leadbay-mcp/quickstart.md b/leadbay-mcp/quickstart.md
@@ -41,6 +41,37 @@ That's the whole connection — no tokens, no config files. Claude is now linked
 
 ---
 
+## New here? Take the guided tour
+
+Not sure what to ask for first? Type:
+
+> _Walk me through Leadbay._
+
+Claude runs a short walkthrough on your own account — four steps, one button each, and you click to move forward:
+
+| Step | What it does |
+|---|---|
+| **Check my account** | Which account you're on, and how much of your AI quota is left this week. |
+| **Pull today's leads** | Today's batch from your lens — ranked, with a one-line reason each fits. |
+| **Draft the first email** | Writes a first email to the top company. Nothing is sent. |
+| **Find who to email** | Shows which roles exist there, then reveals the actual person — only if you confirm. |
+
+Every step is a real action on your real account, not a demo. You can stop at any point with **I'm done for now**, or just type what you actually wanted — the walkthrough steps aside and Claude follows you there.
+
+{% hint style="info" %}
+**Nothing is spent without your say-so.** The first three steps are free, and so is the preview of _which_ roles you could contact. Revealing a real email or phone number costs one credit per contact, and the walkthrough tells you the cost before you decide.
+{% endhint %}
+
+<!-- SCREENSHOT (optional) — the walkthrough's first step: the account card plus
+     the two-option choice widget. Drop the image into
+     .gitbook/assets/mcp-walkthrough-gate1.png and uncomment:
+<figure><img src="../.gitbook/assets/mcp-walkthrough-gate1.png" alt="Claude showing the Leadbay account card with a Check my account button and an I'm done for now exit"><figcaption><p>Step 1 of the guided tour: your account and quota, then one button to go on.</p></figcaption></figure>
+-->
+
+Prefer to jump straight in? Skip the tour and go to Step 3.
+
+---
+
 ## Step 3 — Ask for your first leads
 
 Open a new conversation and type:

diff --git a/leadbay-mcp/tools-reference.md b/leadbay-mcp/tools-reference.md
@@ -14,6 +14,7 @@ These never modify your account, so they're always safe to allow.
 
 | Tool | What it does |
 |------|--------------|
+| `leadbay_getting_started` | Runs the guided first-run walkthrough — four steps on your own account, one button each |
 | `leadbay_pull_leads` | Retrieves today's fresh lead batch, scored and ranked |
 | `leadbay_pull_followups` | Pulls the leads that need a follow-up action |
 | `leadbay_account_status` | Checks your quota, credits, and account state |
@@ -137,6 +138,7 @@ You don't pick tools — you describe the outcome. A few examples of the mapping
 
 | You say… | Claude calls… |
 |----------|---------------|
+| "Walk me through Leadbay" | `leadbay_getting_started` |
 | "Show me today's leads" | `leadbay_pull_leads` |
 | "Which leads should I follow up with?" | `leadbay_pull_followups` |
 | "Tell me about acme.com" | `leadbay_research_lead_by_name_fuzzy` |