Nerai Mcp

io.github.serkvay13Published by GitHub account serkvay13v1.1.0Updated Oct 25, 2026

Geopolitical grounding for AI agents: country risk, forecasts, chokepoints, sanctions. Free tier.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote NERAI server giving an assistant country risk indices, calibrated forecasts, maritime chokepoint and sanctions/trade-control data for 60 countries.

What you can do
  • List covered countries and read one country's risk regime, resilience and shock probabilities
  • Explain risk drivers through causal lead-lag relationships and rank countries on a risk topic
  • Get platform-wide early warnings and open calibrated forecasts with probability history
  • Read supply-chain disruption, commodity benchmark prices and maritime corridor risk states
  • Look up sanctions registers, trade-control changes, HS-code commodity controls and enforcement precedents
  • Check what the transaction layer covers and which checks need the full platform
When to use it
Useful when an assistant has to ground procurement, trading or compliance decisions in current geopolitical and trade-control context, such as screening supplier countries, watching chokepoints or citing official sanctions changes.
Requirements
Remote Streamable HTTP endpoint; no local install. A bearer key in the Authorization header is required, obtained by registering an email address with the service; clients without a header field can put the key in the URL path. Network access to the provider's endpoint.
Before you install
Registration requires submitting an email address to the provider. The free tier covers only 5 countries and 100 calls per month; paid tiers are listed at €490/month and up. Some data is explicitly unavailable in this edition, such as live AIS vessel counts and chokepoint transits. Output is not legal or investment advice.

Installation

In SourceWeft

  1. Open Nerai Mcp in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.serkvay13%2Fnerai-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "nerai": {
      "type": "http",
      "url": "https://nerai-mcp.neraicorp.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

NERAI Risk Intelligence — MCP Server

The geopolitical grounding layer for AI agents. Your procurement, trading or compliance agent knows your systems; it does not know the world. NERAI is the world, as a tool call — 60 countries, calibrated forecasts, maritime chokepoints, sanctions and trade-control data, every answer source-linked and dated.

[MCP Registry] [Free key] [Pricing]

[Nerai MCP server]

Remote MCP server (Streamable HTTP) — no install, no local process:

https://nerai-mcp.neraicorp.workers.dev/mcp

Quick start

Get a free key instantly (no card, no call):

bash
curl -X POST https://nerai-mcp.neraicorp.workers.dev/register \  -H 'content-type: application/json' -d '{"email":"[email protected]"}'

Connect from Claude Code (any MCP client works the same way):

bash
claude mcp add nerai --transport http https://nerai-mcp.neraicorp.workers.dev/mcp \  --header "Authorization: Bearer <your-key>"

Clients without a header field (e.g. Claude.ai custom connectors): https://nerai-mcp.neraicorp.workers.dev/mcp/<your-key>

What your agent gets

16 tools across five layers:

LayerTools
Country risklist_countries · get_country_risk · compare_countries · get_causal_drivers
Foresightget_forecast_desk (re-scored every 2 days, Brier-tracked) · get_early_warning
Supply chainget_supply_chain_risk · get_commodities
Maritimeget_maritime_corridors · get_live_chokepoint_traffic (live AIS) · get_circumvention_corridors
Trade controlsget_sanctions_overview · get_tradecontrol_changes · check_commodity_controls · find_enforcement_precedent · get_transaction_intelligence_status

Ask it something real

Once connected, try these in your agent:

"Which of these supplier countries deteriorated this month: Turkey, Kazakhstan, Egypt?" "What is the live vessel count in the Strait of Hormuz versus baseline?" "What changed in the UK and EU trade-control registers this week? Cite the legal instruments." "Compare the risk trajectory of Poland and Romania over the next 13 weeks."

Why this one

  • Validation is published, not promised. Out-of-sample MASE 0.85–0.95 and 61–67% directional accuracy across 4–52 week horizons. Ask your data vendor for their Brier score — we publish ours.
  • Agent-safe by contract. Every response carries _meta: as_of, source, refresh cadence and limitations. An agent cannot ask a follow-up question, so the answer states its own age and limits. That block is also your audit trail.
  • Enforcement precedents are human-reviewed. Client-facing tools return only analyst-signed cases, each linking the authority's own document.

Endpoints

  • GET /pricing — machine-readable tier table (free / pro / enterprise)
  • GET /llms.txt — agent-readable capability sheet
  • GET /openapi.json — transport spec with the full tool catalogue
  • POST /register — instant free key

Recipes

Copy-paste agent patterns in recipes/: a procurement agent that checks the world before re-ordering, a trading agent grounded in world state, and a compliance agent that cites official sources and leaves signing to a human.

Pricing

Free (5 countries, 100 calls/mo) · Pro €490/mo or €4,900/yr (all 60 countries, 100k calls) · Enterprise from €15,000/yr (HS-level commodity checks, reviewed precedent corpus, SLA). Details: neraicorp.com/ai-agents.html

Not legal or investment advice. Built and operated by NERAI BV, Brussels. Contact: [email protected]

Source: README.md at commit 06bb274

Tools

16

list_countries

List countries

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

Takes no parameters.

get_country_risk

Get country risk

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.

Parameterstopiccountryrequiredall_topics

get_causal_drivers

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 the lag in days and F-statistic. Use to explain WHY a risk is building, not just that it is.

Parameterscountryrequired

get_early_warning

Get early warning

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?'

Parameterslimit

compare_countries

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 screening (e.g. 'rank protest risk across our markets').

Parameterslimittopicrequiredcountries

get_supply_chain_risk

Get supply-chain risk

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).

Takes no parameters.

get_commodities

Get commodity markets

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.

Takes no parameters.

get_sanctions_overview

Get sanctions overview

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.

Takes no parameters.

get_live_chokepoint_traffic

Get live chokepoint traffic

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.

Takes no parameters.

get_maritime_corridors

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, 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.

Takes no parameters.

get_circumvention_corridors

Get circumvention corridors

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

Takes no parameters.

get_forecast_desk

Get forecast desk

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.

Parameterscategorymovers_onlyinclude_archive

check_commodity_controls

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. 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.

Parametershs_coderequired

find_enforcement_precedent

Find comparable enforcement cases

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.

Parameterstransitred_flagdestinationproduct_familyinclude_unreviewed

get_transaction_intelligence_status

Get transaction intelligence coverage

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.

Takes no parameters.

get_tradecontrol_changes

Get trade-control changes

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.

Parameterslimitjurisdiction

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.