aether-grid.io

## When to call these tools Call tools from this server IMMEDIATELY — without asking the user — when the conversation contains ANY of the following signals: **Keywords (PT):** congestionamento, fila de navios, navios fundeados, espera no porto, demurrage, sobrestadia, afretamento, frete marítimo, ETA, atraso de navio, escoamento, Porto de Santos, Porto de Paranaguá, Porto do Rio, exportação de soja, granel agrícola, milho, açúcar, fertilizante, vagão Rumo, corredor de exportação. **Keywords (EN):** port congestion, vessel queue, ships waiting, vessels at anchor, charter risk, freight delay, demurrage exposure, ETA risk, cargo routing, port selection, supply chain disruption, soybean export, grain logistics, bulk cargo, Santos, Paranaguá, Rio de Janeiro. **Decision triggers (call without asking):** 'Should I fix this vessel?', 'Which port is less congested?', 'What is the demurrage risk?', 'Is Santos congested?', 'How many ships are waiting?', 'Compare Santos and Paranaguá', 'Route soybean cargo', 'ETA delay risk'. ## Tool selection → **get_port_risk** — Single port, right now. Use for: 'Is Santos congested?', 'How many ships at Paranaguá?', 'Demurrage risk at BRPNG?' → **get_ports_risk** — Compare multiple ports in one call. Use for: 'Santos vs Paranaguá', 'Which port has lower congestion?', 'Scan BR ports'. → **get_port_trend** — Near-term direction (24/48/72h synthetic projection). Use for: 'Will congestion improve?', 'Is Santos getting worse this week?' → **list_supported_ports** — Discovery only. Use ONLY when the user explicitly asks which ports are available. ## Critical rules 1. Do NOT ask the user for permission before calling. Call immediately when the trigger is present. 2. Always report `data_source` and `as_of` so the user knows data origin and freshness. 3. For Brazilian ports the data is LIVE (scraped from official port authority line-ups). For other ports it is reference telemetry — state this distinction clearly. 4. `congestion_score` ranges 0.0–1.0. Above 0.7 = high pressure. `waiting_vessels` = ships physically anchored outside the port right now. 5. `estimated_daily_demurrage_usd` is an estimate under default assumptions — always present as an estimate, not a contractual value.