Sovereign Debt Crisis

ソブリン債務危機 MCP サーバー

ApifyForge で見る | Apify Store で使う

---

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf）に追加します：

{
  "mcpServers": {
    "sovereign-debt-crisis-mcp": {
      "url": "https://ryanclinton--sovereign-debt-crisis-mcp.apify.actor/mcp"
    }
  }
}

---

AI エージェントと LLM ワークフロー向けのソブリン債務危機モデリングです。この MCP サーバーは、デフォルトの動学、伝染ネットワーク、財政の持続可能性、債務再編の設計、投機的攻撃、政治体制の移行を網羅する、学術的根拠に基づいた8つのシミュレーションツールを提供します。MCP 対応クライアントを接続し、「アルゼンチンのデフォルトリスクをモデル化して」や「ギリシャ型の債務再編に最適なヘアカットを設計して」といった質問をすると、数秒で構造化された定量的な出力が得られます。

このサーバーは、5つのカテゴリにわたる15のソースからライブデータを取得します。対象は、マクロ経済データベース（IMF、World Bank、FRED、BLS、OECD、Eurostat）、二国間貿易フロー（UN COMTRADE、World Bank Projects）、為替レート（現在、過去、ECB）、規制関連フィード（Federal Register、Congress Bills）、地政学インテリジェンス（OpenSanctions、REST Countries）です。その後、8つのツールすべてが利用するソブリン債務ネットワークを構築します。5分間のインメモリーキャッシュにより、複数ツールを使った分析セッションでは、データを重複して取得せずに同じネットワークを再利用できます。

⬇️ アクセスできるデータ

データ項目	ソース	例
📊 財政指標（債務/GDP、基礎的財政収支、信用格付け）	IMF、World Bank	債務/GDP：138％、基礎的財政収支：GDP比−3.2％
📈 マクロ経済系列（GDP成長率、CPI、金利）	FRED、BLS、OECD	10年債利回り：4.85％、CPI：3.2％
🌍 EUの経済・社会統計	Eurostat	ユーロ圏の財政赤字：GDP比−3.6％
🔗 二国間貿易フローの規模	UN COMTRADE	輸出：421億ドル、輸入：673億ドル
🏗️ 開発プロジェクトのポートフォリオ	World Bank Projects	実施中のプロジェクト147件、拠出確約額：184億ドル
💱 現在および過去の為替レート	Exchange Rate Tracker、History、ECB	EUR/USD：1.0842、USD/TRY：32.14
📜 規制・立法関連のシグナル	Federal Register、Congress Bills	関連する決定23件、審議中の法案4件
🚨 制裁リストとPEPデータ	OpenSanctions	ソブリンに関連する制裁対象事業体14件
🌐 国別プロフィールと地域メタデータ	REST Countries	195か国のプロフィール、地域同盟
🏦 ソブリンCDSスプレッド（高頻度シミュレーション）	マクロデータから算出	5年CDS：342bps（BB格）
⚖️ 銀行とソブリン間の融資エクスポージャー	ネットワークのエッジから算出	国境を越えた純エクスポージャー：840億ユーロ
🗳️ 政治体制の分類	Acemoglu-Robinson フレームワーク	体制：ハイブリッド、ジニ係数：0.43
📉 デフォルト確率の状態空間プロファイル	Eaton-Gersovitz VFI	デフォルト閾値：債務/GDP比82％
🔄 清算に伴う支払いカスケード	Eisenberg-Noe + CDS	システミック損失：124億ドル、回収率：0.78
🗓️ 複数頻度のソブリンリスク予測	MIDAS 回帰	第1四半期先の予測：2.1％、第4四半期先：GDP成長率1.4％

❓ ソブリン債務危機 MCP サーバーを使う理由

現在、ソブリンリスク分析には、計量経済モデルに関する博士課程レベルの理解、Bloomberg端末へのアクセス、計算を実行するクオンツアナリストのチームが必要です。一般的なアドバイザリー企業では、単一の債務再編シナリオモデルを作成するのに数週間かかり、アナリストの作業時間に数万ドルの費用がかかります。

この MCP サーバーが状況を変えます。AI エージェントにソブリンデフォルトの動態をモデル化するよう依頼すると、simulate_sovereign_default が呼び出されます。50×40の状態空間グリッドでEaton-Gersovitzの価値関数反復を実行し、IMFと世界銀行のライブデータを取得して、内生的なデフォルト閾値と均衡スプレッドを、1回のツール呼び出しで返します。

• 常時利用可能なデータ — サーバーはセッションごとに15のソースからライブデータを取得するため、分析に最新のマクロ経済状況が反映されます
• APIアクセス — Claude Desktop、Cursor、Windsurf、または任意のMCPクライアントから、設定を1行追加するだけでツールを呼び出せます
• 並列データ取得 — 最大のスループットを実現するため、15のアクターすべてをPromise.allで呼び出します
• 支出上限 — すべてのツール呼び出しでActor.charge()を確認し、予算に達すると安全に停止します
• 組み合わせ可能 — 8つのツールすべてを順番に実行して包括的なソブリンリスク評価を行うことも、個々のツールを呼び出して対象を絞った分析を行うこともできます

特徴

• Eaton-Gersovitz（1981）の価値関数反復法 — 50点の債務グリッド × 40点の所得グリッド（ρ=0.945、σ=0.025 の Tauchen 離散化 AR(1)）で、許容誤差 1e-5 で収束するまで反復し、内生的なデフォルト閾値、債券価格スケジュール、最適借入政策関数を導出します
• CDS の循環性を考慮した Eisenberg-Noe（2001）の清算 — Scarf 型の減衰付き固定点反復（減衰係数 0.7、許容誤差 1e-6、最大 500 回）を用いて、銀行・ソブリンネットワークの清算支払ベクトルを計算します。CDS の相互保有によって生じる非単調な写像にも対応します
• Hansen（1999）のパネル閾値回帰 — トリミングした（15%～85%）実測債務分布をグリッドサーチし、残差平方和が最小となる債務/GDP のブレークポイントを特定します。200 回の反復によるブートストラップ推論で有意性を検証します
• Myerson（1981）のメカニズムデザイン＋Nash-Rubinstein 交渉 — インセンティブ適合性と個人合理性の制約を伴う顕示原理を適用して最適なヘアカットスケジュールを導出します。交互提案均衡（δ_d=0.92、δ_c=0.88）と組み合わせ、債務者と債権者の余剰分配を計算します
• Morris-Shin（2003）のグローバルゲーム — 私的シグナルのノイズ σ=0.1（精度 τ=100）のもと、無差別条件に関する固定点反復で一意の切り替え均衡 θ* を特定し、投機的攻撃モデルにおける Obstfeld（1996）の複数均衡問題を解決します
• Lee-Mykland（2008）のノンパラメトリック・ジャンプ検出 — ローリングウィンドウ K=√n で局所バイパワー変動を計算し、Gumbel 漸近理論（定数 C_n、S_n）で標準化したうえで、最大 8 系列のソブリン・スプレッド時系列を同時に分析し、p<0.05 のジャンプを検出します
• Almon 多項式を用いた MIDAS 回帰（Ghysels et al. 2004） — 最適な指数 Almon ラグ加重のためのパラメータ空間（θ₁、θ₂）をグリッドサーチします。日次 CDS スプレッドと四半期 GDP を組み合わせ、Q+1、Q+2、Q+4、Q+8 の予測期間について 95% 信頼区間を算出します
• Acemoglu-Robinson（2006）の政治体制移行 — 不平等から推定したジニ係数をもとに、3 状態のマルコフ遷移行列（民主制／ハイブリッド／権威主義）を推定します。200 回のべき乗反復で定常分布を解き、AR フェーズに基づいて体制を分類します（革命の脅威／エリートの権力強化／民主化圧力／安定均衡）
• 5 分間のネットワークキャッシュ — マクロ、貿易、為替、規制、地政学のデータから、セッションごとにソブリン債務ネットワークを一度構築します。TTL 期間内の以降のツール呼び出しでは、追加のデータコストなしでキャッシュ済みネットワークを再利用します
• 選択的なソースフィルタリング — 各ツール呼び出しでは sources 配列を指定して、データ取得を関連カテゴリ（マクロ、貿易、為替、規制、地政学）に絞り込めます。対象を絞ったクエリのレイテンシを低減します
• 15 の統合データ提供元 — IMF、World Bank、FRED、BLS、OECD、Eurostat、UN COMTRADE、World Bank Projects、Exchange Rate Tracker、Exchange Rate History、ECB Rates、Federal Register、Congress Bills、OpenSanctions、REST Countries

ソブリン債務危機モデルのユースケース

ソブリン・デフォルトリスク評価

債券アナリストやソブリン信用チームは、新興市場債務のポジションを取る前に、内生的なデフォルト閾値をモデル化する必要があります。simulate_sovereign_default に国名を指定して、IMF と World Bank の最新の債務/GDP データを用いた価値関数反復を実行します。ソブリンが返済よりもデフォルトを選択する最適な債務水準と、対応する均衡スプレッド（ベーシスポイント）が返されます。

銀行・ソブリン間のドゥームループ分析

欧州の銀行ストレステスト担当者や金融安定性の研究者は、ソブリンの信用不安が銀行システムを通じてどのように波及するかをモデル化する必要があります。compute_clearing_contagion を使用して、銀行・ソブリンのエクスポージャーネットワーク全体で CDS の循環性を考慮した Eisenberg-Noe 清算を実行し、システミック損失、回収率、クロスボーダー CDS ポジションによる増幅効果を定量化します。

財政持続可能性レジームの検出

IMF プログラムの設計者、予算局、EM マクロファンドは、各国の現在の債務軌道が持続不可能なレジームに移行しているかどうかを特定する必要があります。estimate_fiscal_sustainability を使用すると、パネルデータセットに対して Hansen の閾値回帰を実行し、ブートストラップ信頼区間を用いて債務/GDP のブレークポイントを特定し、ネットワーク内の各国を持続可能、脆弱、または持続不可能に分類できます。

債務再編の設計と交渉

再編案を準備するソブリンアドバイザリーチーム、ディストレスト債務ファンド、公的債権者の作業部会は、債権者の参加と債務国の持続可能性のバランスを取るヘアカットスケジュールをモデル化する必要があります。design_optimal_restructuring を使用すると、Myerson-IC 再編条件と Nash-Rubinstein 交渉の結果を算出し、ヘアカット総額、参加率、ホールドアウトリスクスコアを取得できます。

通貨ペッグ防衛と投機攻撃のモデル化

FX ストラテジストと中央銀行の外貨準備管理担当者は、協調的な投機圧力に対して通貨ペッグを防衛できるかどうかを把握する必要があります。model_speculative_attack を使用すると、現在の CDS スプレッドをもとに、Morris-Shin のスイッチング均衡 θ*、臨界準備高、攻撃確率を算出できます。不完全情報のもとで一意の均衡が保証されます。

ナウキャスティングと複数頻度のソブリンリスク予測

マクロ調査部門とリスク管理担当者は、ラグ集約バイアスを生じさせずに、高頻度シグナル（日次 CDS 変動）を四半期ごとのソブリンリスク予測に組み込む必要があります。forecast_multi_frequency を使用すると、最適な Almon 指数ラグウェイトを用いた MIDAS 回帰を当てはめ、信頼区間とレジーム転換確率フラグを伴う Q+1 から Q+8 までの GDP 成長率予測を生成できます。

政治的移行リスクの評価

カントリーリスクチーム、政治リスク保険会社、地政学アナリストは、不平等の動態がどのようにレジーム移行確率につながるかを定量化する必要があります。assess_political_transition_risk を使用すると、Acemoglu-Robinson の枠組みによる分析を実行し、マルコフ遷移行列、定常レジーム分布、予想レジーム継続期間、民主化またはクーデターリスクを引き起こすジニ係数の水準を取得できます。

Sovereign Debt Crisis MCP Server への接続方法

コーディングは不要です。 サーバー URL を MCP クライアントの設定に追加し、自然な言葉でクエリを開始できます。

1. サーバー URL をコピー — https://sovereign-debt-crisis-mcp.apify.actor/mcp
2. MCP クライアントに追加 — 以下の設定スニペットを Claude Desktop、Cursor、または Windsurf に貼り付けます（例を参照）
3. 認証 — Apify API トークンを URL または Authorization ヘッダーに含めます（「認証」セクションを参照）
4. クエリを開始 — AI エージェントに「トルコのデフォルトリスクをモデル化して」や「南ヨーロッパの財政持続可能性分析を実行して」と尋ねると、サーバーがデータ取得と計算を処理します

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "sovereign-debt-crisis": {
      "url": "https://sovereign-debt-crisis-mcp.apify.actor/mcp?token=YOUR_APIFY_TOKEN"
    }
  }
}

Cursor

Cursor の MCP 設定（Settings → MCP → Add Server）に追加します。

{
  "mcpServers": {
    "sovereign-debt-crisis": {
      "url": "https://sovereign-debt-crisis-mcp.apify.actor/mcp?token=YOUR_APIFY_TOKEN"
    }
  }
}

Windsurf / Continue / 任意の MCP クライアント

{
  "mcpServers": {
    "sovereign-debt-crisis": {
      "url": "https://sovereign-debt-crisis-mcp.apify.actor/mcp?token=YOUR_APIFY_TOKEN"
    }
  }
}

YOUR_APIFY_TOKEN を、Apify Console → Settings → Integrations から取得したトークンに置き換えます。

MCP ツール

ツール	モデル	説明
simulate_sovereign_default	Eaton-Gersovitz (1981)	債務と所得の状態空間（50×40）で価値関数反復を実行します。デフォルトのしきい値、均衡スプレッド、債券価格スケジュール、最適な借入政策関数を返します。
compute_clearing_contagion	Eisenberg-Noe (2001) + CDS	Scarf 型の減衰固定点法により、CDS の循環性を伴う銀行・ソブリンネットワークの清算支払いを求めます。システミック損失、デフォルトした主体、連鎖のラウンド数、回収率を返します。
estimate_fiscal_sustainability	Hansen (1999)	200 回のブートストラップ推論を用いたパネルしきい値回帰です。債務／GDP の転換点、レジーム分類、金利と成長率の差（r−g）、調整経路を返します。
design_optimal_restructuring	Myerson (1981) + Rubinstein (1982)	インセンティブ適合性制約付きメカニズムデザインと交互提案型交渉を組み合わせます。債券ごとのヘアカット、ナッシュ余剰の分配、ホールドアウトリスク、債務持続可能性フラグを返します。
model_speculative_attack	Morris-Shin (2003)	グローバルゲームの固定点法により、一意な切り替え均衡 θ* を求めます。投機攻撃の確率、外貨準備の枯渇、切り下げ幅、投機家と中央銀行の利得を返します。
detect_crisis_jumps	Lee-Mykland (2008)	バイパワー変動とガンベル漸近論を用いて、最大 8 系列のスプレッドにおけるジャンプを検出します。ジャンプイベント、強度 λ、クラスタリング係数、臨界しきい値を返します。
forecast_multi_frequency	MIDAS / Ghysels et al. (2004)	Almon の指数ラグ多項式により、日次 CDS と四半期 GDP を組み合わせます。Q+1／Q+2／Q+4／Q+8 の予測値、95% 信頼区間、MIDAS の R²、レジーム転換確率を返します。
assess_political_transition_risk	Acemoglu-Robinson (2006)	不平等のしきい値を要因として、3 つの政治レジーム間のマルコフ転換をモデル化します。遷移行列、定常分布、AR フェーズ、レジームごとの財政への影響を返します。

ツールの入力パラメーター

各ツールは、同じ 2 つのパラメーターを受け取ります。

パラメーター	型	必須	説明
query	string	はい	分析対象となる国、ソブリン債務シナリオ、または政策トピックです。例：「Argentina sovereign debt」「Euro area fiscal sustainability」「Turkish lira speculative attack」
sources	array of strings	いいえ	含めるデータソースのカテゴリです。選択肢は "macro"、"trade"、"fx"、"regulatory"、"geopolitical" です。省略した場合は、5 つすべてのカテゴリがデフォルトで使用されます。

ソースカテゴリのリファレンス

ソースカテゴリ	呼び出されるアクター	データの種類
macro	IMF、World Bank、FRED、BLS、OECD、Eurostat	財政指標、GDP、インフレ、雇用
trade	UN COMTRADE、World Bank Projects	二国間貿易フロー、開発ポートフォリオ
fx	Exchange Rate Tracker、Exchange Rate History、ECB Rates	現在および過去の為替レート
regulatory	Federal Register、Congress Bills	米国の規制および立法に関するシグナル
geopolitical	OpenSanctions、REST Countries	制裁へのエクスポージャー、国のメタデータ

ツール呼び出しの例

ソブリンデフォルトの完全なシミュレーション：

{
  "query": "Argentina sovereign debt default risk 2024",
  "sources": ["macro", "fx", "geopolitical"]
}

対象を絞った財政持続可能性のチェック（マクロのみ、高速）：

{
  "query": "Italy fiscal sustainability debt-to-GDP",
  "sources": ["macro"]
}

貿易関連を考慮した銀行の連鎖：

{
  "query": "European bank sovereign doom loop exposure",
  "sources": ["macro", "trade", "fx"]
}

出力例

simulate_sovereign_default の出力

{
  "states": [
    {
      "debt": 0.0,
      "income": 1.002,
      "value": -4.821,
      "defaultValue": -5.103,
      "defaultProbability": 0.0,
      "bondPrice": 0.9697,
      "optimalBorrowing": 0.163
    },
    {
      "debt": 0.612,
      "income": 1.002,
      "value": -5.447,
      "defaultValue": -5.103,
      "defaultProbability": 1.0,
      "bondPrice": 0.8241,
      "optimalBorrowing": 0.0
    }
  ],
  "defaultThreshold": 87.3,
  "equilibriumSpread": 412.7,
  "debtLimit": 100.0,
  "outputCostOfDefault": 2.0,
  "reentryProbability": 0.282,
  "policyFunction": [
    { "debt": 0.0, "income": 0.933, "borrow": 0.102 },
    { "debt": 0.0, "income": 1.002, "borrow": 0.163 },
    { "debt": 0.306, "income": 1.002, "borrow": 0.306 },
    { "debt": 0.612, "income": 1.002, "borrow": 0.0 }
  ]
}

compute_clearing_contagion の出力

{
  "payments": [
    {
      "bank": "Turkey Banking Sector",
      "promised": 847.2,
      "actual": 661.3,
      "shortfall": 185.9,
      "recovery": 0.781
    },
    {
      "bank": "Turkish Sovereign",
      "promised": 1203.4,
      "actual": 1138.7,
      "shortfall": 64.7,
      "recovery": 0.946
    }
  ],
  "systemicLoss": 312.4,
  "defaultedEntities": ["Turkey Banking Sector", "Halkbank"],
  "contagionRounds": 8,
  "cdsCircularityEffect": 46.9,
  "fixedPointIterations": 127,
  "largestExposure": {
    "from": "European Central Counterparty",
    "to": "Turkish Sovereign",
    "amount": 584.0
  }
}

model_speculative_attack の出力

{
  "equilibrium": {
    "fundamentalThreshold": 0.423,
    "signalPrecision": 100.0,
    "reservesCritical": 423.0,
    "attackProbability": 0.3871,
    "pegSurvivalProbability": 0.6129,
    "uniqueEquilibrium": true
  },
  "reservesDepleted": 38.71,
  "devaluationMagnitude": 28.84,
  "speculatorPayoff": 0.0614,
  "centralBankLoss": 48.9,
  "multipleEquilibria": false,
  "morrisShinThreshold": 0.423
}

assess_political_transition_risk の出力

{
  "regimes": [
    {
      "country": "Brazil",
      "currentRegime": "hybrid",
      "eliteStrength": 0.441,
      "populistPressure": 0.617,
      "giniThreshold": 0.42,
      "transitionProbability": 0.0821,
      "fiscalImpact": -1.34
    }
  ],
  "markovTransitionMatrix": [
    [0.8700, 0.1200, 0.0100],
    [0.2500, 0.5000, 0.2500],
    [0.0800, 0.1700, 0.7500]
  ],
  "stationaryDistribution": [0.4312, 0.2891, 0.2797],
  "expectedRegimeDuration": 6.84,
  "giniTriggerLevel": 0.428,
  "acemogluRobinsonPhase": "Democratization Pressure",
  "democratizationProbability": 0.0614
}

出力フィールドのリファレンス

simulate_sovereign_default

Field	Type	Description
states[]	array	中央所得での状態空間グリッド値
states[].debt	number	債務／GDP比（0〜1のスケール）
states[].value	number	VFI による継続価値 V_c(b,y)
states[].defaultProbability	number	この状態でデフォルトが最適な場合は 1.0
states[].bondPrice	number	均衡債券価格 q(b',y)
defaultThreshold	number	デフォルトが最適となる債務／GDP比の閾値（％）
equilibriumSpread	number	閾値における債券スプレッド（ベーシスポイント）
debtLimit	number	持続可能な債務／GDP比の上限（％）
outputCostOfDefault	number	デフォルト時の産出損失（GDP比、％）
reentryProbability	number	θ = 0.282：各期に資本市場へ再参入する確率
policyFunction[]	array	(b, y) に応じた最適借入額 b'

compute_clearing_contagion

Field	Type	Description
payments[].bank	string	エンティティ名
payments[].promised	number	負債総額（百万 USD）
payments[].actual	number	反復計算後の実際の決済額
payments[].shortfall	number	約定額から実際の決済額を差し引いた額（百万 USD）
payments[].recovery	number	回収率（0〜1、額面に対するセント）
systemicLoss	number	ネットワーク全体の不足額合計（百万 USD）
defaultedEntities	array	回収率が 0.95 未満のエンティティ
contagionRounds	number	収束までの不動点反復回数
cdsCircularityEffect	number	CDS の循環性に起因する追加損失
largestExposure	object	ネットワーク内で最大の二者間エクスポージャー

estimate_fiscal_sustainability

Field	Type	Description
regimes[].regime	string	sustainable、vulnerable、または unsustainable
regimes[].thresholdEstimate	number	Hansen パネルの閾値（債務／GDP比、％）
regimes[].adjustmentNeeded	number	必要な財政調整（GDP比、％）
regimes[].confidenceInterval	array	閾値のブートストラップ 90％信頼区間
panelThreshold	number	推定された債務／GDP比の閾値
bootstrapPValue	number	閾値の有意性に関するブートストラップ p 値
interestGrowthDifferential	number	r−g（正の場合、債務動学は不安定）
debtDynamicsStable	boolean	r < g の場合は True

design_optimal_restructuring

Field	Type	Description
terms[].haircut	number	債務証券の正味現在価値（NPV）損失率（％）
terms[].participationRate	number	債権者の予想参加率（0〜1）
aggregateHaircut	number	全債務証券の平均ヘアカット
nashBargainingSolution	object	債務者と債権者の余剰配分
rubinsteinEquilibrium	object	先手優位と割引率
incentiveCompatible	boolean	IC 制約を満たす場合は True
holdoutRisk	number	交渉に参加しないと予想される債権者の割合

model_speculative_attack

Field	Type	Description
equilibrium.fundamentalThreshold	number	θ* の切り替え点（0〜1）
equilibrium.attackProbability	number	ペッグが攻撃される確率
equilibrium.uniqueEquilibrium	boolean	σ < 0.5（有限のシグナルノイズ）の場合は True
reservesDepleted	number	攻撃が成功した場合に消費される外貨準備（％）
devaluationMagnitude	number	ペッグが崩壊した場合の予想切り下げ幅（％）
speculatorPayoff	number	攻撃資金 1 単位あたりの期待利得
centralBankLoss	number	外貨準備の損失（百万 USD）

detect_crisis_jumps

Field	Type	Description
jumps[].date	文字列	検出されたジャンプイベントの日付
jumps[].jumpSize	数値	ジャンプ発生時の対数リターンの大きさ
jumps[].testStatistic	数値	標準化されたLee-Mykland統計量
jumps[].pValue	数値	Gumbel漸近p値
jumpIntensity	数値	年率換算したジャンプ強度λ（年あたり）
clusteringCoefficient	数値	別のジャンプから5日以内に発生したジャンプの割合
leeMyklandThreshold	数値	有意水準5%の臨界値

forecast_multi_frequency

Field	Type	Description
forecasts[].horizon	文字列	Q+1、Q+2、Q+4、Q+8
forecasts[].forecast	数値	点予測（GDP成長率%）
forecasts[].ci95Lower	数値	95%信頼区間の下限
forecasts[].ci95Upper	数値	95%信頼区間の上限
forecasts[].almonWeights	配列	Almonラグ重みの最初の10個
midasR2	数値	インサンプルMIDAS R²
regimeSwitchingProb	数値	直近のデータにおけるレジーム転換の確率

assess_political_transition_risk

Field	Type	Description
regimes[].currentRegime	文字列	democratic、hybrid、またはauthoritarian
regimes[].transitionProbability	数値	レジーム変化の確率
regimes[].fiscalImpact	数値	政権移行によるGDPへの推定影響（GDP比%）
markovTransitionMatrix	配列	3×3の遷移確率行列
stationaryDistribution	配列	長期的なレジーム確率 [D, H, A]
expectedRegimeDuration	数値	現在のレジームにおける加重期待年数
acemogluRobinsonPhase	文字列	ARフレームワークによるフェーズ分類
democratizationProbability	数値	非民主主義体制における民主化の確率

ソブリン債務危機モデルの実行コストはいくらですか？

このMCPサーバーはイベントごとの従量課金制を採用しており、ツール呼び出しごとに定額をお支払いいただきます。計算コストも含まれています。

Tool	呼び出しごとの料金
simulate_sovereign_default	$0.045
compute_clearing_contagion	$0.045
design_optimal_restructuring	$0.040
model_speculative_attack	$0.040
estimate_fiscal_sustainability	$0.035
detect_crisis_jumps	$0.035
forecast_multi_frequency	$0.035
assess_political_transition_risk	$0.035

利用シナリオ	ツール呼び出し数	推定コスト
単一ツールのクエリ	1	$0.035–$0.045
国別の詳細分析（3ツール）	3	~$0.12
8ツールすべてを使用した分析	8	~$0.31
日次モニタリング（1か国、2ツール）	60/月	~$2.40/月
調査ワークフロー（10か国、すべてのツール）	80	~$3.10

コストを管理するため、実行ごとに最大支出額を設定できます。予算に達すると、MCPサーバーは正常に停止し、エラーを黙って返さずにエラーメッセージを返します。

Apify Freeプランには月額5ドル分のプラットフォームクレジットが含まれており、月あたり約130回のツール呼び出しを無料で利用できます。

Sovereign Debt Crisis MCP Serverの仕組み

フェーズ1：複数ソースのデータ集約

各ツール呼び出しではgetOrBuildNetwork()が実行され、TTLが5分のキャッシュ済みSovereignDebtNetworkがあるか確認します。キャッシュがない場合、fetchSovereignData()はPromise.allを使用して、最大15個のアクターに対するrunActor()呼び出しを並列に実行します。各上流アクターには、ユーザーのクエリ文字列と結果数のlimit 50を指定して呼び出し、タイムアウトは180秒、メモリ割り当ては256MBです。結果は、型付けされた5つのバケット（macroData、tradeData、fxData、regulatoryData、sanctions、countryData）に分類されます。

フェーズ 2：ソブリン債務ネットワークの構築

buildSovereignDebtNetwork() は、生の API 結果から SovereignNode[] と SovereignEdge[] で構成される型付きグラフを組み立てます。マクロ経済データと国データは sovereign ノードになり、為替データは currency ノードと currency_peg エッジになります。貿易データは、単位を百万米ドルとする取引量で重み付けされた trade_flow エッジを生成し、制裁データは contagion エッジを作成します。規制データは institution ノードを作成します。ネットワーク内の融資エッジがソブリンノードより少ない場合、合成銀行ノード（bank-{sovereign.id}）が生成され、債務／GDP 比率から算出した融資ウェイトと、隣接するソブリンへのクロスボーダー CDS エッジが設定されます。

フェーズ 3：定量モデルの実行

8 つのモデルはすべて、組み立てられた SovereignDebtNetwork に対して実行されます。Eaton-Gersovitz ソルバーは、CRRA 効用（σ=2）、割引係数 β=0.953、Tauchen 法で離散化した所得グリッドを用いて、最大 200 回の VFI 反復を実行し、最大 |V_c_new − V_c| が 1e-5 未満になると収束します。Eisenberg-Noe ソルバーは、単調でない CDS の循環性に対して Scarf 減衰（α=0.7）を用い、反復回数を 500 回に制限します。Hansen 閾値ソルバーは、トリミングした経験分布全体から等間隔の候補値を 50 個選んでグリッドサーチし、その後 200 回のブートストラップ反復で検証します。Morris-Shin ソルバーは、Abramowitz-Stegun 多項式近似による Φ を用い、減衰付き固定点反復（新しい値 0.7 ＋現在の値 0.3）で θ* を求めます。MIDAS ソルバーは、7×5 の（θ₁, θ₂）Almon パラメーターグリッドをグリッドサーチし、R² が最大の OLS 適合を選択してから、ホライズンに応じた標準誤差で 4 つのホライズンの予測を行います。

フェーズ 4：イベントごとの課金と応答

モデルの実行後、各ツールはイベントごとの価格スケジュールに基づいて Actor.charge({ eventName }) を呼び出します。eventChargeLimitReached が true の場合、ツールは例外をスローする代わりに、構造化されたエラー JSON を返します。結果はインデント幅 2 の JSON にシリアライズされ、MCP の content[0].text として返されます。/health のヘルスエンドポイントでは、ネットワークキャッシュの状態、ノード数とエッジ数、アクティブなソースカテゴリの一覧を確認できます。

最良の結果を得るためのヒント

1. 応答を速くするには、対象を絞ったソース配列を使用してください。 デフォルトのしきい値分析では、sources: ["macro", "fx"] で十分で、5つすべてのソースを取得する場合の約半分の時間で実行できます。制裁の影響を考慮する必要があるクエリでは、geopolitical を使用してください。

2. トリアージでは、最も低コストのツールから実行してください。 まず estimate_fiscal_sustainability（$0.035）を実行し、より詳細な分析が必要な国を絞り込んでから、simulate_sovereign_default（$0.045）または compute_clearing_contagion（$0.045）を実行してください。

3. 1つのクエリ文字列に複数の国を含めてください。 「southern European sovereign debt Italy Spain Portugal」のようなクエリを使うと、ネットワークに複数のソブリンノードが追加され、1回の呼び出しですべての8つのツールから複数国の比較を取得できます。

4. 早期警戒には detect_crisis_jumps と model_speculative_attack を組み合わせてください。 0.4を超えるジャンプクラスタリング係数は、攻撃確率が通常高まる伝染期間を示します。両方のツールを実行し、ジャンプ強度のタイムラインをMorris-Shinのしきい値と比較してください。

5. design_optimal_restructuring の前に forecast_multi_frequency を使用してください。 MIDAS Q+4およびQ+8の予測から、Rubinstein均衡のヘアカットによって債務の持続可能性が回復するかどうかを判断する成長経路の前提が得られます。最初に予測を実行しておくと、債務再編の出力を解釈しやすくなります。

6. 5分間のキャッシュにより、複数のツールを使ったセッションを効率化できます。 AI エージェントに8つすべてのツールを順番に実行するよう依頼してください。各ツールは同じネットワークを共有するため、データ取得の料金は一度しかかかりません。国に関する8ツールすべてを使った分析の費用は約$0.31です。

7. estimate_fiscal_sustainability の debtDynamicsStable を確認してください。 false（r > g）の場合、金利と成長率の差が発散していることを意味します。これは defaultThreshold の値が高くなる可能性を示す有力な事前情報であり、直ちに simulate_sovereign_default を実行してください。

8. 自動化されたワークフローでは、支出上限を明示的に設定してください。 このMCP サーバーをスケジュールされたAI エージェントのパイプラインで実行するときは、maxTotalChargeUsd を設定してセッションごとの費用に上限を設けてください。上限に達した場合、サーバーは処理が停止しないように、構造化されたエラーを返します。

他のApifyアクターとの組み合わせ

アクター	組み合わせ方法
FRED Economic Data	詳細な米国債利回り曲線とマネーサプライのデータを取得し、Eaton-Gersovitzモデルのリスクフリーレートパラメーターを調整します
World Bank Data Search	世界開発指標（ガバナンス、CPIAスコア）を取得し、Acemoglu-Robinsonツールの政治体制分類を補強します
OpenSanctions Search	伝染分析を実行する前に、各国が現在制裁の対象となっているかを事前に確認します。厳しい制裁を受けているソブリンは、クリアリングの動態が構造的に異なります
UN COMTRADE Search	ネットワークのエッジとなる二国間貿易フロー行列を作成します。サーバーのデフォルトの貿易データより詳細なデータが得られ、伝染経路のモデリングが向上します
IMF Economic Data	世界経済見通しの予測を抽出し、AR(1)合成データに頼らず、VFI所得グリッドの外生的な所得予測として使用します
ECB Exchange Rates	ECBの基準レートをFXノード層に直接取り込み、Morris-Shin投機的攻撃ツールでの通貨ペッグのモデリング精度を高めます
Company Deep Research	ソブリン分析と組み合わせて、ソブリンと結びついた企業の信用リスクを評価します。デフォルトリスクの高いソブリンの企業は、相関する信用リスクを抱えています

制限事項

• Eaton-Gersovitz における小規模開放経済の仮定 — このモデルでは、主権国家をプライステイカーとして扱います。米国、中国、EU のように世界の金利に影響を与える大規模経済には、ここでは実装されていない一般均衡への拡張が必要です
• 観測値ではなく推定された二国間エクスポージャー — Eisenberg-Noe の清算には、銀行間および銀行と主権国家間の貸付マトリクスが必要です。これらは監督当局への報告ではなく公開マクロデータから導出されるため、測定誤差が大きくなります
• 合成 CDS 時系列 — Lee-Mykland のジャンプ検出では、ノードレベルの CDS スプレッド属性に基づいて較正したジャンプ拡散経路をシミュレートします。実際のティックごとの CDS データは使用しないため、検出されたジャンプの日付は目安であり、実際の暦日と正確に一致するとは限りません
• 様式化された不平等の代理指標 — Acemoglu-Robinson のジニ係数推定値は、家計調査の個票データではなく、債務／GDP 比と CDS スプレッド水準から導出されます。実際のジニ係数は大きく異なる場合があり、レジーム分類の精度に影響します
• 多国間債権者のモデリングなし — IMF、世界銀行、パリクラブの債務再編の動向は、Myerson メカニズムでは個別にモデル化されていません。公的部門の債務は通常、優先順位や再交渉の慣行が異なります
• N=200 でのブートストラップ推論 — Hansen の閾値ブートストラップでは速度を優先して 200 回の反復を使用しています。本番環境の計量経済分析では、正確な p 値を得るために通常 1,000 回以上の反復を使用します
• データソースの利用可能性 — 上流のアクター（IMF、世界銀行など）が特定のクエリに対して空のデータセットを返す場合、ネットワークグラフは疎になります。結果は引き続き返されますが、実証的な根拠は弱くなります
• MIDAS における四半期頻度の仮定 — ブリッジ方程式では、低頻度のターゲットとして四半期 GDP を想定しています。月次の鉱工業生産や週次の金融環境指数を使用する場合は、パラメーターの再較正が必要です

統合

• Claude Desktop — MCP URL を claude_desktop_config.json に追加すると、Claude のインターフェースから自然言語で主権債務リスクを照会できます
• Cursor — MCP サーバーとして設定すると、IDE 内で研究用コードや分析ノートブックから主権国家のデフォルトモデリングに直接アクセスできます
• Apify API — /mcp POST エンドポイントを介してスタンバイアクターをプログラムで起動し、Python または JavaScript の研究パイプラインに統合できます
• Webhooks — ツール呼び出しがコストのしきい値を超えた場合や、スケジュールされた監視ワークフロー中にサーバーが予期しない結果を返した場合に、アラートを設定できます
• LangChain / LlamaIndex — Apify MCP 統合を使用して、8 つすべての主権債務ツールを LangChain のツールまたは LlamaIndex のクエリエンジンとして公開し、研究エージェントを自動化できます

トラブルシューティング

有効な国名でクエリしているのに、ツールが空の状態またはノード数がゼロのネットワークを返します。 上流のデータアクターが、クエリ文字列に一致するレコードを返さない場合に発生します。クエリの範囲を広げる（例：特定の国名ではなく「新興国のソブリン債務」とする）か、sources 配列を ["macro"] に減らして、どのデータカテゴリで問題が起きているかを特定してください。/health エンドポイントで cached: true/false と networkSize を確認すると、ネットワークが構築されたかどうかが分かります。

Eaton-Gersovitz の defaultThreshold が 100（債務上限の最大値）を返します。 これは、(b,y) グリッド内のすべての状態でデフォルトより継続が選好されていることを示します。クエリが CDS スプレッドの非常に低いソブリン、または債務/GDP データのないソブリンを返した場合に起こり得ます。クエリが debtToGDP と cdsSpread の値が入力されたソブリンノードを返しているか確認してください。これらの値を使って所得グリッドのスケーリングを調整します。

compute_clearing_contagion の fixedPointIterations: 500（最大値）が表示されます。 Scarf 反復が収束しませんでした。銀行とソブリンのネットワークで CDS の循環性が極端に高い場合に起こり得ます。これは、相互接続性の高いネットワークにおける減衰反復アプローチの既知の制限です。結果は引き続き返されますが、近似値として扱ってください。sources 配列から trade を除外すると、より疎なネットワークとなり、収束しやすくなる場合があります。

estimate_fiscal_sustainability が bootstrapPValue: 1.0 を返します。 p 値が 1.0 ということは、元の F 統計量を上回るブートストラップ標本がなかったことを意味し、閾値が統計的に非常に有意であることを示します。これはエラーではなく、非常にクリーンなパネルデータでよく発生します。反対に、p 値が 0.15 を超える場合は、閾値を確実に識別するにはパネル内の変動が不十分である可能性があります。

ツール呼び出しが {"error": true, "message": "Spending limit reached"} を返します。 maxTotalChargeUsd の上限に達しました。Apify アクターの実行設定で上限を引き上げるか、プランをアップグレードしてください。Apify Free プランには、月額 5 ドル分のクレジットが含まれています。

責任ある利用

• この MCP サーバーは、国際機関、政府データベース、オープンデータプラットフォームが公開しているデータのみを利用します。
• 上流のデータソース 15 件はすべて、オープンアクセスまたはパブリックドメインのライセンスでデータを提供しています。再配布する前に、各データソースの利用条件を確認してください。
• ソブリンリスクモデルは確率的な出力を生成するため、投資、政策、助言に関する判断に利用する前に、資格を有するアナリストが確認してください。
• 追加のデューデリジェンス、専門家の判断、最新の市場情報を取り入れずに、モデルの出力だけを投資判断の根拠にしないでください。
• ウェブスクレイピングの合法性に関するガイダンスは、Apify のガイドを参照してください。

❓ よくある質問

ソブリン債務危機 MCP サーバーは、Bloomberg Terminal や Moody's Analytics とどう違いますか？ Bloomberg と Moody's は、独自モデルに基づいた精選データと標準化されたリスクスコアを提供します。このサーバーでは、Eaton-Gersovitz、Eisenberg-Noe、Morris-Shin などの学術モデルを直接利用できるため、計算の仕組みを正確に確認し、特定のシナリオに合わせてクエリを変更し、出力を AI エージェントのワークフローに統合できます。Bloomberg は端末 1 台あたり月額 2,000 ドル以上かかりますが、このサーバーはほとんどの調査用途で Apify の無料枠で実行できます。

ソブリン債務危機モデルの 1 回の実行で、何か国を分析できますか？ 国数に厳密な上限はありません。「G20 のソブリン債務」のようなクエリでは、すべての G20 ソブリンノードがネットワークに追加され、複数国にまたがるネットワーク全体でモデルが実行されます。ネットワークが大きくなると Eisenberg-Noe の収束にかかる時間は長くなりますが、失敗することはありません。実質的な制限となるのは上流アクターの応答時間です。50 か国以上を個別に指定してクエリすると、アクターのタイムアウトである 180 秒に達する可能性があります。 Eaton-Gersovitz モデルでは、実際の債務／GDP データとシミュレーション値のどちらを使用しますか？ 両方を使用します。このモデルでは、学術的なパラメーター（β=0.953、σ=2、ρ_y=0.945）からグリッドベースの状態空間を計算しますが、defaultThreshold と equilibriumSpread の出力値は、照会対象の国について IMF と World Bank のアクターから取得した実際の債務／GDP と CDS スプレッドの平均値でスケーリングします。観測された債務／GDP が高い国ほど、しきい値の推定値も比例して高くなります。

Morris-Shin の θ（切り替えしきい値）は、実際には何を意味しますか？* θ* は、自己実現的な投機攻撃に対してその国が脆弱になる、ファンダメンタルズの臨界水準を表します（0～1 の範囲に正規化されており、1 が最も強い状態です）。0.3 未満はファンダメンタルズが強く、攻撃リスクが低いことを示します。0.6 を超える値は、準備高が中程度でも投機圧力が成功しやすい状態を示します。

IMF、World Bank、FRED のデータをソブリン債務分析に使用することは合法ですか？ はい。15 件すべてのデータソースは、研究や分析での利用を目的としたオープンアクセス、パブリックドメイン、または CC-BY ライセンスのもとでデータを提供しています。IMF のデータにはクリエイティブ・コモンズ表示ライセンスが適用され、World Bank のデータはオープンデータであり、FRED のデータはパブリックドメインです。一般的な原則については、Apify のウェブスクレイピングの合法性に関するガイドをご覧ください。

債務の持続可能性の転換点を特定する Hansen のしきい値回帰は、どの程度正確ですか？ 精度はパネルデータの充実度によって異なります。複数期間にわたる変動を持つソブリンノードが 10 件以上ある場合、しきい値の推定値は通常、債務／GDP 比で ±8～12 パーセントポイントの範囲内です（confidenceInterval で報告される 90% CI）。ブートストラップの p 値は有意性を示します。p < 0.05 は、しきい値が「しきい値なし」の状態と統計的に区別できることを意味します。公表されている研究（Reinhart-Rogoff、Checherita-Westphal）では、先進国の債務／GDP 比のしきい値は 80～120% の範囲とされています。

ソブリン債務危機 MCP サーバーをスケジュール実行して、各国を継続的に監視できますか？ はい。Apify の組み込みスケジューラーを使って、スタンバイアクターを毎日または毎週実行するよう設定できます。主要な指標が変化したときにアラートを受け取れるよう、Webhook を設定してください。たとえば、equilibriumSpread が 400bps を超えた場合や、attackProbability が 0.5 を超えた場合に通知できます。5 分間のキャッシュはセッション単位のため、スケジュールされた実行ごとに、最新データから新しいネットワークが構築されます。

MIDAS 回帰では、一部の国で高頻度データが欠損している場合、どのように対処しますか？ MIDAS ツールは、実際の高頻度データがない場合、各ソブリンノードの cdsSpread 属性に合わせて調整した合成ジャンプ拡散 CDS パスを生成します。regimeSwitchingProb フィールドは、最近のシミュレーション済みパスとそれ以前のパスの比較から示される構造変化の度合いを表し、実際のティックデータがなくても、定性的なレジーム指標を提供します。

Eisenberg-Noe のクリアリング反復が収束しない場合はどうなりますか？ Scarf の減衰反復は最大 500 回まで実行されます。収束しない場合（fixedPointIterations: 500 を確認してください）、最後の反復値を使って結果が返されます。この状態は明示的には示されません。収束する場合、通常は 50～150 回で完了します。収束しない場合は、CDS エクスポージャーの循環性が極端に高いことを示しており、結果は正確なクリアリングベクトルではなく、桁の目安として扱ってください。

Acemoglu-Robinson モデルでは、国を民主主義、ハイブリッド、権威主義のいずれに分類しますか？ このモデルは、ソブリンの債務／GDP と CDS スプレッドの水準からジニ係数の代理値を推定し、2 つのしきい値を適用します。giniDemocratize = 0.42（これを超えると民主主義の安定性が脅かされます）と、giniCoup = 0.55（これを超えるとエリートによる抑圧が支配的になります）です。推定ジニ係数が 0.42 未満のソブリンは民主主義、0.42～0.55 の範囲はハイブリッド、0.55 を超える場合は権威主義に分類されます。その後の遷移確率は、Acemoglu-Robinson の不平等に基づく切り替えメカニズムに従います。 Cursor や GitHub Copilot などの AI コーディングアシスタントで、この MCP サーバーを使用できますか？ はい。MCP に対応したクライアントであれば、どれでも使用できます。Cursor では、MCP 設定にサーバー URL を追加すると、8 つのツールが利用可能な関数呼び出しとして表示されます。その後、Cursor の AI に「ユーロ圏の財政持続可能性分析を実行して」と依頼すると、適切なツール呼び出しが構築・実行され、構造化された結果がチャットに直接返されます。

改善にご協力ください

問題が発生した場合は、Apify アカウントで実行の共有を有効にすると、問題のデバッグをより迅速に進めるためにご協力いただけます。

1. アカウント設定 > プライバシーに移動します
2. 実行内容を公開 Actor の作成者と共有を有効にします

これにより、問題が発生した際に実行の詳細を確認できるため、問題をより迅速に修正できます。データを閲覧できるのは Actor の開発者のみであり、公開されることはありません。

サポート

バグを見つけた場合や機能をリクエストしたい場合は、この Actor のページにあるIssues タブで issue を作成してください。独自のソブリンリスクモデル、追加のデータソース、エンタープライズ向けの統合については、Apify プラットフォームからお問い合わせください。