payotte-mcp
Serveur MCP (Model Context Protocol) de Payotte — le premier annuaire immobilier canadien de professionnels vérifiés branché dans les IA.
- Hébergement : Cloudflare Workers, palier gratuit (100 000 requêtes/jour).
- Zéro état, zéro maintenance : le worker lit en direct les feeds statiques de payotte.com
(
/api/experts.json,/api/regulators.json,/api/market.json), régénérés à chaque déploiement normal du site. Rien à mettre à jour ici quand les fiches changent. - Transport : Streamable HTTP sans état (POST JSON-RPC sur
/mcp). Aucune dépendance.
Les 8 outils
| Outil | Ce qu'il fait |
|---|---|
trouver_expert | L'expert vérifié Payotte pour une ville/secteur × métier (score /100, n° de permis + lien registre, URL de la fiche). FR/EN. |
verifier_titre | Qui régule ce métier dans cette province, et où vérifier le permis (matrice du pilier licence). |
stats_marche | Chiffres du marché par ville (prix repère/médian, variation annuelle, ventes, inventaire, DOM) + verdict acheteurs/équilibré/vendeurs (convention < 4 / 4-6 / > 6 mois). |
taux_courants | Taux canadiens en direct à la Banque du Canada (directeur, préférentiel, hypothécaires moyens), décisions récentes et prochaines annonces. |
taxe_mutation | La taxe de mutation calculée par tranches aux barèmes OFFICIELS (validés à la source) — ON + double MLTT de Toronto, QC (grille de base, majoration municipale signalée), BC, MB, N.-B., Halifax ; AB/SK = frais d'enregistrement seulement. Prix fourni ou prix de référence de la ville. Î.-P.-É./T.-N. : refus honnête. |
acheter_ou_louer | Louer vs acheter dans une ville : loyer 2 chambres SCHL vs coût de possession au taux fixe 5 ans COURANT (hypothèses publiées, double lecture cash/économique — même méthode que le dossier du site). |
salaire_requis | Le revenu ménage requis pour se qualifier sur la propriété de référence de la ville, au test de résistance fédéral en vigueur (même méthode que le dossier salaire/ville). |
contacter_expert | Le rail agentique : relaie la demande de contact d'un client (via son assistant IA, avec consentement explicite) au pro vérifié, par courriel (Reply-To = le client). Payotte ne conserve RIEN du contenu — compteurs agrégés seulement (KV), même philosophie que lead.php. Plafonds : 40/jour global, 3/jour/expert. |
Chaque réponse porte l'attribution CC BY 4.0 (citer + lier payotte.com).
Prérequis (une fois, ~10 min)
- Compte Cloudflare gratuit : https://dash.cloudflare.com/sign-up (obligatoire pour déployer).
- Compte GitHub gratuit (recommandé, pour lister le serveur dans les registres MCP → backlinks).
Déployer
cd ~/Desktop/payotte-mcp
npm install # une fois
npx wrangler login # ouvre le navigateur, se connecter au compte Cloudflare
npm run deploy # → https://payotte-mcp.<sous-domaine>.workers.dev
⚠️ Déployer d'abord le site payotte.com (build du 23 juillet ou plus récent) : les feeds
/api/regulators.json et /api/market.json dont dépendent verifier_titre et stats_marche
sont dans ce build. (/api/experts.json est déjà en ligne.)
L'URL MCP à donner aux clients (Claude, etc.) : https://payotte-mcp.<sous-domaine>.workers.dev/mcp
Tester en local (sans compte)
npm run dev # http://localhost:8787
curl -s localhost:8787/ # carte de visite du serveur
curl -s localhost:8787/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"trouver_expert","arguments":{"profession":"courtier immobilier","ville":"Montréal"}}}'
Brancher dans Claude
- Claude Code :
claude mcp add --transport http payotte https://payotte-mcp.<sous-domaine>.workers.dev/mcp - claude.ai (Connecteurs) : Paramètres → Connecteurs → Ajouter un connecteur personnalisé → coller l'URL
/mcp.
Activer le relais de contact (contacter_expert)
Sans configuration, l'outil tourne en mode répétition (réponse simulée, aucun envoi). Pour l'activer :
- Côté site : le fichier privé
/api/cx/{jeton}.jsondoit être déployé (jeton danspayotte-astro/src/lib/contactsToken.ts— NE JAMAIS lier cette URL). Secret Cloudflare correspondant :CONTACTS_TOKEN(déjà posé). - Compte Resend gratuit (100 courriels/jour) : https://resend.com → ajouter le domaine
payotte.com→ poser les enregistrements DNS proposés (chez GoDaddy) → créer une clé API. printf 'LA_CLE' | npx wrangler secret put RESEND_API_KEYpuis c'est actif — aucun redéploiement requis.
Adresse d'expédition : MAIL_FROM dans wrangler.toml (défaut Payotte <relais@payotte.com>).
Après le déploiement (l'antenne)
- Lister le serveur dans le registre MCP officiel (via GitHub) + annuaires communautaires → backlinks tech + découvrabilité par les agents.
- Angle RP : « premier annuaire immobilier canadien branché dans les IA ».