Sovereign Debt Contagion & Geopolitical Risk
About
Sovereign debt contagion modelling and geopolitical risk analysis are now available as a single MCP server your AI agent can call directly.
Details
- Author
- apifyforge
- Downloads
- 108
- Categories
- Other
Jump to
- 4th-order tensor network construction from 18 parallel data sources
- Euler-Maruyama Monte Carlo with up to 10,000 paths and contagion shocks
- Bifurcation classification (saddle-node/Hopf/transcritical) for tipping point detection
- HHI × VaR commodity vulnerability scoring with four risk tiers
- Markov-switching currency crisis detection with Exchange Market Pressure index
- Modified IMF ARA reserve adequacy adjusted for crisis probability and geopolitical alignment
- Latent space geopolitical alignment via SVD, assigning countries to blocs
- Composite sovereign risk report with overall systemic risk score and recommendations
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Sovereign Debt Contagion & Geopolitical RiskCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add the server to an MCP-compatible client (e.g., Claude Desktop, Cursor, Windsurf) by configuring the server URL and your Apify API token as a Bearer token in the Authorization header. Once connected, your AI agent can call any of the 8 tools on demand. The server runs in Apify Standby mode and exposes an MCP endpoint at /mcp.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"sovereign debt contagion & geopolitical risk": {
"sovereign-debt-contagion-geopolitical-mcp": {
"url": "https://ryanclinton--sovereign-debt-contagion-geopolitical-mcp.apify.actor/mcp"
}
}
}
}
McpServers
{
"sovereign-debt-contagion-geopolitical-mcp": {
"url": "https://ryanclinton--sovereign-debt-contagion-geopolitical-mcp.apify.actor/mcp"
}
}
Sovereign Debt Contagion & Geopolitical MCP Server
> View on ApifyForge | Use on Apify Store
---
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf):
{
"mcpServers": {
"sovereign-debt-contagion-geopolitical-mcp": {
"url": "https://ryanclinton--sovereign-debt-contagion-geopolitical-mcp.apify.actor/mcp"
}
}
}
---
Sovereign debt contagion modelling and geopolitical risk analysis are now available as a single MCP server your AI agent can call directly. This server gives Claude, Cursor, and any MCP-compatible client 8 quantitative finance tools that fuse live data from 18 international sources — IMF, World Bank, OECD, Eurostat, FRED, BLS, UN COMTRADE, exchange rate feeds, CoinGecko, OFAC, OpenSanctions, Interpol, World Bank Projects, Grants.gov, USAspending, and GDACS — into institutional-grade sovereign risk models. The result is a fully automated pipeline from raw macroeconomic data to crisis probability scores, contagion chains, tipping point detection, and geopolitical alignment maps.
The server implements seven distinct quantitative algorithms: a 4th-order tensor CP decomposition for network structure, Euler-Maruyama Monte Carlo simulation of coupled sovereign debt SDEs, Jacobian-based bifurcation analysis, HHI-weighted commodity vulnerability with 95th-percentile VaR, Markov-switching currency crisis detection via the Hamilton filter, a modified IMF Assessing Reserve Adequacy metric, and latent space ideal point estimation via SVD for geopolitical positioning. Each tool runs the relevant data collection actors in parallel, calibrates the model from live data, and returns structured analytical output in seconds.
What data can you access?
| Data Point | Source | Example Value |
|---|---|---|
| 📊 Debt-to-GDP ratio, growth, interest rates | IMF World Economic Outlook | Argentina: 89.4% debt/GDP |
| 🌐 Development indicators, governance scores | World Bank | GR governance percentile: 61.2 |
| 📈 International economic statistics | OECD | Germany primary balance: +1.2% GDP |
| 🇪🇺 EU fiscal and monetary statistics | Eurostat | IT general government debt: 144.7% |
| 🏦 US monetary indicators (FEDFUNDS, GDP, GFDEBTN) | FRED | Fed Funds rate: 5.33% |
| 👷 CPI and unemployment time series | BLS | US CPI: 3.2%, Unemployment: 3.7% |
| 🚢 Bilateral trade flows by commodity | UN COMTRADE | US-CN goods trade: $575B |
| 💱 Live foreign exchange rates | Exchange Rate Tracker | USD/ARS: 839.5 |
| 📉 Historical FX time series | Exchange Rate History | TRY 12-month depreciation: 38% |
| 🏛️ ECB reference rates (EUR/major pairs) | ECB Rates | EUR/USD: 1.0847 |
| ₿ Cryptocurrency prices and volumes | CoinGecko | BTC volume spike: +240% (VE) |
| 🚫 OFAC sanctions and blocked entities | OFAC | RU sovereign entities: 412 |
| 🌍 Global sanctions and PEP registries | OpenSanctions | CN state-owned: 89 entries |
| 🔴 Interpol red notices and fugitives | Interpol | Active notices: 7,241 |
| 🏗️ World Bank development project aid | World Bank Projects | EG commitments: $2.1B |
| 💰 US federal grants (foreign aid) | Grants.gov | USAID awards: 1,847 |
| 🇺🇸 Federal spending and foreign assistance | USAspending | Foreign assistance FY24: $62B |
| 🌊 Global disaster alerts and risk events | GDACS | PK flood severity: Orange |
MCP tools
| Tool | Algorithm | Best For | Approx. Cost |
|------|-----------|----------|--------------|
| build_sovereign_exposure_network | 4th-order tensor CP decomposition (ALS) | Initial network construction; prerequisite for simulations | $0.05/call |
| simulate_debt_crisis_cascade | Euler-Maruyama coupled SDE Monte Carlo (up to 10,000 paths) | Default probabilities, contagion chains, systemic risk score | $0.055/call |
| detect_bifurcation_points | Jacobian eigenvalues via power iteration; saddle-node/Hopf/transcritical classification | Tipping point proximity, parameter sensitivity | $0.05/call |
| compute_commodity_vulnerability | HHI of export basket × 95th-pct VaR, scaled by commodity exports/GDP | Dutch disease, resource curse, commodity shock exposure | $0.045/call |
| detect_currency_crisis_signal | Markov-switching two-regime model (Hamilton filter); EMP index | Early warning of currency crises, capital flight detection | $0.045/call |
| assess_reserve_adequacy | Modified IMF ARA adjusted for crisis probability and geopolitical alignment | IMF-style reserve buffer assessment | $0.04/call |
| map_geopolitical_alignment | Latent space ideal point estimation via SVD (DW-NOMINATE style) | Bloc assignments, geopolitical distance matrix | $0.05/call |
| generate_sovereign_risk_report | Full 7-algorithm pipeline with composite risk score and recommendations | Portfolio stress testing, comprehensive sovereign assessment | $0.05/call |
Why use Sovereign Debt Contagion & Geopolitical MCP Server?
Building sovereign risk models manually means assembling data from a dozen international databases, normalising currencies and time periods, writing the SDE discretisation code, implementing tensor decomposition, and interpreting bifurcation diagrams — a project that takes a quantitative analyst weeks and requires Bloomberg Terminal or Refinitiv licenses running $20,000-30,000 per year.
This MCP server eliminates that entirely. Your AI agent calls a single tool, the server fetches fresh data from 18 public sources in parallel, runs the calibrated model, and returns structured analytical results. No data sourcing. No numerical methods implementation. No subscription required.
- Scheduling — run daily or weekly sovereign monitoring for a country portfolio via Apify's built-in task scheduler
- API access — trigger the server from Python, JavaScript, or any MCP-compatible client, including Claude and Cursor
- Parallel data collection — all 18 actors run simultaneously; total data collection time is bounded by the slowest single source, not the sum
- Monitoring — configure Slack or email alerts when runs fail via Apify's notification system
- Integrations — connect results to Zapier, Make, Google Sheets, or webhooks for downstream reporting pipelines
Features
…
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



