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
| Tool | Arguments | Returns |
|---|---|---|
get_port_risk |
port_id (UN/LOCODE) |
Congestion score, ETA delay, waiting vessels, freight volatility |
get_ports_risk |
port_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
| 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://aether-x-oracle-production.up.railway.app |
Direct 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.
