GribStream Weather MCP

NO AUTH / PUBLIC / READ-ONLY. BuildsBuild and validatesvalidate a copy-pasteable authenticatedrunnable /api/v2/{dataset}/timeseries HTTP request without sending it. This tool does not execute the request, query weather values, or return forecast data. Use gribstream_query_timeseries when the user asks for actual weather values or CSV/JSON/NDJSON/Parquet data. Generated direct API requests include Accept-Encoding: gzip,request and generated curl commands use --compressed so large responses can be transferred compressed when thecommand clientwithout supportssending it. Do not include request.asOf unless the user explicitlyUse wantsgribstream_query_timeseries backtesting,to timeretrieve travel,data ordirectly; a historical model-run cutoff.separate Thebuild requestcall bodyis mustoptional. useUse exactcatalog selectors discovered fromin therequest.variables catalogand orpoints shared-parameterin tools,request.coordinates withor coordinatesone inrequest.grid. request.coordinatesOmit andasOf selectorsfor inlatest request.variables.forecasts.

 ⟨511 unchanged words⟩ :"number"},"step":{"description":"Grid spacingRequested insampling degrees.step Mustin bedegrees, greater than 0. Finer sampling does not increase forecast resolution. Native latitude and longitude steps can differ; projected and unstructured grids have no single degree step.","type":"number"}},"required": ⟨7 unchanged words⟩ "includeMetadata":{"description":"Optional additional row metadata.metadata: Thenative_coordinate onlyadds supportednative_lat/native_lon valuefor ismapping index_updated_at.requested

NO AUTH / PUBLIC / READ-ONLY. Gets full public metadata for one dataset code, includingInspect archive coverage, cadence, tagshorizon, source linksmembers, and members.native_grid Thisgeometry toolfor doesone notdataset. queryThe weathernative valuescoordinate URL requires authentication and cannotgeographic returnbounds; forecastgeometry data.does not prove variable availability.

NO AUTH / PUBLIC / READ-ONLY. Gets the GribStreamGet expression language reference, including github.com/expr-lang/expr syntax guidance, alias rules, examples, and the full exportedsupported func.* math function list. This tool doesfunctions notfor queryderived weather values and cannot return forecast data.signals.

 ⟨32 unchanged words⟩ temperature, use gribstream_resolve_shared_parameter before guessing a native code. This tool does not query weather values and cannot return forecast data.

NO AUTH / PUBLIC / READ-ONLY. Lists publicFind GribStreamcandidate datasets for a region and metadata.weather Thisvariable. toolFilter doesby notprovider, queryregion, weatherforecast_time, valuesshared_parameter and cannotis_ensemble; returnsort_by=resolution ranks nominal resolution in km. With shared_parameter, each result includes a validated request fragment and exact/approximate match. Use it directly in one gribstream_query_timeseries call. Coverage envelopes and forecast data.horizons Supportsare catalog filtershints, suchnot aslive code,availability family,guarantees. tag,No andweather is_ensemble.values are fetched.

 ⟨41 unchanged words⟩ rtma, urma.","type":"string"},"forecast_time":{"description":"Optional RFC3339 valid time with offset, e.g. 2026-10-16T12:00:00-03:00. Response normalizes to UTC. Filters nominal horizon, not live run availability. Resolve place and local timezone first; never assume local noon is UTC noon.","type":"string"},"is_ensemble":{"description":"Filter to ensemble datasets when true, or deterministic datasets when false.","type":"boolean"},"limit":{"description":"Maximum candidates to return; omit to inspect alternatives including unknown coverage.","maximum":200,"minimum":1,"type":"integer"},"provider":{"description":"Case-insensitive provider substring, e.g. Met Office, ECMWF, NOAA, DWD.","type":"string"},"region":{"additionalProperties":false,"properties":{"maxLat":{"maximum":90,"minimum":-90,"type":"number"},"maxLon":{"maximum":180,"minimum":-180,"type":"number"},"minLat":{"maximum":90,"minimum":-90,"type":"number"},"minLon":{"maximum":180,"minimum":-180,"type":"number"}},"required":["minLat","maxLat","minLon","maxLon"],"type":"object"},"shared_parameter":{"description":"Weather concept code, e.g. temperature_2m. Return only validated equivalents, including request fragments and approximation labels.","type":"string"},"sort_by":{"description":"Sort candidates by nominal source resolution, finest first; unknown coverage/resolution sorts last. Read coverage_kind before claiming a winner.","enum":["resolution"],"type":"string"},"tag":{"description":"Tag or ⟨21 unchanged words⟩ 

 ⟨12 unchanged words⟩  Use this before selecting exact case-sensitive parameter codes. This tool does not query weather values and cannot return forecast data.

 ⟨34 unchanged words⟩ as temperature_2m is already clear, call gribstream_resolve_shared_parameter directly. This tool does not query weather values and cannot return forecast data.

AUTH REQUIRED / DATA QUERY. Executes an authenticated /api/v2/{dataset}/runs request and returnsFetch actualor weather/forecastretrieve dataweather values across model runs. Use this tool, not the NO AUTH request-building orruns metadatato tools,compare whenchanging theforecasts. usertimesList asksselects toexact fetch,model retrieve,run downloadtimes, return,not orvalid analyzetimes; model-runminHorizon/maxHorizon history,constrain forecastlead aging,hours. changingUse forecasts,discovered CSV/JSON/NDJSON/Parquetrequest.variables data,with plots,coordinates or analysis. Defaults toone inlinegrid. CSV foris compatibility;the usedefault; URLuse deliverydelivery=url for dense grids and large tabular results. TimeResponse rangesrows are half-open:unsorted; thesort startby islocation, inclusiveforecasted_at and the end is exclusive. The start must be earlier than the end; equal bounds select no times. Use timesList for one exact valid time on /timeseries or one exact model run timeforecasted_time onbefore /runs.plotting. When a live query returns a resource_link,  ⟨54 unchanged words⟩  the query merely to obtain the file bytes. If the client reports that network or allowlist policy blocks the returned resource_link, do not retry URL delivery. For CSV, JSON, or NDJSON whose reported size is at most 10000000 bytes, retry the same request at most once with delivery=inline. Parquet cannot use inline delivery. If the artifact is larger, reduce the request using the documented split order before one inline CSV retry. For dense grids or large tabular results, use delivery=url so MCP returns a short-lived signed HTTPS resource link instead of putting the full dataset into tool output. Prefer application/vnd.apache.parquet only when a compatible Parquet reader is already known to be available. If reader availability is unknown, do not spend tool calls probing or installing packages; use text/csv with delivery=url immediately. Use one grid request, process the downloaded file locally, and never print or serialize the full file into chat or tool output. Do not install a dependency or write a Parquet parser solely for one result. When a real API request limit requires splitting, split by time range first, split variables second, and split coordinates/grid/space last; spatial tiling creates the most extra work. Response rows are unsorted; sort by location fields, forecasted_at, and forecasted_time before plotting, building time series, or checking for gaps. The request body must use request.coordinates and request.variables; do not use location, coord, coords, parameters, parameter, or variable as replacement field names.

 ⟨760 unchanged words⟩ :"number"},"step":{"description":"Grid spacingRequested insampling degrees.step Mustin bedegrees, greater than 0. Finer sampling does not increase forecast resolution. Native latitude and longitude steps can differ; projected and unstructured grids have no single degree step.","type":"number"}},"required": ⟨7 unchanged words⟩ "includeMetadata":{"description":"Optional additional row metadata.metadata: Thenative_coordinate onlyadds supportednative_lat/native_lon valuefor ismapping index_updated_at.requested

 ⟨469 unchanged words⟩  omit preview.","type":"string"},"recovery_guidance":{"description":"Actionable next steps for successful queries with zero rows.","type":"string"},"request_hash":{"description":"SHA-256 hash of the ⟨216 unchanged words⟩ 

AUTH REQUIRED / DATA QUERY. Executes an authenticated /api/v2/{dataset}/timeseries request and returns actual weather/forecast data values. Use this tool, not the NO AUTH request-buildingFetch or metadata tools, when theretrieve userweather asksvalues tofor fetchmaps, retrieve,heatmaps download,and return,analysis orat analyzeselected weathervalid values,times. CSV/JSON/NDJSON/ParquetUse data,discovered plots,request.variables heatmaps,with coordinates or best-availableone valuesgrid; byno validseparate time.build/validate Defaultscall tois inlineneeded. CSV foris compatibility;the usedefault; URLuse deliverydelivery=url for dense grids and large tabular results. Time rangesresults areand half-open:render the startdownloaded isfile inclusivelocally. andPrefer theParquet endonly iswith exclusive.an Theavailable startreader. mustUse betimesList earlierfor thanone theexact end;UTC equalvalid boundstime; selectomit noasOf times.for Uselatest timesListforecasts. forRequested onesampling exactdoes validnot timeincrease onnative /timeseriesresolution. orResponse onerows exactare modelunsorted; runsort timerows onbefore /runs.plotting. When a live query returns a resource_link,  ⟨54 unchanged words⟩  the query merely to obtain the file bytes. If the client reports that network or allowlist policy blocks the returned resource_link, do not retry URL delivery. For CSV, JSON, or NDJSON whose reported size is at most 10000000 bytes, retry the same request at most once with delivery=inline. Parquet cannot use inline delivery. If the artifact is larger, reduce the request using the documented split order before one inline CSV retry. For dense grids or large tabular results, use delivery=url so MCP returns a short-lived signed HTTPS resource link instead of putting the full dataset into tool output. Prefer application/vnd.apache.parquet only when a compatible Parquet reader is already known to be available. If reader availability is unknown, do not spend tool calls probing or installing packages; use text/csv with delivery=url immediately. Use one grid request, process the downloaded file locally, and never print or serialize the full file into chat or tool output. Do not install a dependency or write a Parquet parser solely for one result. When a real API request limit requires splitting, split by time range first, split variables second, and split coordinates/grid/space last; spatial tiling creates the most extra work. Do not include request.asOf unless the user explicitly wants backtesting, time travel, or a historical model-run cutoff. Response rows are unsorted; sort by location fields and forecasted_time before plotting, building time series, or checking for gaps. The request body must use request.coordinates and request.variables; do not use location, coord, coords, parameters, parameter, or variable as replacement field names.

 ⟨779 unchanged words⟩ :"number"},"step":{"description":"Grid spacingRequested insampling degrees.step Mustin bedegrees, greater than 0. Finer sampling does not increase forecast resolution. Native latitude and longitude steps can differ; projected and unstructured grids have no single degree step.","type":"number"}},"required": ⟨7 unchanged words⟩ "includeMetadata":{"description":"Optional additional row metadata.metadata: Thenative_coordinate onlyadds supportednative_lat/native_lon valuefor ismapping index_updated_at.requested

 ⟨469 unchanged words⟩  omit preview.","type":"string"},"recovery_guidance":{"description":"Actionable next steps for successful queries with zero rows.","type":"string"},"request_hash":{"description":"SHA-256 hash of the ⟨216 unchanged words⟩ 

NO AUTH / PUBLIC / READ-ONLY. Resolves onea sharedweather parameterconcept presetto forvalidated anative dataset,variables/expressions returningand nativean variablesexact andor expressionsapproximate tomatch uselabel. Use resolved_request directly in /timeseries or /runs/runs; requestread bodies.resolved_match for height differences and native statistics. Use this first for common natural-language concepts such  ⟨8 unchanged words⟩  instead of guessing dataset-native codes such as TMP. This tool does not execute the request, query weather values, or return forecast data.

 ⟨19 unchanged words⟩ GribStream /timeseries or /runs request without sending it. This tool does not execute the request, query weather values, or return forecast data. Use this before returning any hand-edited curl or  ⟨9 unchanged words⟩ 

 ⟨461 unchanged words⟩ :"number"},"step":{"description":"Grid spacingRequested insampling degrees.step Mustin bedegrees, greater than 0. Finer sampling does not increase forecast resolution. Native latitude and longitude steps can differ; projected and unstructured grids have no single degree step.","type":"number"}},"required": ⟨7 unchanged words⟩ "includeMetadata":{"description":"Optional additional row metadata.metadata: Thenative_coordinate onlyadds supportednative_lat/native_lon valuefor ismapping index_updated_at.requested sampling onto source cells; index_updated_at adds index freshness. Do not request forecasted_at or forecasted_time here; both  ⟨5 unchanged words⟩  automatically.","items":{"enum":["index_updated_at","native_coordinate"],"type":"string"},"type": ⟨207 unchanged words⟩