# Stormglass Io

stormglass.io provides a global weather API offering high-resolution forecasts and historical data from trusted meteorological institutions.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `STORMGLASS_IO`
- **Version:** 20260223_00

## Tools

### Get Elevation for Point

**Slug:** `STORMGLASS_IO_GET_ELEVATION_POINT`

Tool to fetch elevation data for a single geographic point. Use when you need bathymetry or topography for a specific latitude/longitude.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lat` | number | Yes | Latitude of the desired coordinate in decimal degrees, between -90 and 90. |
| `lng` | number | Yes | Longitude of the desired coordinate in decimal degrees, between -180 and 180. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get tide extremes for a point

**Slug:** `STORMGLASS_IO_GET_TIDE_EXTREMES_POINT`

Tool to retrieve high and low tide times with corresponding sea level heights for a coordinate. Returns tide extreme points (high/low) for the specified time interval.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end` | string | No | Timestamp in UTC for last forecast hour - UNIX format or URL encoded ISO format. |
| `lat` | number | Yes | Latitude in decimal degrees (-90 to 90). |
| `lng` | number | Yes | Longitude in decimal degrees (-180 to 180). |
| `datum` | string ("MLLW" | "MSL") | No | Datum values the tide heights will be relative to. |
| `start` | string | No | Timestamp in UTC for first forecast hour - UNIX format or URL encoded ISO format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tide Stations in Area

**Slug:** `STORMGLASS_IO_GET_TIDE_STATIONS_AREA`

Tool to list tide stations within a defined geographic bounding box. Use when you need stations in a specific region defined by coordinates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `box` | string | Yes | Bounding box defining the area. Format: top-right and bottom-left coordinates as 'lat,lng:lat,lng' (e.g., '38.0,-122.0:37.5,-122.5') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List All Tide Stations

**Slug:** `STORMGLASS_IO_GET_TIDE_STATIONS_LIST`

Tool to list all available tide stations. Use when you need a catalog of stations before querying tide data.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get solar data for a point

**Slug:** `STORMGLASS_IO_STORMGLASS_GET_SOLAR_POINT`

Tool to fetch solar irradiation and sun-position data for a specific coordinate. Use after confirming lat/lng, desired parameters, and optional ISO-formatted start/end.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end` | string | No | Optional end time (inclusive) in ISO8601 UTC format, e.g. '2022-02-01T23:00:00+00:00' |
| `lat` | number | Yes | Latitude in decimal degrees (-90 to 90). |
| `lng` | number | Yes | Longitude in decimal degrees (-180 to 180). |
| `start` | string | No | Optional start time (inclusive) in ISO8601 UTC format, e.g. '2022-02-01T00:00:00+00:00' |
| `params` | array | Yes | List of solar parameters to retrieve. Valid options: 'uvIndex' (UV index), 'downwardShortWaveRadiationFlux', 'solarDownwardRadiationFlux', 'surfaceNetShortwaveRadiationDownwardsFlux'. |
| `source` | string ("noaa" | "sg") | No | Optional data source filter. Valid options: 'noaa' (NOAA), 'sg' (Storm Glass). If not specified, data from all available sources is returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get weather data for a point

**Slug:** `STORMGLASS_IO_STORMGLASS_GET_WEATHER_POINT`

Tool to fetch marine and land weather data for a specific coordinate. Use after confirming latitude, longitude, and desired parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end` | string | No | Optional end time (inclusive) in ISO8601 UTC format, e.g. '2019-02-02T18:00:00+00:00'. |
| `lat` | number | Yes | Latitude in decimal degrees (-90 to 90). |
| `lng` | number | Yes | Longitude in decimal degrees (-180 to 180). |
| `start` | string | No | Optional start time (inclusive) in ISO8601 UTC format, e.g. '2019-02-02T15:00:00+00:00'. |
| `params` | array | Yes | List of weather parameters to retrieve. Valid parameters include: airTemperature, humidity (not 'relativeHumidity'), cloudCover, precipitation, windSpeed, windDirection, waveHeight, waterTemperature, pressure, visibility, snow, rain, gust, and many more (70+ total). See https://docs.stormglass.io/ for complete list. |
| `source` | string ("noaa" | "sg" | "meteo" | "dwd" | "fcoo" | "icon" | "hira" | "marine") | No | Data source/provider filter. One of 'noaa','sg','meteo','dwd','fcoo','icon','hira','marine'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
