Get data
get_dataRead-onlyIdempotent
Values, totals, comparisons, people/POI counts, station observations, upper-air profiles, climate records, normals, degree days, teleconnection indices and forecaster text from any catalog dataset (models, radar, alerts, outlooks, tropical cyclones, aircraft recon, reference layers) at a place or several, over a bbox or area, along a path, or as items. select takes product:variable or product:property tokens, a standard name or a concept (population); send one space word and at most one time word (hours, start+end or at; run pins a cycle); stats reduces per step or over the area; omit units for SI. Example: {"select": ["wind_gusts_10m"], "locations": ["Cheyenne, WY", "Casper, WY"], "hours": 36, "stats": ["max"]}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"select": "<select>"
},
"name": "get_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Time: one instant. | |
| end | No | Time: window end (with `start`), inclusive. | |
| run | No | Time: a model run (reference time), or `latest` (non-empty). | |
| area | No | Space: a polygon by reference ({product, feature_id | feature_ids | filter}; the product must declare query.area_as_reference) or inline ({geometry}). Over a feature product, the overlay; over a grid, zonal statistics. | |
| bbox | No | Space: [west, south, east, north] in degrees. Items on a feature or text product; a grid needs `stats` (exactly 4 items). | |
| card | No | Shape the card (guide://smarterweather/views): intent only; the server fills the rest from the data. | |
| path | No | Space: a trajectory sampled at each vertex's ETA (no time word or stats): geometry or polyline with times, or departure + speed; departures fans out one element per departure. | |
| step | No | Bucket size for `stats`: PT15M, PT1H, PT3H, PT6H or P1D. | |
| view | No | concise (default): values and feature properties with a centroid and bbox; detailed adds simplified geometry, provenance and raw encodings. | |
| hours | No | Time: a rolling window of this many hours (ahead for a forecast, back for an analysis) (>= 1). | |
| limit | No | Frames per series element (default and max 168), or features per element (max 50); next_cursor continues (>= 1). | |
| start | No | Time: window start (with `end`), a date or RFC 3339. | |
| stats | No | Reducers per `step` bucket, over the whole window, or over the area's cells and features. `cumulative:` prefixes sum and degree_days only (a running total). | |
| units | No | metric, imperial or si; omitted returns each variable's catalog `units` (SI). | |
| where | No | Value criteria over the selected variables' standard_names, tested per sample: they mask the series, or are the predicate for windows and count reducers. | |
| cursor | No | next_cursor of the previous page, with the same arguments (non-empty). | |
| filter | No | On a feature product: expressions over its filterable properties, applied before aggregation. | |
| select | Yes | What to read: `product:variable`, `product:*`, `product` (a feature or text product's properties), a bare standard_name (resolved in the place's domain), or `@observed:<standard_name>` / `@forecast:<standard_name>` (at most 25 items). | |
| windows | No | Window search over `where`: consecutive runs of at least min_hours. | |
| criteria | No | What makes an hour good or bad for the caller's purpose: one entry per condition over the selected variables. Each scores every sample from +1 (ideal) through 0 (the acceptable limit) to -1 (unacceptable); the result's `suitability` block carries the per-criterion scores, the combined score (the minimum over the `must` criteria; a `must: false` criterion lowers the score but never below 0), the limiting criterion per sample, the windows of acceptable hours (at least windows.min_hours, default 2; windows.max_windows caps them, windows.activity names the purpose) and the best one. Say the ranges in request units. Send location or locations. With criteria, windows.light is refused: use a daylight criterion (at most 8 items). | |
| location | No | Space: one place (place text, ZIP or `lat,lon`). EDR position; `nearest` on a feature product (non-empty). | |
| locations | No | Space: up to 25 places; one result element per place (at most 25 items). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| units | Yes | ||
| results | Yes | One element per (select, place or area), tagged by kind. | |
| _sources | No | Per-source provenance: what produced these values and when. | |
| truncated | Yes | True when a page or an element is partial: next_cursor continues a page; an element's notes say why it is partial. | |
| attribution | No | Attribution the dataset licence requires. Cite it when quoting these values. | |
| data_status | No | Present only when the data service did not answer and a cached copy was served. | |
| next_cursor | Yes | With one element, or a call that reads only grids and snapshots: resend the same call with this as `cursor`. Otherwise each element carries its own. |