noaa-climate-mcp-server

v0.9.0 pre-1.0

Search NOAA climate stations and datasets, fetch historical weather observations via MCP. STDIO or Streamable HTTP.

noaa-climate.caseyjhand.com/mcp
claude mcp add --transport http noaa-climate-mcp-server https://noaa-climate.caseyjhand.com/mcp
codex mcp add noaa-climate-mcp-server --url https://noaa-climate.caseyjhand.com/mcp
{
  "mcpServers": {
    "noaa-climate-mcp-server": {
      "url": "https://noaa-climate.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http noaa-climate-mcp-server https://noaa-climate.caseyjhand.com/mcp
{
  "mcpServers": {
    "noaa-climate-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://noaa-climate.caseyjhand.com/mcp"
      ]
    }
  }
}
{
  "mcpServers": {
    "noaa-climate-mcp-server": {
      "type": "http",
      "url": "https://noaa-climate.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://noaa-climate.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

11

noaa_climate_list_datasets

List available NOAA CDO datasets with their IDs, names, and temporal coverage. Returns all ~11 datasets by default (no required parameters). Optionally filter to datasets that contain a specific data type, cover a location or station, or overlap a date range. Common datasets: GHCND (daily observations, 1763–present), GSOM (monthly summaries), GSOY (annual summaries), NORMAL_DLY/MLY/ANN/HLY (the superseded 1981–2010 normals; noaa_climate_get_normals serves the current 1991–2020 normals). Use this first to discover available datasets before calling noaa_climate_fetch_data.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_list_datasets",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "datatypeId": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Filter to datasets containing these data type IDs (e.g., [\"TMAX\", \"PRCP\"]). Optional."
    },
    "locationId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to datasets covering this location ID (e.g., \"FIPS:37\" for NC). Optional."
    },
    "stationId": {
      "type": "string",
      "minLength": 1,
      "pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
      "description": "Filter to datasets covering this station ID (e.g., \"GHCND:USW00024233\"). Optional. Trims surrounding whitespace, uppercases IDs, and accepts bare 11-character GHCN aliases (USW00024233 → GHCND:USW00024233). Other namespaced IDs remain accepted."
    },
    "startDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Inclusive lower coverage bound: dataset maxdate must be on or after this date. Applied locally to the complete matching catalog before pagination. Optional."
    },
    "endDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Inclusive upper coverage bound: dataset mindate must be on or before this date. Applied locally before pagination. Optional."
    },
    "sortField": {
      "description": "Sort results by this field. Optional.",
      "type": "string",
      "enum": [
        "id",
        "name",
        "mindate",
        "maxdate",
        "datacoverage"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Optional; defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results to return (1–1000). Defaults to 25. Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first result to return for pagination. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_list_data_categories

List data categories that group related data types — Temperature, Precipitation, Wind, Pressure, Sunshine, Sky cover, Weather Type, and more. Use to discover what types of measurements are available before calling noaa_climate_list_data_types. Optionally filter by dataset, location, station, or date range. There are 42 categories in total.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_list_data_categories",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "datasetId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to categories available in this dataset (e.g., \"GHCND\", \"GSOM\"). Optional."
    },
    "locationId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to categories available at this location ID. Optional."
    },
    "stationId": {
      "type": "string",
      "minLength": 1,
      "pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
      "description": "Filter to categories available at this station ID. Optional. Trims surrounding whitespace, uppercases IDs, and accepts bare 11-character GHCN aliases (USW00024233 → GHCND:USW00024233). Other namespaced IDs remain accepted."
    },
    "startDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to categories with data on or after this ISO date (YYYY-MM-DD). Optional."
    },
    "endDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to categories with data on or before this ISO date (YYYY-MM-DD). Optional."
    },
    "sortField": {
      "description": "Sort results by this field. Optional.",
      "type": "string",
      "enum": [
        "id",
        "name"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Optional; defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results to return (1–1000). Defaults to 25. Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first result to return for pagination. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_list_data_types

List available data types (measurement labels like TMAX, TMIN, PRCP, SNOW) for a given dataset or category. Pass a datasetId to see what is measured in that dataset, or a datacategoryId (e.g., "TEMP") to see all temperature-related types. Hundreds of types exist across all datasets. Use this before calling noaa_climate_fetch_data when the data type IDs are unknown. Common GHCND types: TMAX (max temperature), TMIN (min temperature), PRCP (precipitation), SNOW (snowfall), SNWD (snow depth), AWND (average wind speed).

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_list_data_types",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "datasetId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to data types available in this dataset (e.g., \"GHCND\", \"GSOM\"). Optional."
    },
    "datacategoryId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to data types in this category (e.g., \"TEMP\" for temperature types, \"PRCP\" for precipitation). Optional."
    },
    "locationId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to data types available at this location ID. Optional."
    },
    "stationId": {
      "type": "string",
      "minLength": 1,
      "pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
      "description": "Filter to data types available at this station ID. Optional. Trims surrounding whitespace, uppercases IDs, and accepts bare 11-character GHCN aliases (USW00024233 → GHCND:USW00024233). Other namespaced IDs remain accepted."
    },
    "startDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to data types with data on or after this ISO date (YYYY-MM-DD). Optional."
    },
    "endDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to data types with data on or before this ISO date (YYYY-MM-DD). Optional."
    },
    "sortField": {
      "description": "Sort results by this field. Optional.",
      "type": "string",
      "enum": [
        "id",
        "name",
        "mindate",
        "maxdate",
        "datacoverage"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Optional; defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results to return (1–1000). Defaults to 25. Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first result to return for pagination. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_list_location_categories

List the location categories that scope noaa_climate_find_locations — CITY, CLIM_DIV, CLIM_REG, CNTRY, CNTY, HYD_ACC, HYD_CAT, HYD_REG, HYD_SUB, ST, US_TERR, and ZIP. Call this first when you do not know which locationCategoryId to pass, including the hydrological categories needed to reach a basin or region. There are 12 categories in total. This endpoint takes pagination and sort only — NOAA CDO ignores dataset, location, station, and date filters here, so none are offered.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_list_location_categories",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "sortField": {
      "description": "Sort results by this field. Optional.",
      "type": "string",
      "enum": [
        "id",
        "name"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Optional; defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results to return (1–1000). Defaults to 25. Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first result to return for pagination. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_find_locations

open-world

Search for geographic locations by category (CITY, ST, CNTY, CNTRY, ZIP, CLIM_REG, etc.). Returns location IDs used in station search and data queries. Without locationCategoryId, returns all location types; noaa_climate_list_location_categories lists the valid values. Use locationCategoryId=ST to list US states (51 entries — small enough to retrieve completely). To find a location by name, pass nameContains alongside locationCategoryId — the CDO API has no name parameter, so this server enumerates the category and matches the substring itself. It works for any category under the size limit stated on nameContains, which is every category except ZIP; a datasetId or datacategoryId filter can bring a category back under that limit. For a category still too large, sort alphabetically with sortField=name and page through results. Location IDs: states as FIPS:37 (NC), cities as CITY:US530018 (Seattle), zip codes as ZIP:98101, countries as FIPS:US. Obtain location IDs here, then pass them to noaa_climate_find_stations or noaa_climate_fetch_data.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_find_locations",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "locationCategoryId": {
      "type": "string",
      "minLength": 1,
      "description": "Category filter. Use ST for states (51 entries), CNTY for counties, CITY for cities (large set — thousands of entries), CNTRY for countries, ZIP for zip codes, US_TERR for US territories, CLIM_REG for NOAA climate regions, CLIM_DIV for climate divisions, HYD_ACC/HYD_CAT/HYD_REG/HYD_SUB for hydrological categories. Call noaa_climate_list_location_categories when you do not know which category to use — it returns the authoritative set. Optional — omit to return all location types."
    },
    "nameContains": {
      "type": "string",
      "minLength": 1,
      "description": "Case-insensitive substring match on the location name. The CDO API has no name parameter, so this server applies the match itself, across the whole category rather than one page — which bounds it to a category holding at most 4000 locations. Requires locationCategoryId; adding datasetId or datacategoryId narrows a category that is otherwise too large. Example: locationCategoryId=\"CITY\" with nameContains=\"seattle\". Optional."
    },
    "datasetId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to locations covered by this dataset (e.g., \"GHCND\"). Optional."
    },
    "datacategoryId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to locations with this data category (e.g., \"TEMP\"). Optional."
    },
    "startDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to locations with data on or after this ISO date (YYYY-MM-DD). Optional."
    },
    "endDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to locations with data on or before this ISO date (YYYY-MM-DD). Optional."
    },
    "sortField": {
      "description": "Sort results by this field. Use name with sortOrder=asc to browse alphabetically when searching for a specific city or location name. Optional.",
      "type": "string",
      "enum": [
        "id",
        "name",
        "mindate",
        "maxdate",
        "datacoverage"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Optional; defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results to return (1–1000). Defaults to 25. Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first result to return for pagination. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_find_stations

open-world

Search for weather observation stations by location, bounding box, dataset, and data type. Returns station IDs, names, coordinates, elevation, and data coverage dates. Filter by locationId (e.g., "FIPS:37" for all NC stations), extent (lat/lon bounding box), datasetId, datatypeId, and date range. Station IDs returned here are used as stationId in noaa_climate_fetch_data. A station must have data for the dataset and date range you want — filter by datasetId and startDate/endDate to ensure compatibility. Common station ID formats: GHCND:USW00024233, COOP:010008.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_find_stations",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "locationId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to stations within this location ID (e.g., \"FIPS:37\" for NC, \"CITY:US530018\" for Seattle). Obtain from noaa_climate_find_locations. Optional."
    },
    "extent": {
      "type": "string",
      "pattern": "^\\s*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?\\s*,\\s*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?\\s*,\\s*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?\\s*,\\s*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?\\s*$",
      "description": "Bounding box as \"minLat,minLon,maxLat,maxLon\": four finite signed decimal or scientific numbers with optional surrounding whitespace, latitude ±90 and longitude ±180. Equal coordinates are accepted; reversed axes return no matches, without wrapping. Example: \"47.5,-122.4,47.7,-122.1\". Optional."
    },
    "datasetId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to stations that have data in this dataset (e.g., \"GHCND\" for daily observations). Optional."
    },
    "datatypeId": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Filter to stations that record these data types (e.g., [\"TMAX\", \"TMIN\", \"PRCP\"]). Optional."
    },
    "datacategoryId": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to stations with data in this category (e.g., \"TEMP\"). Optional."
    },
    "startDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to stations with data on or after this ISO date (YYYY-MM-DD). Optional."
    },
    "endDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Filter to stations with data on or before this ISO date (YYYY-MM-DD). Optional."
    },
    "sortField": {
      "description": "Sort results by this field. Optional.",
      "type": "string",
      "enum": [
        "id",
        "name",
        "mindate",
        "maxdate",
        "datacoverage"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Optional; defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results to return (1–1000). Defaults to 25. Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first result to return for pagination. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_get_station

Fetch full metadata for a single weather station by its ID (e.g., "GHCND:USW00024233", "COOP:010008"). Returns name, coordinates, elevation, and the full date range for which data is available. Use when you have a station ID from noaa_climate_find_stations and want its complete details, or to verify a station before querying data.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_get_station",
    "arguments": {
      "stationId": "<stationId>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "stationId": {
      "type": "string",
      "minLength": 1,
      "pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
      "description": "Station ID to fetch (e.g., \"GHCND:USW00024233\", \"COOP:010008\"). Obtain from noaa_climate_find_stations. Trims surrounding whitespace, uppercases IDs, and accepts bare 11-character GHCN aliases (USW00024233 → GHCND:USW00024233). Other namespaced IDs remain accepted."
    }
  },
  "required": [
    "stationId"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_fetch_data

open-world

Fetch historical observation records from a NOAA CDO dataset for a given date range. Requires datasetId, startDate, and endDate; optionally filter stations, locations, and datatypes. The encoded query is limited to 4000 characters; reduce filters and make separate calls if exceeded. Sub-daily, daily, and radar datasets allow 1 year; GSOM/GSOY/NORMAL_MLY/NORMAL_ANN allow 10 years, through the end of the corresponding calendar month. NORMAL_* datasets are the superseded 1981–2010 normals, dated in the API proxy year 2010; for the current 1991–2020 normals use noaa_climate_get_normals. Request units=metric or units=standard: omitted units retain datatype-specific raw scales. Examples: GHCND TMAX/TMIN tenths °C, PRCP tenths mm, SNOW/SNWD whole mm; GSOM/GSOY temperature/precipitation °C/mm; NORMAL_* temperature normals tenths °F and precipitation normals hundredths inches; PRECIP_HLY/HPCP and PRECIP_15/QPCP hundredths inches. These examples are not universal conversion rules. Missing precipitation rows omit value and carry missing=true; GHCND flags expose quality-check failures without dropping values.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_fetch_data",
    "arguments": {
      "datasetId": "<datasetId>",
      "startDate": "<startDate>",
      "endDate": "<endDate>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "datasetId": {
      "type": "string",
      "minLength": 1,
      "description": "Dataset ID to query (e.g., GHCND for daily data, GSOM for monthly, GSOY for annual, NORMAL_DLY/MLY/ANN/HLY for the superseded 1981–2010 normals, NEXRAD2/NEXRAD3 for weather radar); noaa_climate_get_normals serves the current 1991–2020 normals. Determines date range limit: GHCND/PRECIP_*/NORMAL_DLY/NORMAL_HLY/NEXRAD2/NEXRAD3 allow 1-year max per request; GSOM/GSOY/NORMAL_MLY/NORMAL_ANN allow 10-year max."
    },
    "startDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "Start date for observations (YYYY-MM-DD). For NORMAL_* datasets use 2010-01-01 — CDO dates its 1981–2010 normals in the proxy year 2010."
    },
    "endDate": {
      "type": "string",
      "pattern": "^(?:\\d{4}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01])|\\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\\d|3[01])(?:T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?)?)$",
      "description": "End date for observations (YYYY-MM-DD). Must be within 1 year of startDate for sub-daily/daily/radar datasets (GHCND, PRECIP_15, PRECIP_HLY, NORMAL_DLY, NORMAL_HLY, NEXRAD2, NEXRAD3) or within 10 years for monthly/annual datasets (GSOM, GSOY, NORMAL_MLY, NORMAL_ANN) — measured to the end of the calendar month that many years after startDate, so a full calendar year (2024-01-01 to 2024-12-31) always fits. For any NORMAL_* dataset use 2010-12-31."
    },
    "stationId": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
        "description": "Station ID. Trims surrounding whitespace, uppercases IDs, and accepts bare 11-character GHCN aliases (USW00024233 → GHCND:USW00024233). Other namespaced IDs remain accepted."
      },
      "description": "One or more station IDs to filter by (e.g., [\"GHCND:USW00024233\"]). Obtain from noaa_climate_find_stations. Multiple IDs return comparative readings across stations. Optional."
    },
    "locationId": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "One or more location IDs to filter by (e.g., [\"FIPS:37\", \"ZIP:98101\"]). Broader than stationId — returns data from all stations within the location. Optional."
    },
    "datatypeId": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "One or more data type IDs to include (e.g., [\"TMAX\", \"TMIN\", \"PRCP\"]). Without this, all data types for the dataset are returned. Use noaa_climate_list_data_types to discover valid IDs. Optional."
    },
    "units": {
      "description": "Request metric or standard conversion. Omission preserves datatype-specific raw values: GHCND TMAX/TMIN tenths °C, PRCP tenths mm, SNOW/SNWD whole mm; GSOM/GSOY temperature/precipitation °C/mm; NORMAL_* temperature normals tenths °F and precipitation normals hundredths inches; HPCP/QPCP hundredths inches. Examples are not complete unit metadata. Under metric, CDO converts some NORMAL_* degree days, diurnal ranges, and standard deviations as if they were temperatures, which makes them wrong: -HTDD-NORMAL, -CLDD-NORMAL, -GRDD-TB4886, -GRDD-TB5086, and -DUTR-NORMAL on NORMAL_MLY and NORMAL_ANN; -STDDEV on NORMAL_MLY; -DUTR-NORMAL and -STDDEV on NORMAL_DLY. For those omit units and convert the raw values (whole °F-day degree days ×5/9, tenths-°F ranges and standard deviations ×1/18). Optional.",
      "type": "string",
      "enum": [
        "standard",
        "metric"
      ]
    },
    "includemetadata": {
      "default": true,
      "description": "Include pagination metadata in the response. Defaults to true.",
      "type": "boolean"
    },
    "sortField": {
      "description": "Sort results by this field. Optional.",
      "type": "string",
      "enum": [
        "datatype",
        "date",
        "station"
      ]
    },
    "sortOrder": {
      "description": "Sort direction. Optional; defaults to asc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of records to return (1–1000). Defaults to 25. Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first record to return for pagination. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "datasetId",
    "startDate",
    "endDate",
    "includemetadata",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_get_normals

open-world

Fetch one station's 1991–2020 U.S. Climate Normals, NOAA's current 30-year baseline, for comparing an observed day, month, season, or year against normal. Covers monthly, daily, hourly, and annual/seasonal normals of temperature, precipitation, snowfall, degree days, and the other NCEI normals elements, and needs no token. noaa_climate_fetch_data's NORMAL_* datasets are the superseded 1981–2010 normals. stationId is a GHCN-Daily ID such as USW00024233; about 15,600 stations carry monthly, daily, and annual/seasonal normals, about 470 (nearly all USW stations) hourly normals, and precipitation-only stations carry no temperature normals. Values stay in NCEI's native units — °F, inches, °F-days, hPa — and are never converted; a record carries its unit wherever that unit was verified. Each record carries NCEI's completeness flag and the years of data behind it: S is standard, while R, P, and E mark normals built from fewer years or estimated from neighboring stations. A -9999 value comes back as missing=true with no value. An unknown station and a station without normals both return no records.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_get_normals",
    "arguments": {
      "stationId": "<stationId>",
      "granularity": "<granularity>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "stationId": {
      "type": "string",
      "minLength": 1,
      "pattern": "^\\s*(?:[Gg][Hh][Cc][Nn][Dd]:)?[A-Za-z]{2}[A-Za-z0-9_]{9}\\s*$",
      "description": "GHCN-Daily station to read, one per call (e.g., \"USW00024233\", Seattle-Tacoma International Airport). Find IDs with noaa_climate_find_stations; confirm one with noaa_climate_get_station. Trims surrounding whitespace, strips a GHCND: prefix (GHCND:USW00024233 → USW00024233), and uppercases an ID written all in lowercase. IDs are matched case-sensitively, so a mixed-case legacy ID such as US10adam002 is sent as written."
    },
    "granularity": {
      "type": "string",
      "enum": [
        "monthly",
        "daily",
        "hourly",
        "annualseasonal"
      ],
      "description": "Which normals product to read: monthly (rows \"01\"–\"12\"), daily (rows \"01-01\"–\"12-31\", including \"02-29\"), hourly (rows \"01-01T00:00:00\"–\"12-31T23:00:00\" in local standard time; month required), or annualseasonal (one row with no date — the period is the datatype prefix: ANN annual, DJF/MAM/JJA/SON seasons)."
    },
    "datatypeId": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Normals datatype IDs to read (1–50), uppercased before sending. Each must carry the granularity's prefix: MLY- for monthly; DLY-, MTD- (month-to-date), or YTD- (year-to-date) for daily; HLY- for hourly; ANN-, DJF-, MAM-, JJA-, or SON- for annualseasonal. Omitted, monthly reads MLY-TAVG-NORMAL, MLY-TMAX-NORMAL, MLY-TMIN-NORMAL, MLY-PRCP-NORMAL, and MLY-SNOW-NORMAL; annualseasonal the same five with ANN-; daily DLY-TAVG-NORMAL, DLY-TMAX-NORMAL, and DLY-TMIN-NORMAL; hourly HLY-TEMP-NORMAL and HLY-DEWP-NORMAL. NCEI's documentation for each product lists the rest — degree days such as MLY-HTDD-NORMAL, standard deviations, percentiles, and frost dates."
    },
    "month": {
      "description": "Month 1–12. Required for hourly, which is read one month at a time (744 rows per datatype for January). Narrows daily to that month’s days — February includes 02-29 — and monthly to that month. Rejected for annualseasonal, which has no month axis.",
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "limit": {
      "default": 100,
      "description": "Maximum records per page; a record is one datatype on one row. Defaults to 100, which holds the monthly defaults (60 records) or one month of daily defaults (up to 93). Larger positive integers are clamped to 1000 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first record to return. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "stationId",
    "granularity",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_search_storm_events

open-world

Search the NCEI Storm Events Database for one calendar year — tornadoes, hail, floods, hurricanes, winter storms, heat, and every other NWS Storm Data event type, with magnitude, direct and indirect casualties, property and crop damage, and narratives. This corpus carries discrete severe-weather events rather than CDO station observations, needs no token, and publishes one bulk file per year, so year is required. Filter by episodeId from a returned event, state (full NCEI name such as "FLORIDA", not "FL"), countyFips (five-digit county FIPS such as "53043", county rows only), eventType (exact NWS label such as "Tornado", "Flash Flood", or "Hurricane (Typhoon)", case-insensitive), begin month, inclusive local-calendar startDate/endDate overlap, and minDamageInUsd. County rows outside Alaska and the territories carry cdoLocationId (e.g. "FIPS:53043"), the locationId noaa_climate_find_stations and noaa_climate_fetch_data take; events also carry stateFips and czFips codes, the NWS forecast office (wfo), beginLocation, and end coordinates when NCEI filled them. Date bounds exclude missing, invalid, or reversed source spans before damage accounting, totals, and paging; cross-year bounds still search only the selected year export. Damage retains its raw magnitude-suffixed cell and parsed dollar amount; unreported figures are omitted, and minDamageInUsd discloses how many unknown figures it excluded. Events reference distinct page-local episodeNarratives by episodeNarrativeRef; eventNarrative stays on each event, and rendered narratives preserve literal source text. Optional local ISO beginDate/endDate values can feed CDO date filters; raw NCEI date-time and timezone remain available. Source row order, limit/offset pagination, and filtered totalCount are preserved; appliedDateRange echoes supplied bounds.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_search_storm_events",
    "arguments": {
      "year": "<year>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "episodeId": {
      "description": "Exact EPISODE_ID from a returned event. Surrounding whitespace is trimmed; blank means no filter. Leading zeros are significant. Keep year supplied.",
      "type": "string",
      "pattern": "^\\s*(?:\\d+\\s*)?$"
    },
    "year": {
      "type": "integer",
      "minimum": 1950,
      "maximum": 9007199254740991,
      "description": "Calendar year to search (1950 through the current partial year). Required — NCEI publishes one file per year, so an unscoped search would download every year back to 1950."
    },
    "state": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to this state or territory, written as the full name NCEI uses (e.g. \"FLORIDA\", \"PUERTO RICO\"), matched case-insensitively. Postal codes like \"FL\" match nothing. Optional."
    },
    "countyFips": {
      "description": "Filter to one county by its five-digit Census FIPS code, state then county (e.g. \"53043\" for Lincoln County, WA), or by a returned cdoLocationId (\"FIPS:53043\"). Surrounding whitespace is trimmed; leading zeros are significant. Matches exactly the events whose cdoLocationId it names, so county rows outside Alaska and the territories only: an event NCEI filed under a forecast or marine zone never matches. Optional.",
      "type": "string",
      "pattern": "^\\s*(?:FIPS:)?\\d{5}\\s*$"
    },
    "eventType": {
      "type": "string",
      "minLength": 1,
      "description": "Filter to this NWS event type, matched case-insensitively against the exact label (e.g. \"Tornado\", \"Hail\", \"Flash Flood\", \"Hurricane (Typhoon)\"). A miss returns the labels present in that year. Optional."
    },
    "month": {
      "description": "Filter to events whose begin date falls in this month (1–12). Optional.",
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "startDate": {
      "description": "Inclusive local-calendar lower bound (YYYY-MM-DD): an event must end on or after this date. Rows without both valid ordered endpoints are excluded. Only the selected year export is searched.",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "endDate": {
      "description": "Inclusive local-calendar upper bound (YYYY-MM-DD): an event must begin on or before this date. Rows without both valid ordered endpoints are excluded. Cross-year intervals are allowed; only year selects the export.",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "minDamageInUsd": {
      "description": "Filter to events whose property damage parses to at least this many dollars. Excludes every row whose damage NCEI did not report — about a fifth of a recent year — since an unreported figure cannot be shown to clear the threshold. Optional.",
      "type": "number",
      "minimum": 0
    },
    "limit": {
      "default": 10,
      "description": "Maximum events per page (1–100, default 10). Oversized positive integers are clamped to 100 with a notice; NOAA_CLAMP_LIMITS=false restores rejection above 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first matching event to return. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "year",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

noaa_climate_get_billion_dollar_disasters

open-world

Query NOAA/NCEI’s retired Billion-Dollar Weather and Climate Disasters archive (1980–2024), with CPI-adjusted and unadjusted costs and deaths. No years after 2024 are added; CPI adjustments are preserved from the archive, not rebased to current prices. Every cost is in WHOLE US DOLLARS, converted from each export’s declared unit (declaredCostUnit): millions per event, billions per national year, millions per state year. Default calls return individual disasters; summary=true returns per-year counts and costs by class plus an "All Disasters" total. Filter with startYear/endYear (overlapping disasters included), disasterType (exact NCEI class, e.g. "Tropical Cyclone"), minCostInUsd, and state (two-letter postal code). coveredYears reports the span actually present in the export. Under a state scope, per-event rows carry the NATIONAL cost of disasters that reached that state, never a state share, so summing states double-counts; per-year rows carry a binned range instead of a point estimate. Separate from CDO and noaa_climate_search_storm_events; no token required.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "noaa_climate_get_billion_dollar_disasters",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "startYear": {
      "description": "Earliest year to include (1980 or later). A disaster whose span reaches into the range is included even when it began earlier. Optional — omit for the whole record.",
      "type": "integer",
      "minimum": 1980,
      "maximum": 9007199254740991
    },
    "endYear": {
      "description": "Latest year to include (1980 or later). The retired archive ends in 2024; years past coveredYears.last return no records rather than an error. Optional.",
      "type": "integer",
      "minimum": 1980,
      "maximum": 9007199254740991
    },
    "disasterType": {
      "description": "Restrict to one NCEI disaster class, written exactly as NCEI writes it. In summary mode this also drops the \"All Disasters\" total from each year, leaving only the named class. Optional.",
      "type": "string",
      "enum": [
        "Drought",
        "Flooding",
        "Freeze",
        "Severe Storm",
        "Tropical Cyclone",
        "Wildfire",
        "Winter Storm"
      ]
    },
    "state": {
      "type": "string",
      "pattern": "^\\s*[A-Za-z]{2}\\s*$",
      "description": "Two-letter US postal code (e.g. \"CA\", \"TX\", \"PR\") scoping the query to NCEI’s per-state export instead of the national one. Per-event rows then carry the national cost of each disaster that reached the state, not a state share; per-year rows carry a binned cost range instead of a point estimate. Optional."
    },
    "minCostInUsd": {
      "description": "Floor on CPI-adjusted cost in whole US dollars — 1e9 is one billion. In summary mode this is compared against the year’s \"All Disasters\" total, or against the named disasterType when one is given; where only a binned range exists, the top of the bin has to clear the floor. Optional.",
      "type": "number",
      "minimum": 0
    },
    "summary": {
      "default": false,
      "description": "Return per-year counts and costs by disaster class instead of individual disasters. Defaults to false.",
      "type": "boolean"
    },
    "limit": {
      "default": 50,
      "description": "Maximum number of disasters or years to return (1–100). Defaults to 50. Larger positive integers are clamped to 100 with a notice unless NOAA_CLAMP_LIMITS=false.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based index of the first matching record to return. Defaults to 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "summary",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

Resources

2

All available NOAA CDO datasets with IDs, names, and temporal coverage. Use as injectable context to orient an agent on which datasets exist before querying data. Returns a small stable list (~11–13 datasets). Equivalent to calling noaa_climate_list_datasets with no filters and a high limit. Its NORMAL_* entries are the superseded 1981–2010 normals; noaa_climate_get_normals serves the current 1991–2020 normals.

uri noaa://datasets

Station metadata by ID — name, coordinates, elevation, and the full date range for which data is available. Mirrors noaa_climate_get_station as an injectable resource. URI format: noaa://stations/GHCND:USW00024233.

uri noaa://stations/{stationId}

Extensions

1

io.modelcontextprotocol/skills

{
  "directoryRead": true
}