tax-retirement

Qotien — 法国税务与退休 MCP

面向法国个人税务与退休的有来源、注明日期的计算 API，通过 MCP 提供。 每个响应都包含置信度、法律依据和财政年度——引擎绝不猜测事实。

托管远程服务，通过 x402 按次付费（Base 上的 USDC）。 返回事实的功能从首次调用起计费；两个发现工具免费。无需账户，无需存储 API 密钥，也不涉及个人数据——输入是抽象数字（收入、份额、养老金积分），绝不会被存储。

连接

MCP 端点（Streamable HTTP / JSON-RPC 2.0）	https://app.qotien.fr/api/fiscal/v1/mcp
REST	POST https://app.qotien.fr/api/fiscal/v1/calculate
清单（发现、工具 + 定价）	GET https://app.qotien.fr/api/fiscal/v1/manifest
注册表	io.github.herve-coulon/tax-retirement

将其添加到任何支持远程 Streamable HTTP 服务的 MCP 客户端，并指向上述端点。首先调用 qotien_capacites（免费），即可获取工具、置信度等级和价格的机器可读目录。

为什么调用此服务，而不是自己计算

通用大模型（或代码解释器）可以做算术，但它无法可靠掌握当前准确的法国规则——2026 年的所得税税级和 décote 门槛、Agirc-Arrco 或 CARMF 养老金积分的价值、各基金的遗属养老金比例，以及今年适用的税收减免比例。它会给出一个看似自信、实则错误的数字。Qotien 保持最新、提供依据，并在每次发布时根据一手来源重新核验——适用于无法接受税务或养老金计算错误的场景（金融科技、保险科技、咨询工具、财富管理软件）。

引擎始终遵守两条规则：

• 数字绝不单独出现——每项事实都附带财政年度、法律依据和置信度。
• 计算，不猜测——缺少规则或输入时，工具会返回 non_calculable（诚实地拒绝计算），绝不编造数字，也绝不使用“平均”税率。

工具——4 个领域，38 个工具

MCP 工具名称带有领域前缀（fiscal_*、retraite_*、simulateurs_*、referentiel_*）；通过 REST 也能使用相应的裸名称访问相同功能（tmi、per_gain 等）。每个工具的等级以 [protocole]（免费）· [barème] · [étude] · [optimiseur] 的形式标注（参见“定价”）。

财税（所得税与财富税）——确定性，confiance: fiable

• fiscal_impot_revenu [税率表] — 所得税（累进税率档、家庭商数、税额减免）
• fiscal_tmi [税率表] — 边际税率
• fiscal_cehr [税率表] — 高收入特别税（可选的 rfr_n1 / rfr_n2 用于适用《税法典》第 223 sexies II-1 条规定的异常收入平滑机制）
• fiscal_prelevements_sociaux [税率表] — 按收入类型划分的社会征费税率（17.2 % 与 18.6 %）
• fiscal_surtaxe_pv_immobiliere [税率表] — 房地产资本利得附加税
• fiscal_per_plafond [税率表] — PER 扣除上限（雇员按 N-1 PASS 计算，自雇人士按 N 计算）
• fiscal_plus_value_immobiliere [研究] — 房地产资本利得（按持有期限扣减；acquisition_gratuite 适用于继承或受赠房产：仅计实际费用，不适用 7.5 % 的统一扣除；quote_part + valeur_pleine_propriete 用于按共有或拆分产权的份额完整适用 15,000 € 免税额；terrain 适用于土地：不适用 15 % 的工程费用扣除）
• fiscal_ifi [研究] — 房地产财富税（主要居所减免 30 %；可选的 75 % 收入上限，依据《税法典》第 979 条，按总收入计算：股息按扣除 40 % 优惠前金额计入，统一税率征税的收入也计入）
• fiscal_foncier_regime [研究] — 非家具出租：micro-foncier 与实际费用制度对比（家庭税额 Δ）
• fiscal_lmnp_regime [研究] — 家具出租（LMNP）：micro-BIC 与含折旧的实际制度对比（家庭税额 Δ）
• fiscal_succession [研究] — 每名子女的遗产税（第 777 条）及提前赠与的预计节税额
• fiscal_cdhr [研究] — 高收入差额税（20 % 底线 + 税额减免）
• fiscal_per_gain [研究] — PER 缴款节省的税款：总 Δ（税率档 + CEHR/CDHR），绝不可使用“缴款额 × 边际税率”
• fiscal_niches_plafond [研究] — 税收减免上限（第 200-0 A 条），适用于税额减免，并对排除项目作相应处理（捐赠：总额适用 20 % 上限，Coluche 的 2,000 € 档不计入该上限；JEI/JEIR：按 situation 设定认购上限，通过 variante: "impact" 为影响力企业适用 40 % 税率，2024-2028 年共用 50,000 € 上限，依据 jei_reductions_anterieures 计算）
• fiscal_flat_tax_vs_bareme [研究] — PFU 与累进税率对比
• fiscal_jeanbrun [研究] — Jeanbrun 出租投资折旧（《税法典》第 31 I-1° i/j 条）；传入 loyers_annuels、charges_annuelles、interets_annuels 可计算实际节税额（社会征费仅抵减至净出租收入为零，超出部分可抵扣综合收入，最高 10,700 €），否则返回带标记的理论最高值（hypothese_economie）

退休——置信度不一，绝不只给出一个数字

• retraite_ps_pension [税率表]（fiable）— 养老金税前→税后金额（CSG/CRDS/CASA + 补充部分养老金的 1 % 医疗保险）
• retraite_regimes [税率表]（fiable）— 可计算的退休制度目录（涵盖 32 种制度）
• retraite_surcote_parentale [税率表]（estime）— 育儿额外养老金加成（每季度 +1.25 %，最高 5 %）
• retraite_pension_regime [研究]（fiable）— 一种积分制退休制度的养老金，并进行合理性校验
• retraite_pension_annuites [研究]（fiable）— 一种年金制退休制度的养老金（公共部门、特殊制度）
• retraite_pension_totale [研究]（fiable）— 多种制度的合并养老金（一次调用即可计算完整职业生涯记录），税前→税后金额
• retraite_estimation [研究]（estime/partiel/non_calculable）— 根据部分数据估算养老金，并给出范围
• retraite_rachat [研究]（fiable）— 购买退休季度年限（VPLR）：费用、税后成本、收益、投资回报率
• retraite_progressive [研究]（estime）— 渐进式退休（部分养老金 + 兼职）
• retraite_optimisation [优化器]（estime）— 职业生涯后期策略排序清单（购买退休季度年限、育儿额外养老金加成、渐进式退休、最佳退休年龄、退休后继续工作、SAM、PER），并提供收益/投资回报率/置信度

模拟器（财富预测）— confiance: estime

• simulateurs_girardin [barème] · simulateurs_rente_viagere [barème]
• simulateurs_scpi · simulateurs_scpi_credit · simulateurs_demembrement_scpi · simulateurs_apport_credit · simulateurs_rentabilite_reelle · simulateurs_private_equity — 均为 [étude]

参考资料（引用带日期的事实）— confiance: sourcee

• referentiel_valeur [barème] — 一个参考值，附主要来源、法律依据和核验日期
• referentiel_recherche [barème] — 按领域／关键词搜索参考资料
• referentiel_versions [protocole] — 参考资料版本及新鲜度（免费）

元信息

• qotien_capacites [protocole] — 工具目录、可信度等级和价格（免费；请先调用）

响应约定

{
  "ok": true,
  "domaine": "retraite",
  "capability": "pension_regime",
  "confiance": "fiable",
  "result": { "...": "..." },
  "sources": ["references_officielles.json", "retraite_registre.js", "..."],
  "millesime_fiscal": "2026",
  "avertissement": "Deterministic indicative result — not personalized advice (CIF/DDA)."
}

• confiance：fiable（确定性结果，经过黄金测试）· estime/partiel（近似值，附带范围）· sourcee（带日期的参考事实）· non_calculable（诚实拒绝，而非编造数字）。
• 养老金或税额绝不会单独返回——可信度和来源会随结果一并提供。

定价 — x402

使用 Base 上的 USDC 结算（eip155:8453）。价格按成功调用计；未通过验证的调用不收费（仅在交付时结算）。

等级	价格	工具
protocole	免费	referentiel_versions、qotien_capacites
barème	$0.05	大多数 fiscal_* 税率／上限工具、retraite_ps_pension/regimes/surcote_parentale、referentiel_valeur/recherche、simulateurs_girardin/rente_viagere
étude	$0.25	专项分析：per_gain、ifi、cdhr、niches_plafond、退休养老金、SCPI/PE 模拟器……
optimiseur	$1.00	retraite_optimisation

未付款的调用会在 REST 和 MCP 上返回 HTTP 402（x402 v2）。在 MCP 上，响应正文同时包含 x402 accepts 字段和 JSON-RPC -32002 错误；无法付款的客户端会收到传输错误（调用并未执行）。没有匿名免费套餐——如需先试用再付费，请申请具名试用密钥（X-Qotien-Trial 标头，由人工签发）。应用使用另有以欧元计价的商业许可证（传统发票结算）——[email protected]。

快速开始

# List tools (free)
curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Catalog + prices (free)
curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"qotien_capacites","arguments":{}}}'

# A paid call (étude, $0.25) returns HTTP 402 with x402 payment instructions until settled.
curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"retraite_pension_regime","arguments":{"code_regime":"agirc_arrco","points":750.07}}}'

# Same call with a named trial key (evaluation, no payment): add the X-Qotien-Trial header.
curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \
  -H 'content-type: application/json' -H 'X-Qotien-Trial: <your-trial-key>' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"retraite_pension_regime","arguments":{"code_regime":"agirc_arrco","points":750.07}}}'
# → Agirc-Arrco, 750.07 points × €1.4386 (2026 service value) = €1,079/year gross (€90/month);
#   confiance: fiable · sources attached · referentiel v0.8.6 · millesime_fiscal 2026

支持 x402 的客户端（或 x402-fetch / @x402/* 库）会自动处理 402 → 签名 → 结算 → 重试流程。

协议

MCP 2025-06-18。方法：initialize、tools/list、tools/call、ping。传输方式：基于 HTTP POST 的 JSON-RPC 2.0；对于开启服务端→客户端通道的客户端，该端点还会在 GET（Accept: text/event-stream）上提供保持连接的 SSE 流。付款：x402 v2（EIP-3009 transferWithAuthorization，Base 上的 USDC）；验证和结算通过 Coinbase CDP x402 facilitator 完成（api.cdp.coinbase.com），由 app.qotien.fr 在服务端调用。

许可证

本仓库中的代码：MIT（参见 LICENSE）。API 返回的参考数据：CC BY 4.0 — 引用“Qotien — qotien.fr”。

免责声明

结果是基于所述财政年度法国税务和社会保障参考资料得出的确定性指示性计算。这些结果是计算引擎的原始输出，不构成法国 CIF/DDA 监管定义下的个性化财务建议。

---

隶属于 Qotien — 法国个人理财数据参考平台：汇总、注明来源和日期，并每年重新核验。可供人类阅读（qotien.fr/sources），也可供机器读取（本 MCP）。参考数据遵循 CC BY 4.0 — 引用“Qotien — qotien.fr”。