{
  "markdown": "# payotte-mcp\n\nServeur **MCP** (Model Context Protocol) de Payotte — le premier annuaire immobilier canadien\nde professionnels **vérifiés** branché dans les IA.\n\n- **Hébergement** : Cloudflare Workers, palier gratuit (100 000 requêtes/jour).\n- **Zéro état, zéro maintenance** : le worker lit en direct les feeds statiques de payotte.com\n  (`/api/experts.json`, `/api/regulators.json`, `/api/market.json`), régénérés à chaque\n  déploiement normal du site. Rien à mettre à jour ici quand les fiches changent.\n- **Transport** : Streamable HTTP sans état (POST JSON-RPC sur `/mcp`). Aucune dépendance.\n\n## Les 8 outils\n\n| Outil | Ce qu'il fait |\n|---|---|\n| `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. |\n| `verifier_titre` | Qui régule ce métier dans cette province, et où vérifier le permis (matrice du pilier licence). |\n| `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). |\n| `taux_courants` | Taux canadiens en direct à la Banque du Canada (directeur, préférentiel, hypothécaires moyens), décisions récentes et prochaines annonces. |\n| `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. |\n| `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). |\n| `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). |\n| `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. |\n\nChaque réponse porte l'attribution **CC BY 4.0** (citer + lier payotte.com).\n\n## Prérequis (une fois, ~10 min)\n\n1. **Compte Cloudflare gratuit** : https://dash.cloudflare.com/sign-up (obligatoire pour déployer).\n2. **Compte GitHub gratuit** (recommandé, pour lister le serveur dans les registres MCP → backlinks).\n\n## Déployer\n\n```bash\ncd ~/Desktop/payotte-mcp\nnpm install                 # une fois\nnpx wrangler login          # ouvre le navigateur, se connecter au compte Cloudflare\nnpm run deploy              # → https://payotte-mcp.<sous-domaine>.workers.dev\n```\n\n⚠️ **Déployer d'abord le site payotte.com** (build du 23 juillet ou plus récent) : les feeds\n`/api/regulators.json` et `/api/market.json` dont dépendent `verifier_titre` et `stats_marche`\nsont dans ce build. (`/api/experts.json` est déjà en ligne.)\n\nL'URL MCP à donner aux clients (Claude, etc.) : `https://payotte-mcp.<sous-domaine>.workers.dev/mcp`\n\n## Tester en local (sans compte)\n\n```bash\nnpm run dev                 # http://localhost:8787\ncurl -s localhost:8787/     # carte de visite du serveur\ncurl -s localhost:8787/mcp -H 'Content-Type: application/json' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"trouver_expert\",\"arguments\":{\"profession\":\"courtier immobilier\",\"ville\":\"Montréal\"}}}'\n```\n\n## Brancher dans Claude\n\n- **Claude Code** : `claude mcp add --transport http payotte https://payotte-mcp.<sous-domaine>.workers.dev/mcp`\n- **claude.ai** (Connecteurs) : Paramètres → Connecteurs → Ajouter un connecteur personnalisé → coller l'URL `/mcp`.\n\n## Activer le relais de contact (contacter_expert)\n\nSans configuration, l'outil tourne en **mode répétition** (réponse simulée, aucun envoi). Pour l'activer :\n\n1. **Côté site** : le fichier privé `/api/cx/{jeton}.json` doit être déployé (jeton dans\n   `payotte-astro/src/lib/contactsToken.ts` — NE JAMAIS lier cette URL). Secret Cloudflare\n   correspondant : `CONTACTS_TOKEN` (déjà posé).\n2. **Compte Resend gratuit** (100 courriels/jour) : https://resend.com → ajouter le domaine\n   `payotte.com` → poser les enregistrements DNS proposés (chez GoDaddy) → créer une clé API.\n3. `printf 'LA_CLE' | npx wrangler secret put RESEND_API_KEY` puis c'est actif — aucun redéploiement requis.\n\nAdresse d'expédition : `MAIL_FROM` dans wrangler.toml (défaut `Payotte <relais@payotte.com>`).\n\n## Après le déploiement (l'antenne)\n\n1. Lister le serveur dans le **registre MCP officiel** (via GitHub) + annuaires communautaires\n   → backlinks tech + découvrabilité par les agents.\n2. Angle RP : « premier annuaire immobilier canadien branché dans les IA ».\n",
  "bytes": 4962,
  "sha": "e593afc4d79d20635c60846c2befe42db91b27d1abba5f70e5c5ee8e2bee1080",
  "repo_slug": "payotte-com/payotte-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_payotte_com_payotte_mcp_16585140/readme"
}