Koskamo

NERAI MCP

A hosted MCP server providing geopolitical risk intelligence for AI agents. It exposes tools to query country risk indices, calibrated shock forecasts, maritime corridor status, sanctions overviews, and trade-control changes. The server is read-only, ensuring agents can retrieve live platform data with methodology and as-of dates without executing write operations.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

NERAI MCP logo, by NERAICommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by NERAI
You need:Authorization: Bearer — free key: POST /register {"email": "you@co.com"}
MCP endpoint (Streamable HTTP)
https://nerai-mcp.neraicorp.workers.dev/mcp
Vendor documentation

What its tools do

16 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (16)

16 of 16 have a description · 16 of 16 declare behavior hints · 7 of 8 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Query country risk indices and calibrated shock forecasts
  • Monitor maritime corridor threat and activity scores
  • Check latest official trade-control and sanctions changes
  • Retrieve open calibrated forecasts on geopolitical risk

Source and maintenance

Community listingRegistry 1.1.0
mcp-registry: io.github.serkvay13/nerai-mcp@1.1.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
nerai-risk-intelligence 1.0.0
MCP protocol negotiated in check
2025-06-18
Tools
16 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

NERAI risk-intelligence data: 2,400 daily risk series (60 countries x 40 topics) with regime states and calibrated shock forecasts (OOS calibration error ~1%), a Granger causal network, platform-wide early warning, cross-country comparison, maritime & circumvention corridors, supply-chain and open-source commodity layers (EIA, World Bank), the Forecast Desk, and official trade-control change tracking. Percentiles rank each series against its own history — 90+ means historically elevated. Data is not legal or investment advice.

Tools

16 advertised

list_countries — List countries
Advertised by the server during the last successful anonymous check.
Advertised read-only

List the 60 countries covered by NERAI's daily risk indices (code + name), plus platform metadata (as-of dates, calibration).

list_countries input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
list_countries annotations
{
  "title": "List countries",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_country_risk — Get country risk
Advertised by the server during the last successful anonymous check.
Advertised read-only

Full NERAI risk read for one country: HMM regime state (Calm/Tension/Crisis with escalation probability and persistence), resilience score, and risk topics as percentiles of the 30-day average vs each series' own history (now / 90d ago / delta), with calibrated shock probabilities at 4/9/13/26-week horizons. Returns the 8 most elevated topics by default; set all_topics=true for all 40, or pass topic to filter.

get_country_risk input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "Filter to topics matching this text (e.g. 'protest', 'military')."
    },
    "country": {
      "type": "string",
      "description": "Country code (e.g. NI, IR, TU) or name (e.g. Nigeria)."
    },
    "all_topics": {
      "type": "boolean",
      "description": "Return all 40 risk topics instead of the top 8."
    }
  },
  "additionalProperties": false
}
get_country_risk annotations
{
  "title": "Get country risk",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_causal_drivers — Get causal drivers
Advertised by the server during the last successful anonymous check.
Advertised read-only

NERAI's causal network for a country: Granger-significant lead-lag relationships (p<0.01) showing which risk signals lead which others, with the lag in days and F-statistic. Use to explain WHY a risk is building, not just that it is.

get_causal_drivers input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "Country code or name."
    }
  },
  "additionalProperties": false
}
get_causal_drivers annotations
{
  "title": "Get causal drivers",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_early_warning — Get early warning
Advertised by the server during the last successful anonymous check.
Advertised read-only

Platform-wide early warning: the series with the highest calibrated shock probabilities right now, and the biggest 90-day percentile movers (risers and fallers) across all 60 countries. The fastest way to ask 'what should I be watching?'

get_early_warning input schema
{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max rows per list (default 15, max 40)."
    }
  },
  "additionalProperties": false
}
get_early_warning annotations
{
  "title": "Get early warning",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
compare_countries — Compare countries
Advertised by the server during the last successful anonymous check.
Advertised read-only

Rank countries on a given risk topic by current percentile, with the 90-day change and regime state. Use for portfolio or footprint screening (e.g. 'rank protest risk across our markets').

compare_countries input schema
{
  "type": "object",
  "required": [
    "topic"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max rows (default 15)."
    },
    "topic": {
      "type": "string",
      "description": "Risk topic, e.g. protest, military_clash, political_instability, terrorism."
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional subset of codes/names; omit to rank all 60."
    }
  },
  "additionalProperties": false
}
compare_countries annotations
{
  "title": "Compare countries",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_supply_chain_risk — Get supply-chain risk
Advertised by the server during the last successful anonymous check.
Advertised read-only

Global supply-chain picture: NY Fed GSCPI (with its required notice), country disruption readings and NERAI's supply-disruption forecast board. Chokepoint transit series are not included in this edition (chokepoint_transits is null).

get_supply_chain_risk input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_supply_chain_risk annotations
{
  "title": "Get supply-chain risk",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_commodities — Get commodity markets
Advertised by the server during the last successful anonymous check.
Advertised read-only

Benchmark commodity prices from licensed open sources: U.S. EIA daily spot (Brent, WTI, Henry Hub; public domain) with 7- and 30-day changes, and World Bank Pink Sheet monthly averages (European gas, wheat, maize, urea; CC BY 4.0) with the month-on-month change. Each row carries its source and frequency.

get_commodities input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_commodities annotations
{
  "title": "Get commodity markets",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_sanctions_overview — Get sanctions overview
Advertised by the server during the last successful anonymous check.
Advertised read-only

The sanctions picture in one call: restricted-party register counts by list and type, the Russia shadow-fleet enforcement index, Russia economic-impact measures and recent enforcement actions.

get_sanctions_overview input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_sanctions_overview annotations
{
  "title": "Get sanctions overview",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_live_chokepoint_traffic — Get live chokepoint traffic
Advertised by the server during the last successful anonymous check.
Advertised read-only

Chokepoint vessel picture from licensed sources. Live AIS vessel counts are NOT available in this edition (available=false, counts null). Where published, the Strait of Hormuz carries Copernicus Sentinel-1 radar vessel presence (30-day rolling, % vs the 2025 same-orbit baseline): vessels present in radar scenes, not transits.

get_live_chokepoint_traffic input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_live_chokepoint_traffic annotations
{
  "title": "Get live chokepoint traffic",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_maritime_corridors — Get maritime corridors
Advertised by the server during the last successful anonymous check.
Advertised read-only

Risk state of the 8 monitored maritime corridors (Hormuz, Suez, Red Sea/Bab-el-Mandeb, Black Sea, Malacca, Taiwan Strait, E. Mediterranean, South China Sea): GDELT-based threat/activity scores, phase, news and sanctions intensity, NERAI read. Transit and cost-pressure fields are kept for compatibility but are null in this edition.

get_maritime_corridors input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_maritime_corridors annotations
{
  "title": "Get maritime corridors",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_circumvention_corridors — Get circumvention corridors
Advertised by the server during the last successful anonymous check.
Advertised read-only

NERAI CHPL circumvention-corridor intensity scores (0-100, ordinal) for Russia-bound diversion routes of controlled microelectronics, with goods and watch items.

get_circumvention_corridors input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_circumvention_corridors annotations
{
  "title": "Get circumvention corridors",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_forecast_desk — Get forecast desk
Advertised by the server during the last successful anonymous check.
Advertised read-only

NERAI's open calibrated forecasts (binary questions with probabilities and horizons) across sanctions, geopolitical risk, chokepoints, maritime, supply-chain and conflict. Every open question is re-scored every 2 days, so each one carries its probability history, the change since it was filed and since the last review, and the reason the latest review gave. Set include_archive to also return closed questions (resolved, past-horizon and retired) with their full trajectories.

get_forecast_desk input schema
{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Optional filter: sanctions, geopolitical-risk, chokepoints, maritime, supply-chain, military-conflict or modern-mercantilism."
    },
    "movers_only": {
      "type": "boolean",
      "description": "Only forecasts repriced by 2pp or more at the latest review."
    },
    "include_archive": {
      "type": "boolean",
      "description": "Also return closed forecasts (resolved / past horizon / retired)."
    }
  },
  "additionalProperties": false
}
get_forecast_desk annotations
{
  "title": "Get forecast desk",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
check_commodity_controls — Check commodity controls
Advertised by the server during the last successful anonymous check.
Advertised read-only

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. Requires a six-digit code: a four-digit heading returns the CHPL subheadings it contains and asks for HS6, because the goods within one heading differ materially and NERAI does not infer a classification it was not given.

check_commodity_controls input schema
{
  "type": "object",
  "required": [
    "hs_code"
  ],
  "properties": {
    "hs_code": {
      "type": "string",
      "description": "HS code, ideally six digits (e.g. 854233)."
    }
  },
  "additionalProperties": false
}
check_commodity_controls annotations
{
  "title": "Check commodity controls",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
find_enforcement_precedent — Find comparable enforcement cases
Advertised by the server during the last successful anonymous check.
Advertised read-only

Published enforcement actions (ECJU compound settlements, OFSI penalties, BIS denial orders, OFAC civil penalties) that share features with a described shipment. A case qualifies only if it shares the commodity or the behaviour AND the destination or route — shared geography alone is not a precedent. Returns the shared features and a link to the authority's own published action. The score counts shared features; it is not a probability.

find_enforcement_precedent input schema
{
  "type": "object",
  "properties": {
    "transit": {
      "type": "string"
    },
    "red_flag": {
      "type": "string",
      "description": "e.g. third-country routing, concealment / false documents."
    },
    "destination": {
      "type": "string"
    },
    "product_family": {
      "type": "string",
      "description": "e.g. Semiconductors & electronics, Aviation & aerospace, Dual-use & military."
    },
    "include_unreviewed": {
      "type": "boolean",
      "description": "Include auto-extracted cases. Default false: unreviewed cases must not be quoted to a client."
    }
  },
  "additionalProperties": false
}
find_enforcement_precedent annotations
{
  "title": "Find comparable enforcement cases",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_transaction_intelligence_status — Get transaction intelligence coverage
Advertised by the server during the last successful anonymous check.
Advertised read-only

What NERAI's transaction layer currently covers: register size and per-source health, enforcement corpus size by authority, CHPL vintage, and which checks require the platform rather than this connector. Use it to know what a full assessment would add.

get_transaction_intelligence_status input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_transaction_intelligence_status annotations
{
  "title": "Get transaction intelligence coverage",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_tradecontrol_changes — Get trade-control changes
Advertised by the server during the last successful anonymous check.
Advertised read-only

Latest official trade-control / sanctions changes from the NERAI TradeControl Action Desk: UK Sanctions List & US CSL diffs and CELEX-anchored EU Official Journal acts, each with legal instrument and source link.

get_tradecontrol_changes input schema
{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max records (default 10, max 25)."
    },
    "jurisdiction": {
      "type": "string",
      "description": "Optional filter: UK, US or EU."
    }
  },
  "additionalProperties": false
}
get_tradecontrol_changes annotations
{
  "title": "Get trade-control changes",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
381 ms
95th percentile latency
381 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 381 ms · metadata changed · 16 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http nerai-mcp https://nerai-mcp.neraicorp.workers.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add nerai-mcp --url https://nerai-mcp.neraicorp.workers.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable nerai-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "nerai-mcp": {
      "url": "https://nerai-mcp.neraicorp.workers.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "nerai-mcp": {
      "type": "streamableHttp",
      "url": "https://nerai-mcp.neraicorp.workers.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start nerai-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "nerai-mcp": {
      "type": "http",
      "url": "https://nerai-mcp.neraicorp.workers.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http nerai-mcp https://nerai-mcp.neraicorp.workers.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://nerai-mcp.neraicorp.workers.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "nerai-mcp": {
      "serverUrl": "https://nerai-mcp.neraicorp.workers.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like NERAI MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 6,366