io.github.Payotte-com/payotte-mcp (MCP Server)

This MCP server connects verified Canadian real-estate professionals and housing data to Model Context Protocol clients. It provides information such as prices, rates, land-transfer tax, and rent-vs-buy, using data sourced from payotte.com.

🛠️ Key Features

Serves an MCP endpoint via Streamable HTTP.
Exposes JSON-RPC over HTTP POST at /mcp.
Stateless transport with “zero state, zero maintenance.”
Reads static feeds from payotte.com at /api/experts.json, /api/regulators.json, and /api/market.json.
Regenerates those feeds at each normal site deployment.

🚀 Use Cases

Retrieve verified real-estate professionals in Canada.
Access housing market details including prices and rates.
Support queries related to land-transfer tax and rent-vs-buy comparisons.

⚡ Developer Benefits

Zero maintenance: no updates required when fiches change.
No dependencies.
Runs on Cloudflare Workers with a free tier noted as 100,000 requests/day.

⚠️ Limitations

Tooling details beyond “toolCount: 8” are not specified in the provided data.

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

bash

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)

bash

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}.json doit être déployé (jeton dans payotte-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_KEY puis 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 ».

province	string	required	Province name or code (QC, NS, NB, AB, MB).
municipalite	string	required	Municipality as named in the roll, e.g. "Laval", "Halifax Regional Municipality", "Calgary", "Winnipeg".
adresse	string	required	Civic address, number first, e.g. "9060 boul. Lévesque E" or "1200 rue Saint-Alexandre, app. 305".
lang	string	optional

province	string	required
municipalite	string	optional
adresse	string	optional
prix	number	required	Purchase price in CAD.
lang	string	optional

province	string	required
municipalite	string	optional
adresse	string	optional
annee	number	optional	Construction year, if no address or if the roll lacks it.
lang	string	optional

profession	string	optional	One of: real-estate-broker \| mortgage-broker \| home-inspector \| notary-lawyer \| appraiser (French labels accepted: courtier immobilier, courtier hypothécaire, inspecteur en bâtiment, notaire, évaluateur). Omit to get every profession.
ville	string	optional	City, e.g. "Montréal", "Toronto", "Calgary".
secteur	string	optional	Neighbourhood/sector, e.g. "Le Plateau-Mont-Royal", "Ville-Marie".
province	string	optional	Province name or code, e.g. "Québec", "ON", "british-columbia".

profession	string	required	real-estate-broker \| mortgage-broker \| home-inspector \| notary-lawyer \| appraiser (French labels accepted).
province	string	optional	Province name or code. Omit to get every province for that profession.

io.github.Payotte-com/payotte-mcp

io.github.Payotte-com/payotte-mcp (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

evaluation_adresse

taxe_bienvenue_adresse

risques_annee_construction

trouver_expert

verifier_titre

stats_marche

taux_courants

taxe_mutation

acheter_ou_louer

salaire_requis

contacter_expert

fenetre_revision

frais_revision

estimer_economie