tax-retirement

Qotien — フランスの税務・年金 MCP

フランスの個人税務と年金を対象とする、出典と日付付きの計算 API を MCP 経由で提供します。 すべての応答には、信頼度、法的根拠、対象となる税年度が含まれます。エンジンが事実を推測することはありません。

ホスト型のリモートサーバーです。x402（Base 上の USDC）による従量課金制です。 事実を返す機能は、初回の呼び出しから課金されます。検索用ツールは 2 つ無料です。アカウントも、保存が必要な 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（無料）を呼び出すと、ツール、信頼度、料金を機械可読形式で一覧できます。

自分で計算する代わりに、これを呼び出す理由

汎用 LLM（またはコードインタープリター）でも計算はできますが、現在適用されている正確なフランスの規則を確実に把握しているわけではありません。たとえば、2026 年の所得税の税率区分と décote の基準額、Agirc-Arrco や CARMF の年金ポイントの価値、各年金基金の遺族年金給付率、今年適用される税額控除率などです。その結果、自信たっぷりに誤った数値を出すことがあります。Qotien は最新の情報を提供し、出典を明示し、リリースごとに一次資料と照合して再検証しています。税務や年金の誤りが許容できない分野（フィンテック、インシュアテック、アドバイザリーツール、ウェルスマネジメントソフトウェア）に適しています。

エンジンが決して破らない 2 つのルール：

• 数値は単独で提供しません — すべての事実には、税年度、法的根拠、信頼度が付随します。
• 推測ではなく計算を行います — 規則または入力が不足している場合、ツールは non_calculable（誠実な計算拒否）を返します。作り上げた数値や「平均」税率を返すことはありません。

ツール — 4 つのドメイン、38 個のツール

MCP のツール名にはドメインの接頭辞（fiscal_*、retraite_*、simulateurs_*、referentiel_*）が付きます。同じ機能は REST でも、接頭辞のない名前（tmi、per_gain、…）で利用できます。各ツールの料金階層は [protocole]（無料）・[barème]・[étude]・[optimiseur] として表示されます（料金を参照）。

税務（所得税・資産税） — 決定論的、confiance: fiable

• fiscal_impot_revenu [barème] — 所得税（累進税率区分、家族係数、減税）
• fiscal_tmi [barème] — 限界税率
• fiscal_cehr [barème] — 高所得者向け特別負担金（任意の rfr_n1 / rfr_n2 を指定すると、art. 223 sexies II-1 に基づく特別所得の平準化が適用されます）
• fiscal_prelevements_sociaux [barème] — 所得の種類ごとの社会保険料率（17.2 % または 18.6 %）
• fiscal_surtaxe_pv_immobiliere [barème] — 不動産譲渡益への追加課税
• fiscal_per_plafond [barème] — PER の控除限度額（給与所得者は N-1 の PASS、自営業者は N の PASS）
• fiscal_plus_value_immobiliere [étude] — 不動産譲渡益（保有期間に応じた控除。相続または贈与で取得した不動産には acquisition_gratuite を指定：実費のみを適用し、7.5 % の定額控除は適用しません。quote_part + valeur_pleine_propriete を指定すると、共有または所有権が分割された持分ごとに €15,000 の非課税枠を満額適用します。土地には terrain を指定：工事費の 15 % 控除は適用しません）
• fiscal_ifi [étude] — 不動産資産税（主たる住居は −30 %。任意の所得上限 75 %、art. 979 は総所得で計算：配当は 40 % 控除前、定額課税の所得も含みます）
• fiscal_foncier_regime [étude] — 家具なし賃貸：micro-foncier と実費控除方式の比較（世帯の税額差 Δ）
• fiscal_lmnp_regime [étude] — 家具付き賃貸（LMNP）：減価償却を含む micro-BIC と実費方式の比較（世帯の税額差 Δ）
• fiscal_succession [étude] — 子ども1人あたりの相続税（art. 777）と、生前贈与による節税額の試算
• fiscal_cdhr [étude] — 高所得者向け差額課税（20 % の下限 + 減税）
• fiscal_per_gain [étude] — PER 拠出による節税額：税率区分 + CEHR/CDHR を含む合計 Δ。「拠出額 × 限界税率」ではありません
• fiscal_niches_plafond [étude] — 税額控除の上限（art. 200-0 A）。除外項目も処理します（寄付：合計に対する 20 % の上限、Coluche €2,000 区分は対象外。JEI/JEIR：situation による加入上限、インパクト企業には variante: "impact" で 40 % の率、2024-2028 年は jei_reductions_anterieures による €50,000 の共通上限）
• fiscal_flat_tax_vs_bareme [étude] — PFU と累進税率方式の比較
• fiscal_jeanbrun [étude] — Jeanbrun 賃貸投資の減価償却（art. 31 I-1° i/j CGI）。実際の節税額を算出するには loyers_annuels、charges_annuelles、interets_annuels を指定します（社会保険料は賃貸所得がゼロになるまで減額され、超過分は全所得から控除できる最大 €10,700 の赤字になります）。指定しない場合は、理論上の最大額が仮定値として明示されます（hypothese_economie）

退職年金 — 信頼度は変動し、数値のみの提示はありません

• retraite_ps_pension [barème]（fiable）— 年金の総額から手取り額への換算（CSG/CRDS/CASA + 補足部分への 1 % の医療費負担）
• retraite_regimes [barème]（fiable）— 算出可能な年金制度の一覧（対象は 32 制度）
• retraite_surcote_parentale [barème]（estime）— 育児による年金加算（四半期あたり +1.25 %、最大 5 %）
• retraite_pension_regime [étude]（fiable）— ポイント制年金制度1つ分の年金額。妥当性チェック付き
• retraite_pension_annuites [étude]（fiable）— 年数制年金制度（公務員、特別制度）の年金額
• retraite_pension_totale [étude]（fiable）— 複数制度を統合した年金額（全職歴の年金記録を1回の呼び出しで計算）、総額から手取り額への換算
• retraite_estimation [étude]（estime/partiel/non_calculable）— 部分データに基づく年金の概算と範囲
• retraite_rachat [étude]（fiable）— 年金加入四半期の買い取り（VPLR）：費用、税引後額、利益、投資収益率
• retraite_progressive [étude]（estime）— 段階的な退職（年金の一部 + パートタイム勤務）
• retraite_optimisation [optimiseur]（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] — 1つの参照値と、その一次資料、法的根拠、検証日
• 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ファシリテーター（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」と記載してください。