Aether-X Port Delay Intelligence

io.github.belegante-bytePublished by GitHub account belegante-bytev0.4.4Updated Oct 24, 2026

Port delay exposure with p50/p90 confidence intervals, demurrage impact and a free public feed.

The publisher's own server: Port

VerifiedStreamable HTTPWeb executableData & Analytics Business & Commerce

Server details

Identifier: io.github.belegante-byte/aetherx-mcp
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 18, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account belegante-byte for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.belegante-byte%2Faetherx-mcp.svg)](https://sourceweft.com/mcp/io.github.belegante-byte%2Faetherx-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Aether-X Port Delay Intelligence is an MCP server that gives an assistant port congestion, vessel queue and delay-risk signals for global trade ports and chokep

What you can do: Look up a port's plain-language operating status (normal or congested), delay and waiting vessels by UN/LOCODE code, with source provenance and timestamp on each result. Retrieve congestion score, ETA delay, freight volatility and estimated daily demurrage in USD for one port or a whole portfolio in parallel. Get 24/48/72-hour congestion projections with a trend label. List the 35 supported ports and chokepoints.
When to use it: Useful when an assistant needs to answer questions about whether a specific port is delayed, how many vessels are waiting, or how congestion risk and demurrage exposure compare across a set of ports. Suited to logistics, shipping and supply-chain analysis rather than general web lookups.
Requirements: Runs as a remote endpoint or as a local process from the PyPI package aetherx-mcp (for example via uvx), so Python tooling is needed for local use. Optionally set RAPIDAPI_KEY to route requests through the RapidAPI gateway; without it the server calls the public production API directly. RAPIDAPI_HOST and AETHERX_BASE_URL can override the endpoints. Network access is required.

Before you install

Only Brazilian ports (Santos, Paranaguá, Rio de Janeiro, Niterói, Itaguaí) use live line-up data; other ports return a static reference seed that is not real-time field data, and the 24/48/72-hour trend is a synthetic projection, not a live forecast. Setting RAPIDAPI_KEY routes requests through a metered, billed gateway. Some prompts in the README reference tools and an M2M key that are not documented in the tool table.

Installation

In SourceWeft

Open Aether-X Port Delay Intelligence in the dashboard and add it to a workspace.
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.belegante-byte%2Faetherx-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": {
    "aether-x-port-delay-intelligence": {
      "type": "http",
      "url": "https://aetherx.aether-grid.io/mcp"
    }
  }
}

README

aetherx-mcp — Port Congestion, Maritime Logistics & Supply Chain MCP Server

Aether-X is an MCP server for the Aether-X Port Congestion Oracle that gives any MCP-compatible agent (Claude Desktop, Cursor, VS Code, custom LLM agents) port congestion, maritime delay, vessel queue and supply-chain risk signals for global trade — answered in plain language for simple queries ("is Rotterdam delayed?") and in USD exposure for decision-grade workflows (demurrage, charter risk, fiscal arbitrage across routes).

Keywords: maritime, shipping, vessels, ports, port congestion, demurrage, freight, logistics, supply chain, ETA delay, vessel queue, chokepoints, Suez, Panama, trade lanes, cargo, quantitative finance.

DATA INTEGRITY NOTICE: Brazilian ports (BRSSZ Santos, BRPNG Paranaguá, BRRIO Rio de Janeiro) feed live operational line-ups (data_source="live:appa+santos+lachmann"); Niterói (BRNIT) and Itaguaí (BRITG) together with Rio de Janeiro feed live line-up from SILOG PortosRio (data_source="live:portosrio_silog"). The remaining ports serve a static reference seed (data_source="static_reference_seed"). Every tool result includes data_source and as_of. The 24/48/72h trend is a synthetic projection, not a live forecast. Seed values are NOT real-time field data.

Install

Configure your MCP client

Claude Desktop (`claude_desktop_config.json`)

json

{  "mcpServers": {    "aetherx-oracle": {      "command": "uvx",      "args": ["aetherx-mcp"],      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }    }  }}

{  "mcpServers": {    "aetherx-oracle": {      "command": "uvx",      "args": ["aetherx-mcp"],      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }    }  }}

Cursor (`~/.cursor/mcp.json`)

json

{  "mcpServers": {    "aetherx-oracle": {      "command": "uvx",      "args": ["aetherx-mcp"],      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }    }  }}

{  "mcpServers": {    "aetherx-oracle": {      "command": "uvx",      "args": ["aetherx-mcp"],      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }    }  }}

Tools

Tool	Arguments	Returns
`get_port_operations_status`	`port_id` (UN/LOCODE)	Plain-language status (NORMAL / CONGESTED), delay, waiting vessels, source provenance + optional decision-layer upsell — free observation
`get_port_risk`	`port_id` (UN/LOCODE)	Congestion score, ETA delay, waiting vessels, freight volatility, daily demurrage estimate
`get_ports_risk`	`port_ids` (list)	Same, for a whole portfolio, fetched in parallel
`get_port_trend`	`port_id` (UN/LOCODE)	24h / 48h / 72h congestion projection + trend label (acelerando / estável / descongestionando)
`list_supported_ports`	—	The 35 ports & chokepoints (id, name, country)

Every response is a typed payload:

json

{  "port_id": "BRSSZ",  "port_name": "Santos",  "country": "Brasil",  "congestion_score": 0.78,  "eta_delay_days": 1.6,  "waiting_vessels": 12,  "freight_volatility_index": 0.42,  "estimated_daily_demurrage_usd": 63200,  "updated_at": "2026-09-17 15:46:53"}

{  "port_id": "BRSSZ",  "port_name": "Santos",  "country": "Brasil",  "congestion_score": 0.78,  "eta_delay_days": 1.6,  "waiting_vessels": 12,  "freight_volatility_index": 0.42,  "estimated_daily_demurrage_usd": 63200,  "updated_at": "2026-09-17 15:46:53"}

Configuration

Variable	Default	Description
`RAPIDAPI_KEY`	—	When set, requests are routed through the RapidAPI gateway (metered billing)
`RAPIDAPI_HOST`	`aether-x-port-congestion-oracle.p.rapidapi.com`	RapidAPI host
`AETHERX_BASE_URL`	`https://aetherx.aether-grid.io`	Direct API base URL

Without RAPIDAPI_KEY, the server calls the public production API directly.

Example agent prompts

"Is the port of Santos delayed right now?" (→ get_port_operations_status)
"Where is my cargo stuck? What's the waiting time at Paranaguá?" (→ get_port_operations_status)
"What's the congestion risk at Rotterdam over the next 3 days?" (→ get_port_trend, forecast_vessel_queue_delays)
"Rank these ports by congestion: BRSSZ, CNSHA, NLRTM, USLAX." (→ get_ports_risk)
"How many ships are waiting at Shanghai?" (→ get_port_state, get_port_operations_status)
"Which route minimizes demurrage + fiscal cost for my fertilizer cargo to MT?" (→ evaluate_fiscal_routing, requires M2M key)

License

MIT — see LICENSE. The signals are provided "AS IS" and do not constitute investment advice. See the Terms of Service.

Source: mcp_server/README.md at commit 06116c0

Tools

SourceWeft has not read this server's tools yet.

Version history

v0.4.4LatestOct 4, 2026
v0.4.3Sep 19, 2026
v0.4.1Sep 19, 2026
v0.4.0Sep 19, 2026
v0.2.1Sep 18, 2026
v0.1.2Sep 18, 2026

Score

75% 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
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Other Port integrations

Port

io.portOfficial publisher

Port's remote MCP server connects Port.io to an IDE, LLM or agent platform, letting an assistant work with your Port.io environment through OAuth-authenticated,

Streamable HTTPWeb executableAuth

Developer ToolsCredential requiredOct 24, 2026

GravityPort

Published by GitHub account fengseekling-coder

MCP server bundled with the GravityPort desktop app that lets Claude, Codex and other clients search and record a local library of AI-generated images, videos…

STDIODesktop only

Files & StorageNot validated yetNov 7, 2026