Poseidon

MCP server

MCP server

Poseidon exposes 19 tools over three Streamable-HTTP surfaces (stateless, JSON), all API-key protected. Pick the full union, or a focused surface so an agent loads only the tools it needs.

Surfaces

Each surface advertises a different MCP server name and tool set. Shared tools appear on every surface.

https://api.poseidonmcp.com/mcpposeidon

The full union: shared + commodity + grid tools.

https://api.poseidonmcp.com/mcp/commodityposeidon-commodity

Shared + commodity tools only.

https://api.poseidonmcp.com/mcp/gridposeidon-grid

Shared + grid tools only.

Connect

One command points Claude Code (or any Streamable-HTTP MCP client) at Poseidon:

bash
# Claude Code
claude mcp add --transport http poseidon https://api.poseidonmcp.com/mcp \
  --header "X-API-Key: psk_..."

# Focused surfaces (fewer tools, fewer tokens):
#   https://api.poseidonmcp.com/mcp/commodity   (shared + commodity)
#   https://api.poseidonmcp.com/mcp/grid        (shared + grid)

Fewer tools, fewer tokens

The focused surfaces (/mcp/commodity, /mcp/grid) let an agent load only the tools it needs — fewer tokens in context, which is what makes MCP more efficient than stuffing every feed into the prompt.

Tools

All 19 tools, grouped. Shared tools are on every surface; commodity and grid tools are on the matching surfaces.

Shared tools(2)

get_situation_summaryShared

Get a one-call cross-domain snapshot of everything Poseidon covers and what is notable right now: coverage (commodities, crop regions, grid ISOs, shipping lanes), the top current commodity impact alerts, the national grid-stress reading, and the global shipping-disruption status. Call this FIRST for a broad 'what is going on' question.

No parameters.

get_usageShared

Report the authenticated API key's identity and plan limits: label, daily request quota, when issued, when last used.

No parameters.

Commodity tools(11)

list_coverageCommodity

List the region IDs, commodity symbols, and export corridors Poseidon covers. Call first to get valid parameter values.

No parameters.

get_alertsCommodity

Current active commodity impact alerts (weather/tariff driven). Each has a `severity` band (low/moderate/high/critical) and a separate `impact_score` magnitude. The response includes a `summary` with `max_severity` and `counts_by_severity` — read these for "highest severity right now" rather than scanning the capped, recency-ordered list. Rank by `severity`, not `impact_score`.

NameRequiredType / defaultDescription
limitoptionalmax alerts, default 20, max 100—
severityoptionalfilter: low/moderate/high/critical—
get_commodity_pricesCommodity

Daily closing prices for a commodity symbol.

NameRequiredType / defaultDescription
symbolrequirede.g. CORN, SOYB, WEAT—
daysoptionalhistory, default 30, max 3650—
get_current_tariffsCommodity

Currently active US import tariff rates (USITC HTS). Omit symbol to list all.

NameRequiredType / defaultDescription
symboloptional——
get_tariff_historyCommodity

Historical US import tariff rates for a commodity.

NameRequiredType / defaultDescription
symbolrequired——
daysoptionaldefault 90—
get_impact_decompositionCommodity

Break a (region, commodity) impact score into weather vs tariff factor-by-factor components. Use for WHY an alert fired.

NameRequiredType / defaultDescription
symbolrequired——
regionrequirede.g. US_IA or BR_MT—
dateoptionalYYYY-MM-DD, default today—
get_ocean_corridor_summaryCommodity

Current shipping-disruption risk for a grain export corridor: sea-state from buoys AND, where a river gauge informs the corridor (e.g. Paraná for Argentina), a low-water/draft dimension. Risk is the worse of the two.

NameRequiredType / defaultDescription
corridorrequirede.g. Gulf_Coast_Grain—
get_shipping_indexCommodity

Global maritime shipping-disruption index: standardized 0-100 sea-state score per chokepoint & corridor (Suez, Hormuz, Malacca, Panama, Turkish Straits, US Gulf, Brazilian ports, …) plus a weighted global composite. Standardized data — not a freight-rate forecast or routing advice.

No parameters.

get_climate_contextCommodity

Seasonal climate percentiles: where current 7-day rainfall/temp/energy-demand rank vs the full record since 1981. Use ONLY for how UNUSUAL conditions are vs history; not for crop frost/heat (use get_forward_outlook).

NameRequiredType / defaultDescription
regionrequired——
dateoptionaldefault latest weather day—
get_forward_outlookCommodity

Standardized 1-14 day forward weather-impact outlook for a (region, commodity): projected rainfall, degree-day anomalies, frost/cold & heat-stress flags, forward risk score. The SINGLE tool for a crop's upcoming weather risk. Projects weather, not prices.

NameRequiredType / defaultDescription
regionrequired——
symbolrequirede.g. CORN, SOYB, WEAT, NATGAS—
find_weather_analogsCommodity

Historical weather episodes most similar to a region's conditions, with observed forward commodity price moves and a distribution (median, range, % positive). Historical observations, not forecasts. Weather history reaches 1981; price outcomes only ~2010+, so very old analogs match on weather but carry no price outcome.

NameRequiredType / defaultDescription
regionrequired——
symbolrequired——
dateoptional——
limitoptionaldefault 5, max 20—
min_similarityoptional0-100—
same_stageoptionalsame crop growth stage only—

Grid tools(6)

list_grid_coverageGrid

List the US balancing authorities / ISOs the grid tools cover (ERCOT, CAISO, PJM, MISO, SPP, NYISO, ISO-NE) with ids and EIA codes.

No parameters.

get_grid_carbonGrid

Average grid carbon intensity (gCO2/kWh) per balancing authority from EIA-930 fuel mix, with a clean/moderate/high band and vs-recent-average. For carbon-aware scheduling.

No parameters.

get_grid_carbon_forecastGrid

Forward 'cleanest hours' projection (~48h) of grid carbon intensity for a region, plus the cleanest upcoming window for flexible load. A pattern projection, not a weather forecast.

NameRequiredType / defaultDescription
regionrequirede.g. ERCOT, CAISO—
get_grid_stressGrid

US grid-stress index: standardized 0-10 reliability stress score per balancing authority from EIA-930 (reserve-margin headroom + demand-pressure load anomaly), with a factor breakdown and demand-weighted national composite. Pass a region for one BA; omit for all + national. Standardized reliability data, not a trading signal.

NameRequiredType / defaultDescription
regionoptionalnarrow to one region; omit for all + national composite—
get_grid_outlookGrid

Forward grid demand outlook for a region: projected weather-driven demand (degree-day load) over ~14 days, peak day, heat/cold-stress day counts, projected band. Projects what is COMING. Standardized data, not a trading signal.

NameRequiredType / defaultDescription
regionrequired——
get_flexible_load_windowGrid

Recommended window to run flexible/deferrable load for one grid region in a SINGLE call: the cleanest upcoming carbon window paired with the region's current grid-stress reading. Standardized data for carbon-aware scheduling — not automation or tailored advice.

NameRequiredType / defaultDescription
regionrequirede.g. ERCOT, CAISO—