Aether-X Port Delay Intelligence MCP server

Aether-X Port Congestion Oracle

Port congestion signals for developers, AI agents, logistics systems and quantitative workflows.

DATA INTEGRITY NOTICE: 18 ports & global chokepoints serve LIVE operational telemetry. Brazil ports (Santos, Paranaguá, Rio, Niterói, Itaguaí), Asian hubs (Singapore, Shanghai, Busan, Tokyo/Yokohama), European hubs (Rotterdam, Hamburg, Antwerp, Genoa), African ports (Cape Town, Tanger Med), and critical straits (Hormuz, Suez Canal, Panama Canal) are refreshed continuously from 12+ live sources (datasource="live:..."). The remaining 17 ports serve a reference seed (datasource="staticreferenceseed"). Every API/MCP response includes datasource and asof.

Aether-X is live physical-world port intelligence — port congestion signal, vessel queue intelligence, port delay risk / ETA delay, and demurrage exposure — covering 35 ports & global chokepoints (18 ports LIVE with multi-region telemetry, 17 reference seed ports). Delivered through a REST API, a typed Python SDK and a remote MCP server for AI agents.

When to call Aether-X: when a decision depends on current port conditions — choosing between ports, routing cargo, vessel scheduling, ETA risk, demurrage exposure, or supply-chain disruption — not static port information. Every response includes a machine-readable signal block (level, liveobservation, queuevessels, decisionimplication, asof).

Free tier available. No credit card required.

Quick start (Python) — under 3 minutes

pip install --upgrade aetherx-oracle

from aetherx import OracleClient

client = OracleClient(api_key="YOUR_RAPIDAPI_KEY")

risk = client.get_port_risk("BRSSZ")

print(risk.port_name)                        # Santos
print(risk.congestion_score)                 # 0.78
print(risk.eta_delay_days)                   # 1.6
print(risk.estimated_daily_demurrage_usd)    # 63200 (USD/day)

Get a free API key on the RapidAPI listing.

Compare many ports in one call

portfolio = ["BRSSZ", "CNSHA", "NLRTM", "USLAX", "SGSIN"]
results = client.get_ports_risk(portfolio)
for r in sorted(results, key=lambda x: x.congestion_score, reverse=True):
    print(f"{r.port_id:<6} {r.congestion_score:.2f}  {r.estimated_daily_demurrage_usd:,}/day")

24/48/72h trend

trend = client.get_port_trend("NLRTM")
print(trend.trend)                              # acelerando / estável / descongestionando
print(trend.projection["h48"].congestion_score)

Async (parallel batch)

pip install "aetherx-oracle[async]"

import asyncio
from aetherx import OracleClient

async def main():
    client = OracleClient(api_key="YOUR_RAPIDAPI_KEY")
    risks = await client.get_ports_risk_async(["BRSSZ", "CNSHA", "NLRTM", "USLAX"])
    for r in risks:
        print(r.port_id, r.congestion_score)

asyncio.run(main())

MCP server (for AI agents)

Ask your agent directly:

"What's the congestion risk at Santos?"

"Compare Santos, Shanghai and Rotterdam."

"Which of these ports has the highest modeled demurrage exposure?"

"Show me the 72-hour congestion trend for Santos."

Available tools: getportrisk · getportsrisk · getporttrend

Remote (no install)

Add to your MCP client config:

Shortened. The full README is on GitHub.