GribStream MCP

Official10 tools

by GribStream

Hosted weather data MCP for discovery, validation, and OAuth-protected GribStream queries.

Weather data API with discovery, validation, and OAuth-protected query capabilities.

Captured live from the server via tools/list.

gribstream_list_datasets

NO AUTH / PUBLIC / READ-ONLY. Lists public GribStream datasets and metadata. This tool does not query weather values and cannot return forecast data. Supports catalog filters such as code, family, tag, and is_ensemble.

Parameters (4)

codeany
Dataset code or list of dataset codes, for example gfs or ["gfs", "ifsoper"].
familystring
Dataset family filter, for example gfs, ifs, nbm, hrrr, rap, rtma, urma.
is_ensembleboolean
Filter to ensemble datasets when true, or deterministic datasets when false.
tagany
Tag or list of tags. Multiple tags use AND semantics in the API.

gribstream_get_dataset

NO AUTH / PUBLIC / READ-ONLY. Gets full public metadata for one dataset code, including archive coverage, cadence, tags, source links, and members. This tool does not query weather values and cannot return forecast data.

Parameters (1)

datasetstringrequired
Dataset code, for example gfs, nbm, ifsoper, hrrr, urma.

gribstream_list_parameters

NO AUTH / PUBLIC / READ-ONLY. Lists parameter summaries for one dataset. Use this before selecting exact case-sensitive parameter codes. This tool does not query weather values and cannot return forecast data.

Parameters (1)

datasetstringrequired
Dataset code, for example ifsoper.

gribstream_get_parameter

NO AUTH / PUBLIC / READ-ONLY. Gets detailed metadata and exact selector variations for one dataset parameter. Parameter codes are case-sensitive. This tool does not query weather values and cannot return forecast data.

Parameters (2)

datasetstringrequired
Dataset code, for example ifsoper.
parameterstringrequired
Exact case-sensitive parameter short name, for example 100u, 2t, TMP, or APCP.

gribstream_list_shared_parameters

NO AUTH / PUBLIC / READ-ONLY. Lists normalized shared parameter presets that can map one logical signal across datasets. This tool does not query weather values and cannot return forecast data.

Parameters (2)

datasetany
Optional dataset code or list of dataset codes to filter supported shared parameters.
dataset_modestring
Whether every listed dataset must support the preset or any one may support it.

gribstream_resolve_shared_parameter

NO AUTH / PUBLIC / READ-ONLY. Resolves one shared parameter preset for a dataset, returning native variables and expressions to use in /timeseries or /runs request bodies. This tool does not execute the request, query weather values, or return forecast data.

Parameters (3)

aliasstring
Optional output alias for the resolved request.
datasetstring
Optional dataset code to resolve the shared parameter against.
parameterstringrequired
Shared parameter code, for example temperature_2m, wind_speed_10m, mean_sea_level_pressure, or wind_speed_500hpa.

gribstream_get_expression_reference

NO AUTH / PUBLIC / READ-ONLY. Gets the GribStream expression language reference, including github.com/expr-lang/expr syntax guidance, alias rules, examples, and the full exported func.* math function list. This tool does not query weather values and cannot return forecast data.

No parameters.

gribstream_build_timeseries_request

NO AUTH / PUBLIC / READ-ONLY. Builds and validates a copy-pasteable authenticated /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 data. Generated direct API requests include Accept-Encoding: gzip, and generated curl commands use --compressed so large responses can be transferred compressed when the client supports it. Do not include request.asOf unless the user explicitly wants backtesting, time travel, or a historical model-run cutoff. The request body must use exact selectors discovered from the catalog or shared-parameter tools, with coordinates in request.coordinates and selectors in request.variables.

Parameters (3)

acceptstring
Desired response format for the eventual HTTP request.
datasetstringrequired
Dataset code, for example gfs, ifsoper, nbm, hrrr, or urma.
requestobjectrequired
Timeseries request body. Use either timesList or fromTime+untilTime as UTC valid times. Omit asOf unless the user explicitly asks for backtesting, time travel, what was known then, or a historical model-run cutoff. Coordinates must be in request.coordinates, and variable selectors must be in request.variables.

gribstream_build_runs_request

NO AUTH / PUBLIC / READ-ONLY. Builds and validates a copy-pasteable authenticated /api/v2/{dataset}/runs HTTP request without sending it. This tool does not execute the request, query weather values, or return forecast data. Use gribstream_query_runs when the user asks for actual model-run forecast data or CSV/JSON/NDJSON data. Generated direct API requests include Accept-Encoding: gzip, and generated curl commands use --compressed so large responses can be transferred compressed when the client supports it. The request body must use exact selectors discovered from the catalog or shared-parameter tools, with coordinates in request.coordinates and selectors in request.variables.

Parameters (3)

acceptstring
Desired response format for the eventual HTTP request.
datasetstringrequired
Dataset code, for example gfs, ifsoper, nbm, hrrr, or urma.
requestobjectrequired
Runs request body. Use either timesList or forecastedFrom+forecastedUntil as UTC model run times. Coordinates must be in request.coordinates, and variable selectors must be in request.variables.

gribstream_validate_request

NO AUTH / PUBLIC / READ-ONLY. Validates the basic shape, exact selector tuples, and expression syntax of a proposed 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 when changing a request from one dataset to another.

Parameters (3)

datasetstringrequired
Dataset code, for example gfs, ifsoper, nbm, hrrr, or urma.
endpointstringrequired
Endpoint to validate.
requestobjectrequired
Request body to validate. Omit asOf unless the user explicitly asks for backtesting, time travel, what was known then, or a historical model-run cutoff for /timeseries. Use request.coordinates for point coordinates and request.variables for variable selectors.

Install

Tools (10)

gribstream_list_datasetsgribstream_get_datasetgribstream_list_parametersgribstream_get_parametergribstream_list_shared_parametersgribstream_resolve_shared_parametergribstream_get_expression_referencegribstream_build_timeseries_request

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://gribstream.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gribstream.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.