# NERAI Risk Intelligence MCP Server

Geopolitical grounding layer for AI agents: 60 countries x 40 risk topics, daily series,
calibrated shock forecasts (published out-of-sample validation), regime states, early warning,
maritime chokepoints with live AIS, circumvention corridors, sanctions overview, official
trade-control change tracking and an analyst-reviewed enforcement precedent corpus.

Endpoint: POST https://nerai-mcp.neraicorp.workers.dev/mcp (MCP Streamable HTTP, JSON-RPC 2.0)
Auth: Authorization: Bearer <key> — free key: POST /register {"email": "you@co.com"}
Pricing: GET /pricing · Spec: GET /openapi.json

Every tool response includes _meta: as_of, source, refresh_cadence, limitations.
Not legal or investment advice.

Tools:
- list_countries: List the 60 countries covered by NERAI's daily risk indices (code + name), plus platform metadata (as-of dates, calibration).
- get_country_risk: Full NERAI risk read for one country: HMM regime state (Calm/Tension/Crisis with escalation probability and persistence), resilience score, 
- get_causal_drivers: NERAI's causal network for a country: Granger-significant lead-lag relationships (p<0.01) showing which risk signals lead which others, with
- get_early_warning: Platform-wide early warning: the series with the highest calibrated shock probabilities right now, and the biggest 90-day percentile movers 
- compare_countries: Rank countries on a given risk topic by current percentile, with the 90-day change and regime state. Use for portfolio or footprint screenin
- get_supply_chain_risk: Global supply-chain picture: NY Fed GSCPI, chokepoint transit levels, country disruption readings and NERAI's supply-disruption forecast boa
- get_commodities: Benchmark commodity and market levels tracked by NERAI (crude, gas, metals, gold, volatility) with 7-day and 30-day changes — the financial 
- get_sanctions_overview: The sanctions picture in one call: restricted-party register counts by list and type, the Russia shadow-fleet enforcement index, Russia econ
- get_live_chokepoint_traffic: Live AIS sample per chokepoint: vessels currently in each geofence split tanker/cargo/other, plus sanctioned-fleet observations. Counts are 
- get_maritime_corridors: Risk state of the 8 monitored maritime corridors (Hormuz, Suez, Red Sea/Bab-el-Mandeb, Black Sea, Malacca, Taiwan Strait, E. Mediterranean, 
- get_circumvention_corridors: NERAI CHPL circumvention-corridor intensity scores (0-100, ordinal) for Russia-bound diversion routes of controlled microelectronics, with g
- get_forecast_desk: NERAI's open calibrated forecasts (binary questions with probabilities and horizons) across sanctions, geopolitical risk, chokepoints, marit
- check_commodity_controls: Look up an HS code against the Common High Priority List — the goods the US, EU, UK and Japan jointly identify as most frequently diverted. 
- find_enforcement_precedent: Published enforcement actions (ECJU compound settlements, OFSI penalties, BIS denial orders, OFAC civil penalties) that share features with 
- get_transaction_intelligence_status: What NERAI's transaction layer currently covers: register size and per-source health, enforcement corpus size by authority, CHPL vintage, an
- get_tradecontrol_changes: Latest official trade-control / sanctions changes from the NERAI TradeControl Action Desk: UK Sanctions List & US CSL diffs and CELEX-anchor