Country Risk Copilot MCP

AI agent tool for market entry decisions, sanctions screening, country comparison, and supply chain risk assessment.

Verdicts: GO | CAUTION | AVOID

Data Sources:

• OFAC SDN List (US Treasury) — Sanctions screening
• World Bank API — Economic indicators (GDP growth, inflation, unemployment, rule of law)
• USGS Earthquake Catalog — Natural disaster risk
• REST Countries — Basic geographic/demographic data

Features

Tool 1: assess_market_entry

Full market assessment with verdicts and risk scores.

{
  "tool": "assess_market_entry",
  "country": "Vietnam",
  "industry": "manufacturing"
}

Output:

• verdict: GO | CAUTION | AVOID
• confidence: HIGH | MEDIUM | LOW
• summary: Executive summary
• recommendation: Action items
• riskFactors: List of identified risks
• scores: { sanctions, economic, political, natural, overall }

Tool 2: can_we_operate_in

Fast OFAC-only check (no economic assessment).

{
  "tool": "can_we_operate_in",
  "country": "Iran",
  "operationType": "trade"
}

Output:

• canOperate: true | false
• reason: Sanction program name (if blocked)
• riskLevel: CLEAR | CRITICAL
• action: Compliance guidance

Tool 3: compare_markets

Parallel assessment and ranking.

{
  "tool": "compare_markets",
  "countries": ["Vietnam", "Mexico", "India"],
  "criteria": "manufacturing"
}

Output:

• ranked: [{ rank, country, verdict, score, highlight }]
• recommendation: Strategic guidance

Tool 4: supply_chain_risk_scan

Comprehensive supply chain exposure assessment.

{
  "tool": "supply_chain_risk_scan",
  "countries": ["China", "Taiwan", "Vietnam", "Malaysia"],
  "context": "Electronics manufacturing supply chain"
}

Output:

• totalCountries: number
• critical: count of AVOID verdicts
• highRisk: count of CAUTION verdicts
• lowRisk: count of GO verdicts
• results: [{ country, verdict, score, riskFactors }]
• diversificationAdvice: Strategic recommendation

Tool 5: market_risk_report

Comprehensive text report (brief or full).

{
  "tool": "market_risk_report",
  "country": "Brazil",
  "format": "brief"
}

Output:

• verdict: GO | CAUTION | AVOID
• executiveReport: Markdown-formatted report

Scoring Logic

Sanctions Risk Score (0-100)

• No sanctions: 100 (good)
• OFAC-sanctioned: 20 (critical)

Economic Risk Score (0-100)

Based on:

• Inflation (target: < 8%)
• Unemployment (target: < 5%)
• GDP growth (target: > 1%)
• FDI % of GDP
• Rule of law index

Natural Disaster Risk Score (0-100)

Based on:

• Earthquake frequency (1-year rolling)
• Maximum magnitude
• Average magnitude

Overall Score (0-100)

Weighted: Sanctions 40% + Economic 35% + Natural 25%

Verdict Logic

function calcVerdict(scores) {
  if (scores.sanctions < 30 || scores.overall < 35) return 'AVOID';
  if (scores.overall < 60 || scores.political < 40 || scores.economic < 40) return 'CAUTION';
  return 'GO';
}

API Timeouts

• World Bank API: 30s (fallback to null if timeout)
• REST Countries: 15s
• USGS Earthquakes: 30s
• Graceful degradation: Scores calculated with available data

OFAC Sanctioned Countries

Iran, Cuba, North Korea (DPRK), Syria, Russia, Belarus, Venezuela, Myanmar, Zimbabwe

Example Workflows

1. Quick Sanctions Check

curl -X POST https://api.apify.com/v2/acts/~country-risk-copilot-mcp/runs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"tool":"can_we_operate_in","country":"Iran"}'

Expected: canOperate: false

2. Market Entry Decision

curl -X POST https://api.apify.com/v2/acts/~country-risk-copilot-mcp/runs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"tool":"assess_market_entry","country":"Vietnam","industry":"manufacturing"}'

Expected: verdict: GO or CAUTION with risk breakdown

3. Compare Three Markets

curl -X POST https://api.apify.com/v2/acts/~country-risk-copilot-mcp/runs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"tool":"compare_markets","countries":["Vietnam","Mexico","India"]}'

Expected: Ranked list with scores

4. Supply Chain Audit

curl -X POST https://api.apify.com/v2/acts/~country-risk-copilot-mcp/runs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"tool":"supply_chain_risk_scan","countries":["China","Taiwan","Vietnam","Malaysia"]}'

Expected: Risk breakdown + diversification advice

5. Executive Report

curl -X POST https://api.apify.com/v2/acts/~country-risk-copilot-mcp/runs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"tool":"market_risk_report","country":"Brazil","format":"full"}'

Expected: Markdown report with detailed breakdown

Data Sources & Attribution

Source	License	Link
OFAC SDN	Public Domain (US Treasury)	treasury.gov/ofac
World Bank API	CC-BY 4.0	data.worldbank.org
USGS Earthquakes	Public Domain	earthquake.usgs.gov
REST Countries	MPL 2.0	restcountries.com

Version History

• 1.0 (2024-03) — Initial release with 5 tools, OFAC integration, World Bank & USGS data