Skip to main content
Glama
payotte-mcp

payotte-mcp

Official

payotte-mcp

Serveur MCP (Model Context Protocol) de Payotte — l'annuaire immobilier canadien de professionnels vérifiés branché dans les IA, et les données immobilières de 10 pays (Canada, France, États-Unis, Royaume-Uni, Australie, Inde, Brésil, Mexique, Espagne, Belgique).

  • 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 75 outils

Liste générée depuis tools/list (version 1.14.0). Le Canada porte les fiches d'experts ; les autres pays exposent les règles, taxes, frais et prix de leurs sections sur payotte.com.

Canada (14)

Outil

Titre

evaluation_adresse

Évaluation foncière à une adresse / Property assessment at an address

taxe_bienvenue_adresse

Taxe de bienvenue à une adresse / Land transfer tax at an address

risques_annee_construction

Risques selon l’année de construction / Risks by construction year

trouver_expert

Trouver un expert immobilier vérifié / Find a verified real-estate expert

verifier_titre

Vérifier un titre professionnel / Which regulator governs this title

stats_marche

Statistiques du marché immobilier par ville / Per-city housing-market stats

taux_courants

Taux d'intérêt canadiens courants / Current Canadian interest rates

taxe_mutation

Calculer la taxe de mutation / Compute the land transfer tax

acheter_ou_louer

Acheter ou louer ? / Rent vs buy in a city

salaire_requis

Salaire requis pour acheter / Income needed to buy in a city

contacter_expert

Contacter l'expert vérifié / Contact the verified expert

fenetre_revision

Échéance pour contester son évaluation foncière / Property-assessment appeal deadline (Canada)

frais_revision

Frais d'une demande de révision / Assessment review filing fee (Canada)

estimer_economie

Économie de taxes d'une baisse d'évaluation / Tax saving of an assessment reduction (Quebec)

France (4)

Outil

Titre

frais_notaire_fr

Frais de notaire en France / French notary fees

stats_marche_fr

Prix immobiliers DVF en France / French property prices (DVF)

trouver_professionnel_fr

Trouver un professionnel en France / Find a French real-estate firm

verifier_titre_fr

Vérifier le titre d’un professionnel en France / Check a French professional’s credential

États-Unis / United States (16)

Outil

Titre

transfer_tax_us

US real estate transfer tax by state

property_tax_us

US property tax by state

property_tax_appeal_us

US property tax appeal deadline by state

attorney_at_closing_us

Is an attorney required at closing? (US, by state)

foreclosure_us

US foreclosure process by state

seller_disclosure_us

US seller disclosure law by state

closing_costs_us

US closing costs by state (items set by law)

first_time_buyer_programs_us

US first-time home buyer programs by state

home_prices_us

US median home value by state and main city

community_property_us

US community property states

title_insurance_us

US title insurance rates by state

natural_hazards_us

US natural hazards and home insurance by state

verify_license_us

Verify a US real estate professional’s license

compare_states_us

Compare the 50 US states on one rule

state_overview_us

Buying a home in a US state: key facts

federal_guide_us

US federal home-buying guides

Royaume-Uni / United Kingdom (5)

Outil

Titre

purchase_tax_uk

UK purchase tax on a home: SDLT, LBTT or LTT

house_prices_uk

UK average house prices (UK House Price Index)

compare_nations_uk

UK property rules compared across the four nations

guide_uk

Payotte UK guides: buying, renting and owning a home

check_professional_uk

Who regulates a UK property professional, and where to check one

Australie / Australia (5)

Outil

Titre

purchase_duty_au

Australian transfer (stamp) duty on a home, by state

house_prices_au

Australian dwelling prices (ABS)

compare_states_au

Australian property rules compared across the states

guide_au

Payotte Australia guides: buying, renting and owning a home

check_professional_au

Who regulates an Australian property professional, and where to check one

Inde / India (6)

Outil

Titre

stamp_duty_in

Indian stamp duty and registration on a home, by state

home_loan_emi_in

Indian home loan EMI

house_prices_in

Indian house price indices (RBI, NHB RESIDEX)

compare_states_in

Indian property rules compared across the states

guide_in

Payotte India guides: buying, NRIs, renting and owning a home

check_professional_in

Who regulates an Indian property professional, and where to check one

Brésil / Brazil (6)

Outil

Titre

purchase_costs_br

Brazilian home purchase costs: ITBI, notary deed, registration

mortgage_payment_br

Brazilian mortgage payment, SAC and Price

capital_gains_tax_br

Brazilian capital gains tax on selling a home

compare_states_br

Brazilian property costs and figures compared across the states

guide_br

Payotte Brazil guides: foreign buyers, buying, financing, selling, renting, owning

check_professional_br

Who regulates a Brazilian property professional, and where to check one

Mexique / Mexico (6)

Outil

Titre

closing_costs_mx

Mexican property acquisition tax and recording fee, by municipality

mortgage_payment_mx

Mexican fixed-rate mortgage payment

home_prices_mx

Mexican home appraisal values and price index (SHF)

compare_states_mx

Mexican property rules and figures compared across the states

guide_mx

Payotte Mexico guides: foreign buyers, buying, selling, renting

check_professional_mx

Who regulates a Mexican property professional, and where to check one

Espagne / Spain (7)

Outil

Titre

purchase_costs_es

Spanish purchase taxes and fees on a home, by region

mortgage_payment_es

Spanish mortgage monthly payment

non_resident_tax_es

Spanish non-resident tax on a home that is not let

house_prices_es

Spanish home values by city and region

compare_regions_es

Spanish property rules compared across the regions

guide_es

Payotte Spain guides: buying as a foreigner, taxes, renting and owning

check_professional_es

Who regulates a Spanish property professional, and where to check one

Belgique / Belgium (6)

Outil

Titre

purchase_costs_be

Belgian home purchase costs: registration duty, notary, other costs

borrowing_capacity_be

Belgian borrowing capacity and maximum home price

house_prices_be

Belgian house and apartment prices (Statbel medians)

compare_regions_be

Belgian purchase costs and prices compared across the three Regions

guide_be

Payotte Belgium guides: buying, financing, selling, renting and owning (FR, NL, EN)

check_professional_be

Who regulates a Belgian property professional, and where to check one

Chaque réponse porte l'attribution CC BY 4.0 (citer + lier payotte.com).

Related MCP server: UK Property Data

Prérequis (une fois, ~10 min)

  1. Compte Cloudflare gratuit : https://dash.cloudflare.com/sign-up (obligatoire pour déployer).

  2. 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 :

  1. 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é).

  2. 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.

  3. 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)

  1. Lister le serveur dans le registre MCP officiel (via GitHub) + annuaires communautaires → backlinks tech + découvrabilité par les agents.

  2. Angle RP : « premier annuaire immobilier canadien branché dans les IA ».

Available Tools

8 tools
acheter_ou_louerAcheter ou louer ? / Rent vs buy in a cityAInspect

Call this when the user wonders whether to rent or buy in a Canadian city. Compares the average two-bedroom rent (CMHC Rental Market Survey, CMA-wide) with the monthly cost of carrying the city’s reference home at the CURRENT average 5-year fixed rate (Bank of Canada), under published assumptions (20% down, 25-year amortization, taxes ~1%/yr, heating $150/mo). Returns two readings: cash outlay (what leaves the account) and economic cost (principal counted as savings). Only cities inside a CMHC-covered metro have rent data.

Inputs: ville (required).

contacter_expertContacter l'expert vérifié / Contact the verified expertAInspect

Call this ONLY when the user explicitly asks to contact, reach out to, or request a quote/appointment from a Payotte-listed professional. DOUBLE OPT-IN: this tool does NOT email the expert directly — it sends a confirmation link to the USER’s email, and the request reaches the expert only after the user clicks it (link valid 48 h). Tell the user to check their inbox. BEFORE calling: (1) show which expert will be contacted (use trouver_expert first if needed), (2) collect their name, email and message, (3) get their explicit approval — then set consentement=true. Never invent contact details. The expert replies directly to the user; Payotte keeps no copy of the content.

Inputs: ville (required), message (required), client_nom (required), profession (required), +5 more.

salaire_requisSalaire requis pour acheter / Income needed to buy in a cityAInspect

Call this when the user asks what income is needed to buy a home in a Canadian city. Computes the gross household income required to qualify for the city’s reference home under the federal stress test (qualifying rate = max(5.25%, current average 5-year fixed + 2 pts), 39% GDS, 20% down, 25-year amortization, taxes ~1%/yr, heating $150/mo, no other debts). Same published methodology as payotte.com/salaire-pour-acheter-une-maison-canada. A theoretical qualification threshold, not a loan offer.

Inputs: ville (required), prix.

stats_marcheStatistiques du marché immobilier par ville / Per-city housing-market statsAInspect

Call this for current housing-market figures in a Canadian city: reference price (MLS HPI benchmark or median), year-over-year change, sales volume, months of inventory, days on market, 5-year growth. Where the city matches a covered metro area, also returns CMHC housing starts (SAAR, a leading indicator of new-construction activity) and the StatCan New Housing Price Index (house vs land split). Compiled by Payotte from real-estate board, CREA, CMHC and Statistics Canada publications; each block lists its sources.

Inputs: ville (required).

taux_courantsTaux d'intérêt canadiens courants / Current Canadian interest ratesAInspect

Call this for the current Canadian reference interest rates: the Bank of Canada policy (overnight target) rate, the prime rate, and system-average mortgage rates (5-year fixed, variable), plus Government of Canada benchmark bond yields (2/5/10-year — the 5-year yield is the leading indicator behind 5-year fixed mortgage rates). Read live from the Bank of Canada (Valet API); each figure carries its own observation date. Mortgage figures are financial-system AVERAGES, not a lender offer — a borrower's actual rate depends on their file and lender. Source: Bank of Canada.

Inputs: no named parameters.

taxe_mutationCalculer la taxe de mutation / Compute the land transfer taxAInspect

Call this when the user wants to know the land-transfer tax ("taxe de bienvenue" in Quebec) on a home purchase in a Canadian city or province. Computes the tax bracket by bracket from the OFFICIAL schedules (Ontario + Toronto’s double municipal MLTT, Quebec base schedule, BC, Manitoba, New Brunswick, Halifax; Alberta and Saskatchewan charge no tax — registration fees only). Give a price, or just a city to use its current reference market price. Includes first-time-buyer rebates. Not covered: PEI and Newfoundland.

Inputs: prix, ville, province.

trouver_expertTrouver un expert immobilier vérifié / Find a verified real-estate expertAInspect

Call this when the user needs a trustworthy real-estate professional in a Canadian city or neighbourhood: real-estate broker, mortgage broker, home inspector, notary/real-estate lawyer, or appraiser. Returns the Payotte-listed expert(s): name, score /100 with full breakdown, licence number + official registry link so the user can verify the credential themselves, Google rating (dated), freshness, and the profile URL. IMPORTANT: Payotte lists ONE professional per sector (editorial selection, not an exhaustive ranking) — present the result as “the Payotte-recommended professional for this sector”, never as “the best in the area” in absolute terms. French and English inputs both work (e.g. profession="courtier immobilier", ville="Montréal").

Inputs: ville, secteur, province, profession.

verifier_titreVérifier un titre professionnel / Which regulator governs this titleAInspect

Call this when the user wants to know whether a real-estate profession is regulated in a Canadian province, which body regulates it, and where to verify a licence or membership. Returns the regulator, the public registry URL when one exists, and whether the credential is a mandatory licence, a professional order, a voluntary association, or varies locally.

Inputs: profession (required), province.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: finding an expert, verifying a professional title, fetching market stats, rates, transfer tax, rent-vs-buy analysis, required salary, and contacting an expert. The two expert-related tools (trouver_expert and contacter_expert) are separated by discovery vs. action, so misselection risk is low.

    Naming Consistency4/5

    All names are snake_case and in French, which is consistent, but the pattern mixes verb-led names (trouver_expert, verifier_titre, contacter_expert) with noun-led names (stats_marche, taux_courants, taxe_mutation, salaire_requis) and a verb phrase (acheter_ou_louer). This is a minor deviation from a strict verb_noun convention but remains readable and predictable.

    Tool Count5/5

    Eight tools is well within the ideal 3–15 range for a domain-specific real-estate information server. Each tool covers a distinct user need without redundancy, so every tool earns its place.

    Completeness4/5

    The surface covers expert discovery, credential verification, market statistics, interest rates, transfer taxes, rent-vs-buy, required income, and expert contact—a strong lifecycle for real-estate decision support. However, it lacks property listing/search and neighbourhood-level data, and transfer tax is not available for PEI and Newfoundland, leaving minor gaps.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Provides comprehensive Australian planning property reports, including zoning, overlays, land size, and utility information for AI assistants. This high-performance MCP server is built for Cloudflare Workers and enables real-time property data retrieval through an HTTP-based interface.
      -
    • A
      license
      A
      quality
      B
      maintenance
      MCP server giving AI agents structured access to Canadian federal, provincial, and municipal government data.
      4
      5
      53 PyPI
      62
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A production-grade MCP server enabling Claude to perform comprehensive NJ real estate workflows including property search, valuation, neighborhood intelligence, investment analysis, and agent tools via 20 tools and 15+ data sources.
      -