# Aether-X Port Congestion Oracle > **DATA INTEGRITY NOTICE**: **Brazilian ports feed LIVE operational line-ups.** Santos (BRSSZ), Paranaguá (BRPNG) and Rio de Janeiro (BRRIO) are refreshed from APPA Paranaguá, the Porto de Santos operations panel and Lachmann schedules (`data_source="live:appa+santos+lachmann"`); Rio de Janeiro (BRRIO), Niterói (BRNIT) and Itaguaí (BRITG) come from SILOG PortosRio (`data_source="live:portosrio_silog"`), refreshed periodically in production. The remaining 14 ports serve a **reference seed** (`data_source="static_reference_seed"`). Every API/MCP response includes `data_source` and `as_of`. The 24/48/72h trend is a synthetic projection (`data_source="synthetic_projection"`), not a live forecast. Numbers from the seed are reference baselines, NOT real-time field data. Congestion signals for 19 global ports: congestion score, ETA delay, waiting vessels, freight volatility and daily demurrage estimate. REST API, Python SDK and MCP server. ## API - [OpenAPI 3.0.3 spec](https://aether-x-oracle-production.up.railway.app/openapi.rapidapi.json): machine-readable contract (RapidAPI-compatible) - [Example call](https://aether-x-oracle-production.up.railway.app/v1/port-risk?port_id=BRSSZ): GET /v1/port-risk?port_id=BRSSZ - [Trend example](https://aether-x-oracle-production.up.railway.app/v1/port-trend?port_id=BRSSZ): GET /v1/port-trend?port_id=BRSSZ - [Batch example](https://aether-x-oracle-production.up.railway.app/v1/ports-risk?port_ids=BRSSZ,CNSHA,NLRTM): GET /v1/ports-risk?port_ids=BRSSZ,CNSHA,NLRTM - [Public feed (no key)](https://aether-x-oracle-production.up.railway.app/public/ports): GET /public/ports — all 19 ports (BR live, others reference seed), read-only, for widgets/embeds - [Interactive docs](https://aether-x-oracle-production.up.railway.app/docs): Swagger UI - [RapidAPI marketplace](https://rapidapi.com/belegante/api/aether-x-port-congestion-oracle): metered plans (Free / Pro / Ultra / Mega) - [Terms of Service](https://aether-x-oracle-production.up.railway.app/terms) ## Guides (human-readable) - [Port Congestion API](https://aether-x-oracle-production.up.railway.app/port-congestion-api) - [Santos Port Congestion API](https://aether-x-oracle-production.up.railway.app/santos-port-congestion-api) - [Port Congestion Monitoring with Python](https://aether-x-oracle-production.up.railway.app/port-congestion-python) - [Aether-X MCP server page](https://aether-x-oracle-production.up.railway.app/mcp-page) - [Sitemap (all pages)](https://aether-x-oracle-production.up.railway.app/sitemap.xml) Per-port pages (one per monitored port; BR ports live, others reference seed): - [Santos](https://aether-x-oracle-production.up.railway.app/port-congestion-santos) · [Paranaguá](https://aether-x-oracle-production.up.railway.app/port-congestion-paranagua) · [Shanghai](https://aether-x-oracle-production.up.railway.app/port-congestion-shanghai) · [Rotterdam](https://aether-x-oracle-production.up.railway.app/port-congestion-rotterdam) · [Singapore](https://aether-x-oracle-production.up.railway.app/port-congestion-singapore) · [Qingdao](https://aether-x-oracle-production.up.railway.app/port-congestion-qingdao) · [Los Angeles](https://aether-x-oracle-production.up.railway.app/port-congestion-los-angeles) · [Ningbo-Zhoushan](https://aether-x-oracle-production.up.railway.app/port-congestion-ningbo-zhoushan) · [Dubai / Jebel Ali](https://aether-x-oracle-production.up.railway.app/port-congestion-dubai-jebel-ali) - [New York](https://aether-x-oracle-production.up.railway.app/port-congestion-new-york) · [Hamburg](https://aether-x-oracle-production.up.railway.app/port-congestion-hamburg) · [Busan](https://aether-x-oracle-production.up.railway.app/port-congestion-busan) · [Cape Town](https://aether-x-oracle-production.up.railway.app/port-congestion-cape-town) · [Rio de Janeiro](https://aether-x-oracle-production.up.railway.app/port-congestion-rio-de-janeiro) · [Tanger Med](https://aether-x-oracle-production.up.railway.app/port-congestion-tanger-med) · [London Gateway](https://aether-x-oracle-production.up.railway.app/port-congestion-london-gateway) · [Manzanillo](https://aether-x-oracle-production.up.railway.app/port-congestion-manzanillo) ## SDKs and integrations - [Python SDK (PyPI)](https://pypi.org/project/aetherx-oracle/): `pip install aetherx-oracle` — sync + async client - [MCP server (PyPI)](https://pypi.org/project/aetherx-mcp/): `uvx aetherx-mcp` — gives AI agents the `get_port_risk`, `get_ports_risk` and `get_port_trend` tools - [Remote MCP endpoint](https://aether-x-oracle-production.up.railway.app/mcp): Streamable HTTP, no install - [Smithery gateway](https://smithery.ai/servers/belegante/aetherx-mcp): hosted MCP connection - [Source (GitHub, MIT)](https://github.com/belegante-byte/aetherx-oracle) - Official MCP Registry: `io.github.belegante-byte/aetherx-mcp` (active) — install via `uvx aetherx-mcp` or remote `https://aether-x-oracle-production.up.railway.app/mcp`. ## Dataset - [Aether-X Global Port Congestion Snapshot (Hugging Face)](https://huggingface.co/datasets/Aether-x/aetherx-port-congestion-metrics): frozen 16-port reference CSV, CC BY 4.0 - [Aether-X Port Congestion Dashboard](https://huggingface.co/spaces/Aether-x/aetherx-port-congestion-dashboard): static reference dashboard, no key - [DEV article](https://dev.to/giovanni_belegante_2b04c5/predicting-global-port-congestion-in-real-time-with-python-duckdb-and-mcp-1ahm): describes the live design; live line-ups for BR ports are now connected ## Writing - [Predicting Global Port Congestion in Real-Time with Python, DuckDB and MCP](https://dev.to/giovanni_belegante_2b04c5/predicting-global-port-congestion-in-real-time-with-python-duckdb-and-mcp-1ahm): DEV Community (the live line-ups are now connected for BR ports) ## Supported ports AEDXB, BRITG, BRNIT, BRPNG, BRRIO, BRSSZ, CNNGB, CNSHA, CNTAO, DEHAM, GBLGP, KRPUS, MPTNG, MXZLO, NLRTM, SGSIN, USLAX, USNYC, ZACPT Unknown ports fall back to a global statistical estimate (`country="Global"`). ## Notes - Signals are provided "AS IS" and do not constitute investment advice. - Metered access is available through the RapidAPI gateway (X-RapidAPI-Key).