Nerai Mcp

io.github.serkvay13由 GitHub 帳號 serkvay13 發布v1.1.0更新於 Oct 25, 2026

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

已驗證Streamable HTTP可網頁執行金融資料與分析商業與電商

概覽

AI 產生的概覽

遠端 NERAI 伺服器，讓助理取得 60 個國家的風險指數、校準預測、海上咽喉要道，以及制裁與貿易管制資料。

可以做什麼
  • 列出涵蓋國家，並讀取單一國家的風險狀態、韌性與衝擊機率
  • 透過因果領先落後關係解釋風險成因，並依風險主題為國家排名
  • 取得平台層級早期預警，以及附機率歷史的公開校準預測
  • 讀取供應鏈中斷情況、大宗商品基準價格與海上走廊風險狀態
  • 查詢制裁名單、貿易管制變更、HS 代碼商品管制與執法先例
  • 查看交易層涵蓋範圍，以及哪些檢查需要完整平台
適用情境
適合需要把採購、交易或法遵判斷建立在當前地緣政治與貿易管制背景的情境，例如篩選供應國、關注咽喉要道或引用官方制裁變更。
執行需求
遠端 Streamable HTTP 端點，無需本機安裝。必須在 Authorization 標頭提供 bearer 金鑰，透過向服務註冊電子郵件取得；不支援標頭的用戶端可將金鑰放入 URL 路徑。需要能連線至提供方端點的網路。
安裝前請注意
註冊需向提供方提交電子郵件地址。免費方案僅涵蓋 5 個國家、每月 100 次呼叫；付費方案標價為每月 490 歐元起。部分資料在此版本中明確不可用，例如即時 AIS 船舶計數與咽喉要道通行量。輸出不構成法律或投資建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Nerai Mcp，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.serkvay13%2Fnerai-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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]

來源：README.md，提交 06bb274

工具

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

無需輸入參數。

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.

輸入參數topiccountry必填all_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.

輸入參數country必填

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

輸入參數limit

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

輸入參數limittopic必填countries

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

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

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.

輸入參數categorymovers_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.

輸入參數hs_code必填

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.

輸入參數transitred_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.

無需輸入參數。

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.

輸入參數limitjurisdiction

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。