public-tools

FairePlace — 公共 MCP 服务 🏠🇫🇷

一个公开、无需身份验证的远程 MCP 服务，向 AI Agent（ChatGPT、Claude、Perplexity、Cursor……）提供 FairePlace 的免费法国住宅租赁工具：创建并电子签署租约（bail）、检查租金管制、调整租金（IRL）、计算押金或租赁收益率、获取地址风险报告，并生成租赁文件（租金收据、房屋状况清单、通知等）。

服务端零大模型推理。 该服务是 FairePlace 公共 API 上一个轻量、确定性的代理——调用它的 Agent 自行承担推理费用；FairePlace 仅运行 Rust/Typst 逻辑。边际成本 ≈ 0。

端点： https://mcp.faireplace.com/mcp · 注册表： com.faireplace/public-tools

---

快速开始

将远程服务添加到任意 MCP 客户端：

客户端	方法
Claude（桌面版 / claude.ai）	设置 → 连接器 → 添加自定义连接器 → https://mcp.faireplace.com/mcp
Cursor	设置 → MCP → 添加 → Streamable HTTP → https://mcp.faireplace.com/mcp
ChatGPT（自定义 GPT）	将 https://mcp.faireplace.com/openapi.json 中的 OpenAPI 导入为 Action（身份验证：无）
MCP Inspector	npx @modelcontextprotocol/inspector@latest → 连接到该 URL

无需 API 密钥，也无需账户。可以向你的 Agent 提问，例如 “检查巴黎 75001 区一套 45 m² 两居室的月租 1500 € 是否合规”，或 “为巴黎一套月租 850 € 的带家具公寓创建租约”。

工具（21 个）

数据与合规（返回 JSON）：

工具	用途
check_rent_control	查询指定地址的租金管制判定（encadrement des loyers）
get_reference_rent	查询租金管制区域的参考租金（€/m²）
simulate_irl / simulate_irl_by_quarters	按明确提供或由服务解析的 INSEE 数值，模拟年度租金调整（IRL）
calculate_deposit_restitution	押金上限、退还期限及罚金
simulate_rental_yield	总收益率/净收益率及各税制下的税额计算（LMNP、micro-foncier……）
check_address_risks	自然/技术风险报告（Géorisques）

租约创建（转化工具）：

工具	用途
create_lease_draft	创建租约草稿 → 返回链接，可在 FairePlace 上完成并电子签署（高级 eIDAS、PAdES-B-LT）

文件生成（返回可渲染 PDF 的链接）：generate_quittance、generate_etat_des_lieux、generate_conge、generate_cautionnement、generate_avenant、generate_resiliation_amiable、generate_relance_impaye、generate_inventaire_mobilier、generate_notice_information、generate_reparations_locatives、generate_grille_vetuste、generate_charges_recuperables、generate_bordereau_restitution。

租约 → 签署流程的工作方式

agent → create_lease_draft(owner, logement, lease)
      → FairePlace stores an anonymous draft, returns draft_token
      → tool returns  https://mcp.faireplace.com/r?draft_token=…
user clicks the link
      → GET /r sets the draft_token cookie on .faireplace.com, 302 → app sign-up
      → on login, FairePlace ingests the draft and opens it on the Signature step

服务绝不会返回可供签署的文件——签署流程始终在 FairePlace 的身份验证之后进行。每个链接都带有 utm_source=mcp，用于归因跟踪。

架构

有意设计为轻量适配器，而非领域应用。所有业务逻辑（租金管制数据、IRL 指数、法律文档渲染）都在 FairePlace 的 Rust 后端中；此 Worker 仅将 MCP 工具调用映射到公开的 /public/tools/* HTTP 端点并格式化结果。

• **运行时：**Cloudflare Worker（McpAgent，使用 Durable Object 存储会话状态）。
• **传输：**在 /mcp 上使用 Streamable HTTP。
• **防护机制：**原生的按 IP 限流（100 次请求 / 60 秒）。
• PDF 交付：/pdf/<slug>?p=<base64url payload> 会提供一个 HTML 页面，由该页面在浏览器端获取 PDF（避免同一区域内的 Worker→源站请求受阻；不存储 PDF，PDF 是本地 blob）。

端点

路径	用途
/mcp	MCP 服务（Streamable HTTP）
/openapi.json	面向 GPT Actions 的精选 OpenAPI 3.1
/.well-known/ai-plugin.json	插件清单
/llms.txt	被动 AI 发现
/r	恢复草稿 → 设置 Cookie → 注册
/pdf/<slug>	按需渲染 PDF（浏览器端）

开发

npm install
npm run typecheck
npm run dev            # wrangler dev (local)
npm run inspect        # MCP Inspector
npm run deploy         # wrangler deploy (needs Cloudflare auth)

配置位于 wrangler.jsonc（vars：API_BASE、WEB_BASE、SELF_BASE、DRAFT_REPRISE_URL、APP_SIGNUP_URL）。

可发现性

• 官方 MCP Registry：com.faireplace/public-tools
• Glama：连接器 com.faireplace/public-tools

许可证

MIT © 2026 FairePlace（Thinkylab SAS）。不构成法律建议，仅为法国租赁工作流提供辅助。