English Français العربية

Aetherx MCP

Community Other

Predictive congestion signals for global ports: congestion score, ETA delay, waiting vessels and a freight volatility index.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. aetherx-mcp
  2. Install
  3. Configure your MCP client
  4. Tools
  5. Configuration
  6. Example agent prompts
  7. License

aetherx-mcp

MCP server for the Aether-X Port Congestion Oracle — gives any MCP-compatible agent (Claude Desktop, Cursor, VS Code, custom LLM agents) predictive port congestion signals for global trade and quantitative finance.

Install

pip install aetherx-mcp
# or run without installing (recommended for MCP clients):
uvx aetherx-mcp

Configure your MCP client

Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "aetherx-oracle": {
      "command": "uvx",
      "args": ["aetherx-mcp"],
      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }
    }
  }
}
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "aetherx-oracle": {
      "command": "uvx",
      "args": ["aetherx-mcp"],
      "env": { "RAPIDAPI_KEY": "SUA_RAPIDAPI_KEY" }
    }
  }
}

Tools

ToolArgumentsReturns
get_port_riskport_id (UN/LOCODE)Congestion score, ETA delay, waiting vessels, freight volatility
get_ports_riskport_ids (list)Same, for a whole portfolio, fetched in parallel
list_supported_ports—The 15 pre-seeded ports (id, name, country)

Every response is a typed payload:

{
  "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,
  "updated_at": "2026-09-17 15:46:53"
}

Configuration

VariableDefaultDescription
RAPIDAPI_KEY—When set, requests are routed through the RapidAPI gateway (metered billing)
RAPIDAPI_HOSTaether-x-port-congestion-oracle.p.rapidapi.comRapidAPI host
AETHERX_BASE_URLhttps://aether-x-oracle-production.up.railway.appDirect API base URL

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

Example agent prompts

  • "What's the congestion risk at Santos right now?"
  • "Rank these ports by congestion: BRSSZ, CNSHA, NLRTM, USLAX."
  • "Which of my Asian ports has the highest freight volatility index?"

License

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

Frequently asked questions

What is Aetherx MCP?

Predictive congestion signals for global ports: congestion score, ETA delay, waiting vessels and a freight volatility index.

How do I install Aetherx MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Aetherx MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Aetherx MCP?

It is published by belegante-byte. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.