Le Parrain MCP
This MCP server lets an AI assistant search Le Parrain's referral directory and blog, and (per the schema) submit a new program suggestion — each result comes back with the correct referral link resolved for the caller.
search_programs— keyword search (brand, category, sector) across referral programs; returns the resolved referral link (yours if connected and published, otherwise the default).get_program— full detail of one program by slug (e.g.qonto), plus its resolved referral link.search_blog— search Le Parrain's blog articles (advice, comparisons, deals) and get related programs; good for broader questions.suggest_program— propose a program missing from the directory (name required; URL/category optional); it goes to human moderation, nothing is published automatically.
Notes:
All four tools are read-only/
taskSupport: forbidden, callable without an account (anonymous callers get the default platform link).The README contradicts the schema twice: it states
suggest_programis not exposed (its moderation queue is in-memory), and it lists personal/write tools (get_best_referral,compare_programs,create_announcement,list_pro_programs,recommend_contact,get_my_commissions) that do not appear in this schema. Treat the advertised OAuth-gated and publishing capabilities as unavailable here.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Le Parrain MCP Search for cashback programs for flights"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Le Parrain MCP
Serveur MCP (Model Context Protocol) pour interroger l'annuaire de parrainage leparrain.com directement depuis un assistant IA (ChatGPT, Claude…), avec injection automatique du bon lien de parrainage.
Repo volontairement séparé du Parrain. Aucun code source ni accès base du dépôt principal. Aucun secret n'est commité. Ce dépôt peut être public sans rien exposer.
Démarrage rapide (POC)
npm install
cp .env.example .env # ajustez LP_USER pour simuler un appelant connecté
npm run smoke # tests de la logique et des garde-fous
npm start # lance le serveur MCP (transport stdio)Le POC tourne sur un dataset d'exemple en mémoire (LP_DATA_MODE=sample) :
aucune infra Le Parrain requise.
Simuler un appelant
| Comportement |
| Appelant anonyme → lien plateforme par défaut |
| Connectée, a déjà publié des liens → ses liens ressortent |
| Connectée sans lien → lien plateforme + invitation à créer |
Related MCP server: Backlinks MCP
Outils principaux
Tool | Rôle |
| Cherche des programmes, renvoie le lien résolu pour vous |
| Détail d'un programme + lien résolu |
| Donne le lien de parrainage résolu pour une marque |
| Compare deux programmes et leurs liens |
| Cherche dans les articles publiés |
| Publie votre annonce (compte connecté) |
| Liste les programmes partenaires acceptant des recommandations (connecté) |
| Transmet un contact consentant après confirmation explicite (connecté) |
| Suit les commissions de recommandation du compte (connecté) |
Les outils de recommandation n'inscrivent et n'administrent aucun professionnel. Ils sont réservés à l'utilisateur connecté qui recommande un contact consentant, et ne renvoient pas les coordonnées du contact après l'envoi.
suggest_program n'est pas exposé par le serveur : sa file de modération
actuelle est en mémoire et ne garantit pas la conservation d'une proposition.
La logique de choix du lien (« chaîne de résolution ») est décrite dans
PLAN.md.
Brancher à un client MCP
Option A — Remote (URL à coller, recommandé)
Serveur en ligne, aucun fichier à éditer : collez l'URL dans un connecteur custom de ChatGPT / Claude.
https://leparrain.com/mcpSans connexion, les cinq outils de découverte en lecture seule sont disponibles :
search_programs, get_program, get_best_referral, compare_programs et
search_blog. Le lien servi est celui résolu pour un visiteur anonyme.
Les outils personnels, de publication et de transmission de données exigent un
compte Le Parrain connecté par OAuth. Un token fourni mais invalide déclenche
un défi OAuth ; une panne de l'API renvoie une erreur temporaire.
Endpoint de santé : GET https://leparrain.com/mcp/health.
Déploiement (serveur Plesk) : process PM2 leparrain-mcp (src/http.js, port
127.0.0.1:3005), reverse-proxy nginx location /mcp dans le vhost_nginx.conf
de leparrain.com. Process séparé : aucun code ni base du Parrain.
Option B — Local (stdio)
Claude Desktop — claude_desktop_config.json :
{
"mcpServers": {
"leparrain": {
"command": "node",
"args": ["/chemin/absolu/vers/leparrain-mcp/src/server.js"],
"env": { "LP_DATA_MODE": "sample", "LP_USER": "" }
}
}
}Inspecteur officiel (pour tester visuellement) :
npm run inspectStructure
src/
server.js # serveur MCP : branche les tools sur le protocole (stdio)
core.js # logique métier pure des tools (testable)
resolver.js # chaîne de résolution du lien + tirage pondéré
data.js # dataset d'exemple (remplacé par l'API en couche 2)
flavor.js # la voix du Parrain (clins d'œil The Mask)
test/smoke.js # tests de la logique pure
landing/ # landing page de présentationSécurité
.envest gitignored. Ne commitez jamais de clé.En production (couche 2), le serveur tape l'API publique de leparrain.com via
LP_API_KEY(fournie à l'exécution) — jamais d'accès base direct, jamais de source du Parrain dans ce repo.
— Ssssplendide !
Available Tools
4 toolsget_programDétail d'un programmeA
Renvoie le détail d'un programme de parrainage (description + lien de parrainage résolu pour vous).
Inputs: slug (required).
search_blogChercher dans le blogA
Cherche dans les articles du blog Le Parrain (conseils, comparatifs, bons plans parrainage) et renvoie les programmes liés. Utile pour des questions plus larges qu'une simple recherche de programme.
Inputs: query (required).
search_programsRechercher des programmes de parrainageA
Cherche des programmes de parrainage dans l'annuaire Le Parrain. Renvoie pour chaque résultat le bon lien de parrainage (le vôtre si vous êtes connecté et l'avez publié, sinon le lien par défaut).
Inputs: query (required).
suggest_programProposer un nouveau programmeA
Propose un programme de parrainage absent de l'annuaire. La proposition passe en modération (vérification humaine) avant toute publication — aucune mise en ligne automatique.
Inputs: name (required), url, category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct action: retrieving program details, searching blog articles, searching programs, and suggesting missing programs. There is no overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (get_program, search_blog, search_programs, suggest_program), making them predictable and easy to distinguish.
With 4 tools, the set is tightly scoped to the core functionality of a referral program directory: discovering, detailing, and suggesting programs, plus supporting blog content. No tool feels extraneous or missing.
The set covers the main use cases: program search, detail retrieval, blog advice, and program suggestions. Lacks explicit update or delete actions, but those may be out of scope for a directory service.
Maintenance
Related MCP Connectors
Unofficial read-only MCP server for VeryChic hotel offers
Public MCP server for discovering open jobs. Search, filter, and get application links.
Publish and discover MCP servers via the official MCP Registry. Powered by HAPI MCP server.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Datagouv APIs, primarily allowing users to search for up-to-date information about companies registered in France.11-
- AlicenseBqualityDmaintenanceA MCP server for retrieving backlink information for any domain(SEO).461 PyPI259MIT
- AlicenseBqualityFmaintenanceA Python MCP server that allows programmatic interaction to find torrents programmatically on YggTorrent and La Cale.42MIT
- FlicenseNot gradedqualityDmaintenanceTurn any website into a standalone MCP server.-