NOAA NCEI (Climate / Degree-Days)

Methods (5)

• getDegreeDays

  read

  Heating/cooling degree-day climate normals (HDD/CDD) by station — annual, seasonal, or monthly.

  Input schema

  {
    "type": "object",
    "properties": {
      "station": {
        "type": "string",
        "examples": [
          "USW00013904"
        ],
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      },
      "period": {
        "type": "string",
        "examples": [
          "annual"
        ],
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "monthly"
            ]
          },
          {
            "type": "string",
            "enum": [
              "annual"
            ]
          },
          {
            "type": "string",
            "enum": [
              "seasonal"
            ]
          }
        ]
      },
      "dataTypes": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      }
    },
    "additionalProperties": false,
    "required": [
      "station"
    ]
  }

  Whole degree-days, °F base (65°F). period: annual|seasonal|monthly.

• getDailySummaries

  read

  Daily climate summaries (TMAX/TMIN/PRCP) by station + date range, scaled to °C / mm.

  Input schema

  {
    "type": "object",
    "properties": {
      "station": {
        "type": "string",
        "examples": [
          "USW00013904"
        ],
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      },
      "startDate": {
        "type": "string",
        "examples": [
          "2024-01-01"
        ]
      },
      "endDate": {
        "type": "string",
        "examples": [
          "2024-01-31"
        ]
      },
      "dataTypes": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      }
    },
    "additionalProperties": false,
    "required": [
      "station",
      "startDate",
      "endDate"
    ]
  }

  Temps tenths-°C→°C, precip tenths-mm→mm. Dates YYYY-MM-DD.

• searchStations

  read

  Discover GHCN stations by bounding box or id; returns id, coordinates, and period of record.

  Input schema

  {
    "type": "object",
    "properties": {
      "bbox": {
        "type": "object",
        "properties": {
          "north": {
            "type": "number"
          },
          "west": {
            "type": "number"
          },
          "south": {
            "type": "number"
          },
          "east": {
            "type": "number"
          }
        },
        "required": [
          "north",
          "west",
          "south",
          "east"
        ],
        "additionalProperties": false
      },
      "station": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      },
      "dataTypes": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      },
      "dataset": {
        "type": "string"
      },
      "limit": {
        "type": "number"
      },
      "offset": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  bbox order: north,west,south,east. Page with limit (max 1000) + offset.

• listDatasets

  read

  List the NCEI dataset catalog (id, name, period of record, description).

  Input schema

  {
    "type": "object",
    "properties": {
      "limit": {
        "type": "number",
        "examples": [
          50
        ]
      },
      "offset": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  Paged with limit + offset.

• getServiceInfo

  read

  Connector metadata: endpoints, degree-day dataTypes, unit conventions, and a reachability probe.

  Input schema

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  No arguments. Useful for discovery.