payotte-mcp

payotte-mcp

Payotte 的 MCP（Model Context Protocol）服务——将加拿大已验证房地产专业人士名录接入 AI，并提供 10 个国家（加拿大、法国、美国、英国、澳大利亚、印度、巴西、墨西哥、西班牙、比利时）的房地产数据。

• 托管：Cloudflare Workers，免费套餐（每天 100 000 次请求）。
• 零状态、零维护：Worker 直接读取 payotte.com 的静态数据源（/api/experts.json、/api/regulators.json、/api/market.json），这些数据源会在网站每次常规部署时重新生成。专家资料变更时，无需在此处更新任何内容。
• 传输方式：无状态 Streamable HTTP（向 /mcp 发送 POST JSON-RPC）。无任何依赖。

75 个工具

列表由 tools/list 生成（版本 1.14.0）。加拿大提供专家资料；其他国家则展示 payotte.com 对应版块中的法规、税费、费用和价格。

加拿大 (14)

工具	标题
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	评估下调可节省的税费 / 评估下调可节省的税费（魁北克）

法国 (4)

工具	标题
frais_notaire_fr	法国公证费 / 法国公证费
stats_marche_fr	法国 DVF 房产价格 / 法国房产价格（DVF）
trouver_professionnel_fr	在法国查找专业机构 / 查找法国房地产公司
verifier_titre_fr	验证法国专业人士的资质 / 核查法国专业人士的资质

美国 / 美国 (16)

工具	标题
transfer_tax_us	按州查询美国房地产转让税
property_tax_us	按州查询美国房产税
property_tax_appeal_us	按州查询美国房产税申诉截止日期
attorney_at_closing_us	交割时是否必须由律师参与？（美国，按州）
foreclosure_us	按州查询美国止赎流程
seller_disclosure_us	按州查询美国卖方信息披露法
closing_costs_us	按州查询美国交割费用（法律规定的项目）
first_time_buyer_programs_us	按州查询美国首次购房者计划
home_prices_us	按州和主要城市查询美国房屋中位价值
community_property_us	美国夫妻共同财产州
title_insurance_us	按州查询美国产权保险费率
natural_hazards_us	按州查询美国自然灾害和房屋保险
verify_license_us	验证美国房地产专业人士的执照
compare_states_us	根据一项规则比较美国 50 个州
state_overview_us	在美国某州买房：关键信息
federal_guide_us	美国联邦购房指南

英国 / United Kingdom (5)

工具	标题
purchase_tax_uk	在英国购买房屋的购置税：SDLT、LBTT 或 LTT
house_prices_uk	英国平均房价（英国房价指数）
compare_nations_uk	英国四个构成国的房产规则比较
guide_uk	Payotte 英国指南：购买、租赁和拥有房屋
check_professional_uk	谁监管英国房产专业人士，以及在哪里查询

澳大利亚 / Australia (5)

工具	标题
purchase_duty_au	澳大利亚各州的房屋转让税（印花税）
house_prices_au	澳大利亚住宅价格（ABS）
compare_states_au	澳大利亚各州房产规则比较
guide_au	Payotte 澳大利亚指南：购买、租赁和拥有房屋
check_professional_au	谁监管澳大利亚房产专业人士，以及在哪里查询

印度 / India (6)

工具	标题
stamp_duty_in	印度各州的房屋印花税和登记费用
home_loan_emi_in	印度住房贷款 EMI
house_prices_in	印度房价指数（RBI、NHB RESIDEX）
compare_states_in	印度各州房产规则比较
guide_in	Payotte 印度指南：购买、非居民印度人（NRI）、租赁和拥有房屋
check_professional_in	谁监管印度房产专业人士，以及在哪里查询

巴西 / Brazil (6)

工具	标题
purchase_costs_br	巴西房屋购置成本：ITBI、公证契据、登记
mortgage_payment_br	巴西抵押贷款还款额：SAC 和 Price
capital_gains_tax_br	在巴西出售房屋的资本利得税
compare_states_br	巴西各州房产成本和数据比较
guide_br	Payotte 巴西指南：外国买家、购买、融资、出售、租赁、拥有房屋
check_professional_br	谁监管巴西房产专业人士，以及在哪里查询

墨西哥 / Mexico (6)

工具	标题
closing_costs_mx	墨西哥各市镇的房产购置税和登记费
mortgage_payment_mx	墨西哥固定利率抵押贷款还款额
home_prices_mx	墨西哥房屋估价和房价指数（SHF）
compare_states_mx	墨西哥各州房产规则和数据比较
guide_mx	Payotte 墨西哥指南：外国买家、购买、出售、租赁
check_professional_mx	谁监管墨西哥房产专业人士，以及在哪里查询

西班牙 / Spain (7)

工具	标题
purchase_costs_es	西班牙各地区的房屋购置税和费用
mortgage_payment_es	西班牙抵押贷款月供
non_resident_tax_es	西班牙非居民未出租房屋的税费
house_prices_es	西班牙各城市和地区的房屋价值
compare_regions_es	西班牙各地区房产规则比较
guide_es	Payotte 西班牙指南：外国人购房、税费、租赁和拥有房屋
check_professional_es	谁监管西班牙房产专业人士，以及在哪里查询

比利时 / Belgium (6)

工具	标题
purchase_costs_be	比利时房屋购置成本：登记税、公证费及其他费用
borrowing_capacity_be	比利时借款能力和最高房价
house_prices_be	比利时房屋和公寓价格（Statbel 中位数）
compare_regions_be	比利时三个大区的购置成本和房价比较
guide_be	Payotte 比利时指南：购买、融资、出售、租赁和拥有房屋（FR、NL、EN）
check_professional_be	谁监管比利时房产专业人士，以及在哪里查询

每个回答均采用 CC BY 4.0 许可（注明出处并链接至 payotte.com）。

前提条件（一次性，约 10 分钟）

1. 免费 Cloudflare 账号：https://dash.cloudflare.com/sign-up（部署必需）。
2. 免费 GitHub 账号（推荐，用于在 MCP 注册表中列出服务 → 获得反向链接）。

部署

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

⚠️ 先部署 payotte.com 网站（7 月 23 日或之后的构建版本）：verifier_titre 和 stats_marche 所依赖的 feed /api/regulators.json 和 /api/market.json 都包含在该构建版本中。（/api/experts.json 已上线。）

提供给客户端（Claude 等）的 MCP URL：https://payotte-mcp.<sous-domaine>.workers.dev/mcp

在本地测试（无需账号）

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"}}}'

接入 Claude

• Claude Code：claude mcp add --transport http payotte https://payotte-mcp.<sous-domaine>.workers.dev/mcp
• claude.ai（连接器）：设置 → 连接器 → 添加自定义连接器 → 粘贴 /mcp URL。

启用联系中继（contacter_expert）

未配置时，该工具会运行在模拟模式（模拟回复，不会发送任何内容）。要启用：

1. 网站端：必须部署私有文件 /api/cx/{jeton}.json（令牌位于 payotte-astro/src/lib/contactsToken.ts 中——切勿链接到此 URL）。对应的 Cloudflare 密钥： CONTACTS_TOKEN（已设置）。
2. 免费 Resend 账号（每天 100 封邮件）：https://resend.com → 添加域名 payotte.com → 设置提供的 DNS 记录（在 GoDaddy）→ 创建 API 密钥。
3. 执行 printf 'LA_CLE' | npx wrangler secret put RESEND_API_KEY 后即可启用——无需重新部署。

发件地址：wrangler.toml 中的 MAIL_FROM（默认为 Payotte <[email protected]>）。

部署后（后续推广）

1. 通过 GitHub 将服务列入官方 MCP 注册表，并加入社区目录 → 获得技术领域的反向链接 + 提高 Agent 的可发现性。
2. 公关角度：“首个接入 AI 的加拿大房地产目录”。