Skip to content

io.github.serkvay13/nerai-mcp

by serkvay13 · remote · no sign-in to list tools · v1.1.0 · published by GitHub user serkvay13

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

Changes · 1
CompareRegistry entry

16 tools: 1 change things and 15 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http nerai https://nerai-mcp.neraicorp.workers.dev/mcp --header 'Authorization: <your-authorization>'

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

16 tools

Changes things 1Claude Code: ask
  • check_commodity_controlsLook up an HS code against the Common High Priority List — the goods the US, EU, UK and Japan jointly identify as most frequently diverted.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Check commodity controls
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
Only reads 15Claude Code: allow
  • compare_countriesRank countries on a given risk topic by current percentile, with the 90-day change and regime state.No findings

    Why it is in this group

    • The name "compare_countries" says "compare": a word for reading.
    Description, as the server wrote it
    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').

    Annotations the server declares

    • title: Compare countries
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • find_enforcement_precedentPublished enforcement actions (ECJU compound settlements, OFSI penalties, BIS denial orders, OFAC civil penalties) that share features with a described shipment.No findings

    Why it is in this group

    • The name "find_enforcement_precedent" says "find": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Find comparable enforcement cases
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_causal_driversNERAI'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.No findings

    Why it is in this group

    • The name "get_causal_drivers" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get causal drivers
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_circumvention_corridorsNERAI CHPL circumvention-corridor intensity scores (0-100, ordinal) for Russia-bound diversion routes of controlled microelectronics, with goods and watch items.No findings

    Why it is in this group

    • The name "get_circumvention_corridors" says "get": a word for reading.
    Description, as the server wrote it
    NERAI CHPL circumvention-corridor intensity scores (0-100, ordinal) for Russia-bound diversion routes of controlled microelectronics, with goods and watch items.

    Annotations the server declares

    • title: Get circumvention corridors
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_commoditiesBenchmark commodity prices from licensed open sources: U.S.No findings

    Why it is in this group

    • The name "get_commodities" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get commodity markets
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_country_riskFull 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…No findings

    Why it is in this group

    • The name "get_country_risk" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get country risk
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_early_warningPlatform-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 count…No findings

    Why it is in this group

    • The name "get_early_warning" says "get": a word for reading.
    Description, as the server wrote it
    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?'

    Annotations the server declares

    • title: Get early warning
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_forecast_deskNERAI's open calibrated forecasts (binary questions with probabilities and horizons) across sanctions, geopolitical risk, chokepoints, maritime, supply-chain and conflict.No findings

    Why it is in this group

    • The name "get_forecast_desk" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get forecast desk
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_live_chokepoint_trafficChokepoint vessel picture from licensed sources.No findings

    Why it is in this group

    • The name "get_live_chokepoint_traffic" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get live chokepoint traffic
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_maritime_corridorsRisk state of the 8 monitored maritime corridors (Hormuz, Suez, Red Sea/Bab-el-Mandeb, Black Sea, Malacca, Taiwan Strait, E.No findings

    Why it is in this group

    • The name "get_maritime_corridors" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get maritime corridors
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_sanctions_overviewThe 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 enforcem…No findings

    Why it is in this group

    • The name "get_sanctions_overview" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get sanctions overview
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_supply_chain_riskGlobal supply-chain picture: NY Fed GSCPI (with its required notice), country disruption readings and NERAI's supply-disruption forecast board.No findings

    Why it is in this group

    • The name "get_supply_chain_risk" says "get": a word for reading.
    Description, as the server wrote it
    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).

    Annotations the server declares

    • title: Get supply-chain risk
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_tradecontrol_changesLatest 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 l…No findings

    Why it is in this group

    • The name "get_tradecontrol_changes" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get trade-control changes
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_transaction_intelligence_statusWhat 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 rath…No findings

    Why it is in this group

    • The name "get_transaction_intelligence_status" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get transaction intelligence coverage
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • list_countriesList the 60 countries covered by NERAI's daily risk indices (code + name), plus platform metadata (as-of dates, calibration).No findings

    Why it is in this group

    • The name "list_countries" says "list": a word for reading.
    Description, as the server wrote it
    List the 60 countries covered by NERAI's daily risk indices (code + name), plus platform metadata (as-of dates, calibration).

    Annotations the server declares

    • title: List countries
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.1.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http nerai https://nerai-mcp.neraicorp.workers.dev/mcp --header 'Authorization: <your-authorization>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__nerai__list_countries",
      "mcp__nerai__get_country_risk",
      "mcp__nerai__get_causal_drivers",
      "mcp__nerai__get_early_warning",
      "mcp__nerai__compare_countries",
      "mcp__nerai__get_supply_chain_risk",
      "mcp__nerai__get_commodities",
      "mcp__nerai__get_sanctions_overview",
      "mcp__nerai__get_live_chokepoint_traffic",
      "mcp__nerai__get_maritime_corridors",
      "mcp__nerai__get_circumvention_corridors",
      "mcp__nerai__get_forecast_desk",
      "mcp__nerai__find_enforcement_precedent",
      "mcp__nerai__get_transaction_intelligence_status",
      "mcp__nerai__get_tradecontrol_changes"
    ],
    "ask": [
      "mcp__nerai__check_commodity_controls"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as nerai. Review it before you use it.