open-signals

get_layer

One map layer as a GeoJSON FeatureCollection: one point per place with the reading on the date (else the latest observed before it, never a guess), or one point per event for event layers.

Input Schema

Name	Required	Description
`id`	Yes
`lat`	No	Ad-hoc point latitude (with lng). For weather and WSI.
`lng`	No	Ad-hoc point longitude (with lat).
`min`	No
`tag`	No	Catalogue places with this tag, e.g. waterfowl, ice-fishing.
`bbox`	No
`date`	No	YYYY-MM-DD; default today (US Eastern).
`fuel`	No	power_plants: coal, oil/gas, nuclear, hydropower, wind, utility-scale solar, geothermal or bioenergy
`kind`	No	weather_alerts: warning \| watch \| advisory
`type`	No	ships_baltic: cargo \| tanker \| passenger \| fishing \| tug \| other
`usgs`	No	USGS monitoring location id(s), e.g. USGS-04193500.
`coops`	No	NOAA CO-OPS station id(s), comma-separated, e.g. 9063085.
`ebird`	No	eBird region code(s), e.g. US-OH-095.
`event`	No	weather_alerts: an NWS event name, e.g. Red Flag Warning
`place`	No	Comma-separated catalogue place ids (see list_places).
`state`	No
`marine`	No	weather_alerts: include marine alerts
`min_mw`	No
`radius`	No	aircraft, gps_interference: nautical miles around lat/lng, 1-250
`region`	No	reservoirs_west: a Reclamation region, e.g. Missouri Basin
`status`	No	power_plants: operating \| construction
`window`	No
`country`	No	power_plants: ISO alpha-3, e.g. DEU
`elevated`	No
`operator`	No	data_centers: operator, e.g. Microsoft
`indicator`	No
`continuing`	No	volcanoes_world: only eruptions in progress
`erupted_since`	No	volcanoes_world: year, default 1900

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 27, 2026

changedInput schema / properties / id / enum

Previous value: -[
-  "temperature",
-  "wind",
-  "pressure_change",
-  "snow_depth",
-  "wsi",
-  "water_level",
-  "river_flow",
-  "ice",
-  "sightings",
-  "volcanoes",
-  "flood_gauges",
-  "epa_facilities",
-  "recalls",
-  "contract_awards",
-  "wildlife",
-  "natural_events",
-  "world_bank",
-  "earthquakes_emsc",
-  "tropical_cyclones",
-  "power_plants",
-  "eu_industrial_production",
-  "fema_declarations",
-  "earthquakes",
-  "lock_traffic",
-  "border_crossings",
-  "toxic_releases",
-  "power_emissions",
-  "river_discharge",
-  "air_quality",
-  "volcanoes_world",
-  "lock_delays",
-  "snowpack",
-  "drought",
-  "storm_reports",
-  "wildfire_incidents",
-  "aircraft",
-  "military_aircraft",
-  "gps_interference",
-  "weather_alerts",
-  "reservoirs_west",
-  "ships_baltic",
-  "quake_corroboration",
-  "fire_corroboration",
-  "fires",
-  "persistent_heat",
-  "steel_plant_heat"
-]New value: +[
+  "temperature",
+  "wind",
+  "pressure_change",
+  "snow_depth",
+  "wsi",
+  "water_level",
+  "river_flow",
+  "ice",
+  "sightings",
+  "volcanoes",
+  "flood_gauges",
+  "epa_facilities",
+  "recalls",
+  "contract_awards",
+  "wildlife",
+  "natural_events",
+  "world_bank",
+  "earthquakes_emsc",
+  "tropical_cyclones",
+  "power_plants",
+  "eu_industrial_production",
+  "fema_declarations",
+  "earthquakes",
+  "lock_traffic",
+  "border_crossings",
+  "toxic_releases",
+  "power_emissions",
+  "river_discharge",
+  "air_quality",
+  "volcanoes_world",
+  "lock_delays",
+  "snowpack",
+  "drought",
+  "storm_reports",
+  "wildfire_incidents",
+  "aircraft",
+  "military_aircraft",
+  "gps_interference",
+  "weather_alerts",
+  "reservoirs_west",
+  "ships_baltic",
+  "data_centers",
+  "quake_corroboration",
+  "fire_corroboration",
+  "fires",
+  "persistent_heat",
+  "steel_plant_heat",
+  "cement_plant_heat",
+  "chemical_plant_heat",
+  "oil_gas_field_heat"
+]

addedInput schema / properties / operator

Added value: +{
+  "description": "data_centers: operator, e.g. Microsoft",
+  "type": "string"
+}

Changed3 schema fields changedOct 27, 2026

changedInput schema / properties / id / enum

Previous value: -[
-  "temperature",
-  "wind",
-  "pressure_change",
-  "snow_depth",
-  "wsi",
-  "water_level",
-  "river_flow",
-  "ice",
-  "sightings",
-  "volcanoes",
-  "flood_gauges",
-  "epa_facilities",
-  "recalls",
-  "contract_awards",
-  "wildlife",
-  "natural_events",
-  "world_bank",
-  "earthquakes_emsc",
-  "tropical_cyclones",
-  "power_plants",
-  "eu_industrial_production",
-  "fema_declarations",
-  "earthquakes",
-  "lock_traffic",
-  "border_crossings",
-  "toxic_releases",
-  "power_emissions",
-  "river_discharge",
-  "air_quality",
-  "volcanoes_world",
-  "lock_delays",
-  "snowpack",
-  "drought",
-  "storm_reports",
-  "wildfire_incidents",
-  "aircraft",
-  "military_aircraft",
-  "gps_interference",
-  "weather_alerts",
-  "fires",
-  "persistent_heat",
-  "steel_plant_heat"
-]New value: +[
+  "temperature",
+  "wind",
+  "pressure_change",
+  "snow_depth",
+  "wsi",
+  "water_level",
+  "river_flow",
+  "ice",
+  "sightings",
+  "volcanoes",
+  "flood_gauges",
+  "epa_facilities",
+  "recalls",
+  "contract_awards",
+  "wildlife",
+  "natural_events",
+  "world_bank",
+  "earthquakes_emsc",
+  "tropical_cyclones",
+  "power_plants",
+  "eu_industrial_production",
+  "fema_declarations",
+  "earthquakes",
+  "lock_traffic",
+  "border_crossings",
+  "toxic_releases",
+  "power_emissions",
+  "river_discharge",
+  "air_quality",
+  "volcanoes_world",
+  "lock_delays",
+  "snowpack",
+  "drought",
+  "storm_reports",
+  "wildfire_incidents",
+  "aircraft",
+  "military_aircraft",
+  "gps_interference",
+  "weather_alerts",
+  "reservoirs_west",
+  "ships_baltic",
+  "quake_corroboration",
+  "fire_corroboration",
+  "fires",
+  "persistent_heat",
+  "steel_plant_heat"
+]

addedInput schema / properties / region

Added value: +{
+  "description": "reservoirs_west: a Reclamation region, e.g. Missouri Basin",
+  "type": "string"
+}

addedInput schema / properties / type

Added value: +{
+  "description": "ships_baltic: cargo | tanker | passenger | fishing | tug | other",
+  "type": "string"
+}

Changed4 schema fields changedOct 27, 2026

addedInput schema / properties / event

Added value: +{
+  "description": "weather_alerts: an NWS event name, e.g. Red Flag Warning",
+  "type": "string"
+}

changedInput schema / properties / id / enum

Previous value: -[
-  "temperature",
-  "wind",
-  "pressure_change",
-  "snow_depth",
-  "wsi",
-  "water_level",
-  "river_flow",
-  "ice",
-  "sightings",
-  "volcanoes",
-  "flood_gauges",
-  "epa_facilities",
-  "recalls",
-  "contract_awards",
-  "wildlife",
-  "natural_events",
-  "world_bank",
-  "earthquakes_emsc",
-  "tropical_cyclones",
-  "power_plants",
-  "eu_industrial_production",
-  "fema_declarations",
-  "earthquakes",
-  "lock_traffic",
-  "border_crossings",
-  "toxic_releases",
-  "power_emissions",
-  "river_discharge",
-  "air_quality",
-  "volcanoes_world",
-  "lock_delays",
-  "snowpack",
-  "drought",
-  "storm_reports",
-  "wildfire_incidents",
-  "aircraft",
-  "military_aircraft",
-  "gps_interference"
-]New value: +[
+  "temperature",
+  "wind",
+  "pressure_change",
+  "snow_depth",
+  "wsi",
+  "water_level",
+  "river_flow",
+  "ice",
+  "sightings",
+  "volcanoes",
+  "flood_gauges",
+  "epa_facilities",
+  "recalls",
+  "contract_awards",
+  "wildlife",
+  "natural_events",
+  "world_bank",
+  "earthquakes_emsc",
+  "tropical_cyclones",
+  "power_plants",
+  "eu_industrial_production",
+  "fema_declarations",
+  "earthquakes",
+  "lock_traffic",
+  "border_crossings",
+  "toxic_releases",
+  "power_emissions",
+  "river_discharge",
+  "air_quality",
+  "volcanoes_world",
+  "lock_delays",
+  "snowpack",
+  "drought",
+  "storm_reports",
+  "wildfire_incidents",
+  "aircraft",
+  "military_aircraft",
+  "gps_interference",
+  "weather_alerts",
+  "fires",
+  "persistent_heat",
+  "steel_plant_heat"
+]

addedInput schema / properties / kind

Added value: +{
+  "description": "weather_alerts: warning | watch | advisory",
+  "type": "string"
+}

addedInput schema / properties / marine

Added value: +{
+  "description": "weather_alerts: include marine alerts",
+  "type": "boolean"
+}

Changed2 schema fields changedOct 27, 2026

changedInput schema / properties / id / enum

Previous value: -[
-  "temperature",
-  "wind",
-  "pressure_change",
-  "snow_depth",
-  "wsi",
-  "water_level",
-  "river_flow",
-  "ice",
-  "sightings",
-  "volcanoes",
-  "flood_gauges",
-  "epa_facilities",
-  "recalls",
-  "contract_awards",
-  "wildlife",
-  "natural_events",
-  "world_bank",
-  "earthquakes_emsc",
-  "tropical_cyclones",
-  "power_plants",
-  "eu_industrial_production",
-  "fema_declarations",
-  "earthquakes",
-  "lock_traffic",
-  "border_crossings",
-  "toxic_releases",
-  "power_emissions",
-  "river_discharge",
-  "air_quality",
-  "volcanoes_world",
-  "lock_delays",
-  "snowpack",
-  "drought",
-  "storm_reports",
-  "wildfire_incidents"
-]New value: +[
+  "temperature",
+  "wind",
+  "pressure_change",
+  "snow_depth",
+  "wsi",
+  "water_level",
+  "river_flow",
+  "ice",
+  "sightings",
+  "volcanoes",
+  "flood_gauges",
+  "epa_facilities",
+  "recalls",
+  "contract_awards",
+  "wildlife",
+  "natural_events",
+  "world_bank",
+  "earthquakes_emsc",
+  "tropical_cyclones",
+  "power_plants",
+  "eu_industrial_production",
+  "fema_declarations",
+  "earthquakes",
+  "lock_traffic",
+  "border_crossings",
+  "toxic_releases",
+  "power_emissions",
+  "river_discharge",
+  "air_quality",
+  "volcanoes_world",
+  "lock_delays",
+  "snowpack",
+  "drought",
+  "storm_reports",
+  "wildfire_incidents",
+  "aircraft",
+  "military_aircraft",
+  "gps_interference"
+]

addedInput schema / properties / radius

Added value: +{
+  "description": "aircraft, gps_interference: nautical miles around lat/lng, 1-250",
+  "type": "number"
+}

Changed5 schema fields changedOct 11, 2026

addedInput schema / properties / continuing

Added value: +{
+  "description": "volcanoes_world: only eruptions in progress",
+  "type": "boolean"
+}

addedInput schema / properties / erupted_since

Added value: +{
+  "description": "volcanoes_world: year, default 1900",
+  "type": "number"
+}

addedInput schema / properties / fuel / description

Added value: +"power_plants: coal, oil/gas, nuclear, hydropower, wind, utility-scale solar, geothermal or bioenergy"

changedInput schema / properties / id / enum

Previous value: -[
-  "temperature",
-  "wind",
-  "pressure_change",
-  "snow_depth",
-  "wsi",
-  "water_level",
-  "river_flow",
-  "ice",
-  "sightings",
-  "volcanoes",
-  "flood_gauges",
-  "epa_facilities",
-  "recalls",
-  "contract_awards",
-  "wildlife",
-  "natural_events",
-  "world_bank",
-  "earthquakes_emsc",
-  "tropical_cyclones",
-  "power_plants",
-  "eu_industrial_production",
-  "fema_declarations",
-  "earthquakes"
-]New value: +[
+  "temperature",
+  "wind",
+  "pressure_change",
+  "snow_depth",
+  "wsi",
+  "water_level",
+  "river_flow",
+  "ice",
+  "sightings",
+  "volcanoes",
+  "flood_gauges",
+  "epa_facilities",
+  "recalls",
+  "contract_awards",
+  "wildlife",
+  "natural_events",
+  "world_bank",
+  "earthquakes_emsc",
+  "tropical_cyclones",
+  "power_plants",
+  "eu_industrial_production",
+  "fema_declarations",
+  "earthquakes",
+  "lock_traffic",
+  "border_crossings",
+  "toxic_releases",
+  "power_emissions",
+  "river_discharge",
+  "air_quality",
+  "volcanoes_world",
+  "lock_delays",
+  "snowpack",
+  "drought",
+  "storm_reports",
+  "wildfire_incidents"
+]

addedInput schema / properties / status

Added value: +{
+  "description": "power_plants: operating | construction",
+  "type": "string"
+}

Changed5 schema fields changedOct 11, 2026

addedInput schema / properties / country

Added value: +{
+  "description": "power_plants: ISO alpha-3, e.g. DEU",
+  "type": "string"
+}

addedInput schema / properties / fuel
```
Added value: +{
+  "type": "string"
+}
```

changedInput schema / properties / id / enum

Previous value: -[
-  "temperature",
-  "wind",
-  "pressure_change",
-  "snow_depth",
-  "wsi",
-  "water_level",
-  "river_flow",
-  "ice",
-  "sightings",
-  "volcanoes",
-  "flood_gauges",
-  "epa_facilities",
-  "recalls",
-  "contract_awards",
-  "wildlife",
-  "natural_events",
-  "world_bank",
-  "earthquakes"
-]New value: +[
+  "temperature",
+  "wind",
+  "pressure_change",
+  "snow_depth",
+  "wsi",
+  "water_level",
+  "river_flow",
+  "ice",
+  "sightings",
+  "volcanoes",
+  "flood_gauges",
+  "epa_facilities",
+  "recalls",
+  "contract_awards",
+  "wildlife",
+  "natural_events",
+  "world_bank",
+  "earthquakes_emsc",
+  "tropical_cyclones",
+  "power_plants",
+  "eu_industrial_production",
+  "fema_declarations",
+  "earthquakes"
+]

addedInput schema / properties / indicator
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / min_mw
```
Added value: +{
+  "type": "number"
+}
```

First observedOct 10, 2026

TDQS

C2.9/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does add meaningful behavior: the fallback to 'the latest observed before it, never a guess' and the point-per-place versus point-per-event distinction. However, it omits other important behavioral traits such as read-only nature, permissions, size limits, and pagination or error behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single dense but front-loaded sentence that leads with the output type and then explains the point semantics. It wastes little space, though the parenthetical fallback clause slightly interrupts readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 28 parameters, no annotations, and no output schema, the description is too thin. It explains the output shape but not how the many optional parameters interact, which ones apply to which layer ids, or what happens with invalid or missing data.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 71%, so roughly a quarter of the 28 parameters are undocumented. The description itself adds no parameter semantics at all, leaving ambiguous optional filters like min, bbox, state, window, elevated, and indicator to the schema, where several are bare.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that it returns one map layer as a GeoJSON FeatureCollection, with a specific point-per-place or point-per-event semantics. It distinguishes the shape of the output but does not explicitly differentiate itself from siblings such as get_readings or list_layers.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It does not say when to use this tool instead of get_readings, get_dataset_part, or list_layers, nor does it explain when not to use it. Usage is only implied by the phrase 'One map layer.'

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All open-signals tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

get_layer

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources