aetherx-mcp

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

DATA INTEGRITY NOTICE: Brazilian ports (BRSSZ Santos, BRPNG Paranaguá) feed live operational line-ups (data_source="live:appa+santos+lachmann"); Rio de Janeiro (BRRIO) feeds 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

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

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

Configuration

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?"
• "Project the congestion at Rotterdam over the next 3 days."

License

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