noaa-climate-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['datasetId', 'startDate', 'endDate'], 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of records to return (1â\x80\x931000). Defaults to 25.'}, 'units': {'enum': ['standard', 'metric'], 'type': 'string', 'description': 'Unit system for returned values. Without this parameter, GHCND returns raw tenths-of-unit integers (TMAX=256 = 25.6°C). Strongly recommended: pass metric (SI units) or standard (Fahrenheit/inches). Optional.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first record to return for pagination. Defaults to 0.'}, '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) â\x80\x94 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.'}, '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 1981â\x80\x932010 climate normals, NEXRAD2/NEXRAD3 for weather radar). 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.'}, 'sortField': {'enum': ['datatype', 'date', 'station'], 'type': 'string', 'description': 'Sort results by this field. Optional.'}, 'sortOrder': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Optional; defaults to asc.'}, '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 regardless of the years being analyzed â\x80\x94 2010 is the API proxy year for all normals.'}, 'stationId': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, '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.'}, 'datatypeId': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 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.'}, 'locationId': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': 'One or more location IDs to filter by (e.g., ["FIPS:37", "ZIP:98101"]). Broader than stationId â\x80\x94 returns data from all stations within the location. Optional.'}, 'includemetadata': {'type': 'boolean', 'default': True, 'description': 'Include pagination metadata in the response. Defaults to true.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['results', 'totalCount', 'effectiveQuery']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['service_unavailable', 'rate_limited', 'date_range_exceeded', 'upstream_auth_failed', 'validation_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `date_range_exceeded`: endDate is past the end of the calendar month 1 year after startDate for sub-daily/daily/radar datasets (GHCND, PRECIP_*, NORMAL_DLY, NORMAL_HLY, NEXRAD2, NEXRAD3), or 10 years after it for monthly/annual datasets (GSOM, GSOY, NORMAL_MLY, NORMAL_ANN). `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: Bad dataset ID, date format, or unknown station/location/datatype ID. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when no records were returned â\x80\x94 echoes query parameters and suggests how to broaden.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'datatype', 'station', 'value'], 'properties': {'date': {'type': 'string', 'description': 'Observation date-time in ISO 8601 format.'}, 'value': {'type': 'number', 'description': 'Observed value. Unit depends on the dataset and units parameter. For GHCND without units, this is a raw tenths-of-unit integer.'}, 'station': {'type': 'string', 'description': 'Station ID that recorded this observation.'}, 'datatype': {'type': 'string', 'description': 'Data type ID (e.g., TMAX, PRCP).'}, 'attributes': {'type': 'string', 'description': 'Quality flags and measurement attributes. Omitted when not provided.'}}, 'description': 'A single observation record.', 'additionalProperties': False}, 'description': 'Flat array of observation records sorted by date by default.'}, 'metadata': {'type': 'object', 'required': ['resultset'], 'properties': {'resultset': {'type': 'object', 'required': ['count', 'limit', 'offset'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching records.'}, 'limit': {'type': 'number', 'description': 'Page size used for this response.'}, 'offset': {'type': 'number', 'description': '1-based starting index of this page as returned by the NOAA CDO API.'}}, 'description': 'Pagination cursor fields for this response.', 'additionalProperties': False}}, 'description': 'Pagination metadata. Present when includemetadata=true.', 'additionalProperties': False}, 'exhausted': {'type': 'boolean', 'description': 'True when the requested offset is past the end of a non-empty result set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'totalCount': {'type': 'number', 'description': 'Total number of matching observation records before the page limit.'}, 'effectiveQuery': {'type': 'string', 'description': 'Summary of the effective query: dataset, date range, units, and any station/location/datatype filters applied.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of results to return (1â\x80\x931000). Defaults to 25.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first result to return for pagination. Defaults to 0.'}, '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.'}, 'datasetId': {'type': 'string', 'minLength': 1, 'description': 'Filter to locations covered by this dataset (e.g., "GHCND"). Optional.'}, 'sortField': {'enum': ['id', 'name', 'mindate', 'maxdate', 'datacoverage'], 'type': 'string', 'description': 'Sort results by this field. Use name with sortOrder=asc to browse alphabetically when searching for a specific city or location name. Optional.'}, 'sortOrder': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Optional; defaults to asc.'}, '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.'}, '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 â\x80\x94 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.'}, 'datacategoryId': {'type': 'string', 'minLength': 1, 'description': 'Filter to locations with this data category (e.g., "TEMP"). Optional.'}, 'locationCategoryId': {'type': 'string', 'minLength': 1, 'description': 'Category filter. Use ST for states (51 entries), CNTY for counties, CITY for cities (large set â\x80\x94 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 â\x80\x94 it returns the authoritative set. Optional â\x80\x94 omit to return all location types.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['results', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['service_unavailable', 'rate_limited', 'upstream_auth_failed', 'validation_error', 'name_filter_requires_category', 'name_filter_category_too_large'], 'description': 'Machine-readable failure mode. Declared by this tool: `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: A filter parameter is not recognized by the NOAA CDO API (e.g., unknown datacategoryId or datasetId). `name_filter_requires_category`: nameContains was supplied without a locationCategoryId to scope the enumeration. `name_filter_category_too_large`: The requested locationCategoryId holds more locations than nameContains can enumerate. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when no locations matched â\x80\x94 echoes applied filters and suggests how to broaden.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'description': 'Location ID (e.g., FIPS:37, CITY:US530018, ZIP:98101).'}, 'name': {'type': 'string', 'description': 'Human-readable location name.'}, 'maxdate': {'type': 'string', 'description': 'Latest date data is available for this location. Omitted when not provided.'}, 'mindate': {'type': 'string', 'description': 'Earliest date data is available for this location. Omitted when not provided.'}, 'datacoverage': {'type': 'number', 'description': 'Fractional data coverage (0â\x80\x931). Omitted when not provided by the API.'}}, 'description': 'A single location entry.', 'additionalProperties': False}, 'description': 'Matching locations.'}, 'metadata': {'type': 'object', 'required': ['resultset'], 'properties': {'resultset': {'type': 'object', 'required': ['count', 'limit', 'offset'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching locations â\x80\x94 the post-filter match count when appliedNameFilter is present.'}, 'limit': {'type': 'number', 'description': 'Page size used for this response.'}, 'offset': {'type': 'number', 'description': 'Starting index of this page: 1-based as returned by the NOAA CDO API, or the zero-based offset you supplied when appliedNameFilter is present.'}}, 'description': 'Pagination cursor fields for this response.', 'additionalProperties': False}}, 'description': 'Pagination metadata. Present when the API returns it.', 'additionalProperties': False}, 'exhausted': {'type': 'boolean', 'description': 'True when the requested offset is past the end of a non-empty result set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'totalCount': {'type': 'number', 'description': 'Total number of matching locations before the page limit.'}, 'appliedNameFilter': {'type': 'string', 'description': 'The nameContains value this response was filtered by. Present only when nameContains was supplied; every count below then describes the filtered set, not the whole category.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of results to return (1â\x80\x931000). Defaults to 25.'}, 'extent': {'type': 'string', 'minLength': 1, 'description': 'Bounding box filter as "minLat,minLon,maxLat,maxLon" (e.g., "47.5,-122.4,47.7,-122.1" for central Seattle). Optional.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first result to return for pagination. Defaults to 0.'}, '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.'}, 'datasetId': {'type': 'string', 'minLength': 1, 'description': 'Filter to stations that have data in this dataset (e.g., "GHCND" for daily observations). Optional.'}, 'sortField': {'enum': ['id', 'name', 'mindate', 'maxdate', 'datacoverage'], 'type': 'string', 'description': 'Sort results by this field. Optional.'}, 'sortOrder': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Optional; defaults to asc.'}, '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.'}, 'datatypeId': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1, 'description': 'Filter to stations that record these data types (e.g., ["TMAX", "TMIN", "PRCP"]). Optional.'}, '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.'}, 'datacategoryId': {'type': 'string', 'minLength': 1, 'description': 'Filter to stations with data in this category (e.g., "TEMP"). Optional.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['results', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['service_unavailable', 'rate_limited', 'upstream_auth_failed', 'validation_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: A filter parameter is not recognized by the NOAA CDO API (e.g., unknown locationId or datacategoryId). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when no stations matched â\x80\x94 echoes applied filters and suggests how to broaden.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'description': 'Station ID (e.g., GHCND:USW00024233, COOP:010008).'}, 'name': {'type': 'string', 'description': 'Station name.'}, 'maxdate': {'type': 'string', 'description': 'Latest date data is available at this station. Omitted when not provided.'}, 'mindate': {'type': 'string', 'description': 'Earliest date data is available at this station. Omitted when not provided.'}, 'latitude': {'type': 'number', 'description': 'Station latitude in decimal degrees. Omitted when not provided.'}, 'elevation': {'type': 'number', 'description': 'Station elevation. Unit depends on elevationUnit. Omitted when not provided.'}, 'longitude': {'type': 'number', 'description': 'Station longitude in decimal degrees. Omitted when not provided.'}, 'datacoverage': {'type': 'number', 'description': 'Fractional data coverage (0â\x80\x931). Omitted when not provided.'}, 'elevationUnit': {'type': 'string', 'description': 'Unit for elevation (e.g., "Meters"). Omitted when not provided.'}}, 'description': 'A single station entry.', 'additionalProperties': False}, 'description': 'Matching stations.'}, 'metadata': {'type': 'object', 'required': ['resultset'], 'properties': {'resultset': {'type': 'object', 'required': ['count', 'limit', 'offset'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching stations.'}, 'limit': {'type': 'number', 'description': 'Page size used for this response.'}, 'offset': {'type': 'number', 'description': '1-based starting index of this page as returned by the NOAA CDO API.'}}, 'description': 'Pagination cursor fields for this response.', 'additionalProperties': False}}, 'description': 'Pagination metadata. Present when the API returns it.', 'additionalProperties': False}, 'exhausted': {'type': 'boolean', 'description': 'True when the requested offset is past the end of a non-empty result set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'totalCount': {'type': 'number', 'description': 'Total number of matching stations before the page limit.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of disasters or years to return (1â\x80\x93100). Defaults to 50.'}, 'state': {'type': 'string', 'minLength': 1, 'description': 'Two-letter US postal code (e.g. "CA", "TX", "PR") scoping the query to NCEIâ\x80\x99s 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.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first matching record to return. Defaults to 0.'}, 'endYear': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1980, 'description': 'Latest year to include (1980 or later). NCEI publishes a year only once its assessment settles, so a year past coveredYears.last returns nothing rather than an error. Optional.'}, 'summary': {'type': 'boolean', 'default': False, 'description': 'Return per-year counts and costs by disaster class instead of individual disasters. Defaults to false.'}, 'startYear': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1980, 'description': 'Earliest year to include (1980 or later). A disaster whose span reaches into the range is included even when it began earlier. Optional â\x80\x94 omit for the whole record.'}, 'disasterType': {'enum': ['Drought', 'Flooding', 'Freeze', 'Severe Storm', 'Tropical Cyclone', 'Wildfire', 'Winter Storm'], 'type': 'string', '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.'}, 'minCostInUsd': {'type': 'number', 'minimum': 0, 'description': 'Floor on CPI-adjusted cost in whole US dollars â\x80\x94 1e9 is one billion. In summary mode this is compared against the yearâ\x80\x99s "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.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['mode', 'scope', 'sourceFile', 'declaredCostUnit', 'coveredYears', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit that was applied. Omitted otherwise.'}, 'mode': {'enum': ['events', 'summary'], 'type': 'string', 'description': 'Which shape this response carries: "events" populates disasters, "summary" populates summaries.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['invalid_state_code', 'unknown_state', 'invalid_year_range', 'malformed_export'], 'description': 'Machine-readable failure mode. Declared by this tool: `invalid_state_code`: state was supplied in a form other than a two-letter US postal code. `unknown_state`: The state code is well formed but NCEI publishes no export under it. `invalid_year_range`: startYear is later than endYear, so the range can never match a record. `malformed_export`: The export downloaded but is not the expected table â\x80\x94 no header row, no rows, missing columns, or no declared cost unit. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'scope': {'type': 'string', 'description': '"US" for the national record, or the two-letter state code that was requested.'}, 'shown': {'type': 'number', 'description': 'Records returned on this page. Omitted otherwise.'}, 'notice': {'type': 'string', 'description': 'Guidance when nothing matched or the page ran past the end. Omitted otherwise.'}, 'costBasis': {'type': 'string', 'const': 'national', 'description': 'Present when a state scope is queried in events mode: every cost below is the NATIONAL cost of a disaster that reached the state, not that stateâ\x80\x99s share of it, so adding states together double-counts. Omitted for the national scope and in summary mode.'}, 'disasters': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'disasterType', 'beginDate', 'endDate', 'cpiAdjustedCostInUsd', 'unadjustedCostInUsd', 'deaths'], 'properties': {'name': {'type': 'string', 'description': 'NCEIâ\x80\x99s event name, e.g. "Hurricane Helene (September 2024)".'}, 'deaths': {'type': 'number', 'description': 'Deaths NCEI attributes to the disaster.'}, 'endDate': {'type': 'string', 'description': 'Event end as an ISO calendar date (YYYY-MM-DD).'}, 'beginDate': {'type': 'string', 'description': 'Event start as an ISO calendar date (YYYY-MM-DD).'}, 'disasterType': {'type': 'string', 'description': 'One of NCEIâ\x80\x99s seven disaster classes, e.g. "Tropical Cyclone".'}, 'unadjustedCostInUsd': {'type': 'number', 'description': 'Damage in whole US dollars of the year the disaster occurred.'}, 'cpiAdjustedCostInUsd': {'type': 'number', 'description': 'Damage in whole US dollars, adjusted to present-day prices. This is the figure comparable across years.'}}, 'description': 'A single billion-dollar disaster.', 'additionalProperties': False}, 'description': 'Individual disasters for the requested page. Present when mode is "events".'}, 'exhausted': {'type': 'boolean', 'description': 'True when offset is past the end of a non-empty match set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'summaries': {'type': 'array', 'items': {'type': 'object', 'required': ['year', 'byDisasterType'], 'properties': {'year': {'type': 'number', 'description': 'The calendar year these tallies cover.'}, 'byDisasterType': {'type': 'array', 'items': {'type': 'object', 'required': ['disasterType', 'eventCount'], 'properties': {'costInUsd': {'type': 'number', 'description': 'CPI-adjusted cost in whole US dollars. Omitted for a state scope, where NCEI publishes costRangeInUsd instead of a point estimate.'}, 'eventCount': {'type': 'number', 'description': 'Billion-dollar disasters of this class in the year.'}, 'disasterType': {'type': 'string', 'description': 'One of the seven disaster classes, or "All Disasters" for the yearâ\x80\x99s total.'}, 'costRangeInUsd': {'type': 'object', 'required': ['low', 'high'], 'properties': {'low': {'type': 'number', 'description': 'Bottom of the bin, in whole US dollars.'}, 'high': {'type': 'number', 'description': 'Top of the bin, in whole US dollars.'}}, 'description': 'The cost bin NCEI publishes for a state scope in place of a point estimate. Omitted on the national export.', 'additionalProperties': False}, 'confidenceBoundsInUsd': {'type': 'object', 'required': ['lower75', 'upper75', 'lower90', 'upper90', 'lower95', 'upper95'], 'properties': {'lower75': {'type': 'number', 'description': 'Lower bound of the 75% confidence interval, in whole US dollars.'}, 'lower90': {'type': 'number', 'description': 'Lower bound of the 90% confidence interval, in whole US dollars.'}, 'lower95': {'type': 'number', 'description': 'Lower bound of the 95% confidence interval, in whole US dollars.'}, 'upper75': {'type': 'number', 'description': 'Upper bound of the 75% confidence interval, in whole US dollars.'}, 'upper90': {'type': 'number', 'description': 'Upper bound of the 90% confidence interval, in whole US dollars.'}, 'upper95': {'type': 'number', 'description': 'Upper bound of the 95% confidence interval, in whole US dollars.'}}, 'description': 'NCEIâ\x80\x99s uncertainty bands around costInUsd, in whole US dollars. Published on the national export only; omitted for a state scope, which reports costRangeInUsd instead.', 'additionalProperties': False}}, 'description': 'One disaster classâ\x80\x99s tally within the year.', 'additionalProperties': False}, 'description': 'One entry per class the yearâ\x80\x99s row carries: the seven disaster classes plus the "All Disasters" total, or only the named class when disasterType was set.'}}, 'description': 'One year of the per-year record.', 'additionalProperties': False}, 'description': 'Per-year tallies for the requested page. Present when mode is "summary".'}, 'truncated': {'type': 'boolean', 'description': 'True when more matches exist beyond this page. Omitted otherwise.'}, 'sourceFile': {'type': 'string', 'description': 'The exact NCEI export this response was read from, e.g. "events-US.csv".'}, 'totalCount': {'type': 'number', 'description': 'Records matching every filter across the whole export, before offset and limit.'}, 'coveredYears': {'type': 'object', 'required': ['first', 'last'], 'properties': {'last': {'type': 'number', 'description': 'Latest year present in the export â\x80\x94 the last year NCEI has finished assessing, which trails the current calendar year.'}, 'first': {'type': 'number', 'description': 'Earliest year present in the export.'}}, 'description': 'The year span the export actually holds, read from its rows.', 'additionalProperties': False}, 'declaredCostUnit': {'type': 'string', 'description': 'The cost unit this export declares in its own preamble, e.g. "millions of dollars". Every cost below is already in whole US dollars; this names the unit it was converted from.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['stationId'], 'properties': {'stationId': {'type': 'string', 'minLength': 1, 'description': 'Station ID to fetch (e.g., "GHCND:USW00024233", "COOP:010008"). Obtain from noaa_climate_find_stations.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['id', 'name']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'string', 'description': 'Station ID.'}, 'name': {'type': 'string', 'description': 'Station name.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'service_unavailable', 'rate_limited', 'upstream_auth_failed'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: Station ID format is valid but no station exists with that ID. `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'maxdate': {'type': 'string', 'description': 'Latest date data is available at this station (YYYY-MM-DD). Omitted when not provided.'}, 'mindate': {'type': 'string', 'description': 'Earliest date data is available at this station (YYYY-MM-DD). Omitted when not provided.'}, 'latitude': {'type': 'number', 'description': 'Station latitude in decimal degrees. Omitted when not provided by the API.'}, 'elevation': {'type': 'number', 'description': 'Station elevation. Unit depends on elevationUnit. Omitted when not provided.'}, 'longitude': {'type': 'number', 'description': 'Station longitude in decimal degrees. Omitted when not provided by the API.'}, 'datacoverage': {'type': 'number', 'description': 'Fractional data coverage (0â\x80\x931). Omitted when not provided by the API.'}, 'elevationUnit': {'type': 'string', 'description': 'Unit for elevation (e.g., "Meters"). Omitted when not provided.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of results to return (1â\x80\x931000). Defaults to 25.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first result to return for pagination. Defaults to 0.'}, '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.'}, 'datasetId': {'type': 'string', 'minLength': 1, 'description': 'Filter to categories available in this dataset (e.g., "GHCND", "GSOM"). Optional.'}, 'sortField': {'enum': ['id', 'name'], 'type': 'string', 'description': 'Sort results by this field. Optional.'}, 'sortOrder': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Optional; defaults to asc.'}, '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.'}, 'stationId': {'type': 'string', 'minLength': 1, 'description': 'Filter to categories available at this station ID. Optional.'}, 'locationId': {'type': 'string', 'minLength': 1, 'description': 'Filter to categories available at this location ID. Optional.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['results', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['service_unavailable', 'rate_limited', 'upstream_auth_failed', 'validation_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: A filter parameter is not recognized by the NOAA CDO API (e.g., unknown datasetId). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when no data categories matched â\x80\x94 echoes applied filters and suggests how to broaden.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'description': 'Data category ID (e.g., TEMP, PRCP, WIND).'}, 'name': {'type': 'string', 'description': 'Human-readable category name.'}}, 'description': 'A single data category entry.', 'additionalProperties': False}, 'description': 'Matching data categories.'}, 'metadata': {'type': 'object', 'required': ['resultset'], 'properties': {'resultset': {'type': 'object', 'required': ['count', 'limit', 'offset'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching categories.'}, 'limit': {'type': 'number', 'description': 'Page size used for this response.'}, 'offset': {'type': 'number', 'description': '1-based starting index of this page as returned by the NOAA CDO API.'}}, 'description': 'Pagination cursor fields for this response.', 'additionalProperties': False}}, 'description': 'Pagination metadata. Present when the API returns it.', 'additionalProperties': False}, 'exhausted': {'type': 'boolean', 'description': 'True when the requested offset is past the end of a non-empty result set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'totalCount': {'type': 'number', 'description': 'Total number of matching data categories before the page limit.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of results to return (1â\x80\x931000). Defaults to 25.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first result to return for pagination. Defaults to 0.'}, '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 datasets with data on or before this ISO date (YYYY-MM-DD). Optional.'}, 'sortField': {'enum': ['id', 'name', 'mindate', 'maxdate', 'datacoverage'], 'type': 'string', 'description': 'Sort results by this field. Optional.'}, 'sortOrder': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Optional; defaults to asc.'}, '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 datasets with data on or after this ISO date (YYYY-MM-DD). Optional.'}, 'stationId': {'type': 'string', 'minLength': 1, 'description': 'Filter to datasets covering this station ID (e.g., "GHCND:USW00024233"). Optional.'}, 'datatypeId': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 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.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['results', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['service_unavailable', 'rate_limited', 'upstream_auth_failed', 'validation_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: Bad date format or unrecognized filter ID. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when no datasets matched â\x80\x94 echoes applied filters and suggests how to broaden.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'datacoverage', 'mindate', 'maxdate'], 'properties': {'id': {'type': 'string', 'description': 'Dataset ID (e.g., GHCND, GSOM, GSOY).'}, 'name': {'type': 'string', 'description': 'Human-readable dataset name.'}, 'maxdate': {'type': 'string', 'description': 'Latest date available in the dataset (YYYY-MM-DD).'}, 'mindate': {'type': 'string', 'description': 'Earliest date available in the dataset (YYYY-MM-DD).'}, 'datacoverage': {'type': 'number', 'description': 'Fractional data coverage (0â\x80\x931). Higher is more complete.'}}, 'description': 'A single CDO dataset entry.', 'additionalProperties': False}, 'description': 'Matching datasets.'}, 'metadata': {'type': 'object', 'required': ['resultset'], 'properties': {'resultset': {'type': 'object', 'required': ['count', 'limit', 'offset'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching datasets.'}, 'limit': {'type': 'number', 'description': 'Page size used for this response.'}, 'offset': {'type': 'number', 'description': '1-based starting index of this page as returned by the NOAA CDO API.'}}, 'description': 'Pagination cursor fields for this response.', 'additionalProperties': False}}, 'description': 'Pagination metadata. Present when the API returns it.', 'additionalProperties': False}, 'exhausted': {'type': 'boolean', 'description': 'True when the requested offset is past the end of a non-empty result set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'totalCount': {'type': 'number', 'description': 'Total number of matching datasets before the page limit.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of results to return (1â\x80\x931000). Defaults to 25.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first result to return for pagination. Defaults to 0.'}, '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.'}, 'datasetId': {'type': 'string', 'minLength': 1, 'description': 'Filter to data types available in this dataset (e.g., "GHCND", "GSOM"). Optional.'}, 'sortField': {'enum': ['id', 'name', 'mindate', 'maxdate', 'datacoverage'], 'type': 'string', 'description': 'Sort results by this field. Optional.'}, 'sortOrder': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Optional; defaults to asc.'}, '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.'}, 'stationId': {'type': 'string', 'minLength': 1, 'description': 'Filter to data types available at this station ID. Optional.'}, 'locationId': {'type': 'string', 'minLength': 1, 'description': 'Filter to data types available at this location ID. Optional.'}, 'datacategoryId': {'type': 'string', 'minLength': 1, 'description': 'Filter to data types in this category (e.g., "TEMP" for temperature types, "PRCP" for precipitation). Optional.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['results', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['service_unavailable', 'rate_limited', 'upstream_auth_failed', 'validation_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: A filter parameter is not recognized by the NOAA CDO API (e.g., unknown datacategoryId or datasetId). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when no data types matched â\x80\x94 echoes applied filters and suggests how to broaden.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'description': 'Data type ID (e.g., TMAX, TMIN, PRCP).'}, 'name': {'type': 'string', 'description': 'Human-readable data type name.'}, 'maxdate': {'type': 'string', 'description': 'Latest date this data type is available (YYYY-MM-DD). Omitted when not provided.'}, 'mindate': {'type': 'string', 'description': 'Earliest date this data type is available (YYYY-MM-DD). Omitted when not provided.'}, 'datacoverage': {'type': 'number', 'description': 'Fractional data coverage (0â\x80\x931). Omitted when not provided by the API.'}}, 'description': 'A single data type entry.', 'additionalProperties': False}, 'description': 'Matching data types.'}, 'metadata': {'type': 'object', 'required': ['resultset'], 'properties': {'resultset': {'type': 'object', 'required': ['count', 'limit', 'offset'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching data types.'}, 'limit': {'type': 'number', 'description': 'Page size used for this response.'}, 'offset': {'type': 'number', 'description': '1-based starting index of this page as returned by the NOAA CDO API.'}}, 'description': 'Pagination cursor fields for this response.', 'additionalProperties': False}}, 'description': 'Pagination metadata. Present when the API returns it.', 'additionalProperties': False}, 'exhausted': {'type': 'boolean', 'description': 'True when the requested offset is past the end of a non-empty result set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'totalCount': {'type': 'number', 'description': 'Total number of matching data types before the page limit.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum number of results to return (1â\x80\x931000). Defaults to 25.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first result to return for pagination. Defaults to 0.'}, 'sortField': {'enum': ['id', 'name'], 'type': 'string', 'description': 'Sort results by this field. Optional.'}, 'sortOrder': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort direction. Optional; defaults to asc.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['results', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['service_unavailable', 'rate_limited', 'upstream_auth_failed', 'validation_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `service_unavailable`: NOAA CDO API is unreachable or returning errors. `rate_limited`: NOAA CDO throttled the request â\x80\x94 the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: A pagination or sort parameter is not recognized by the NOAA CDO API. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when no location categories were returned. Omitted otherwise.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'description': 'Location category ID, passed as locationCategoryId to noaa_climate_find_locations (e.g., CITY, ST, HYD_REG).'}, 'name': {'type': 'string', 'description': 'Human-readable category name.'}}, 'description': 'A single location category entry.', 'additionalProperties': False}, 'description': 'Matching location categories.'}, 'metadata': {'type': 'object', 'required': ['resultset'], 'properties': {'resultset': {'type': 'object', 'required': ['count', 'limit', 'offset'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching location categories.'}, 'limit': {'type': 'number', 'description': 'Page size used for this response.'}, 'offset': {'type': 'number', 'description': '1-based starting index of this page as returned by the NOAA CDO API.'}}, 'description': 'Pagination cursor fields for this response.', 'additionalProperties': False}}, 'description': 'Pagination metadata. Present when the API returns it.', 'additionalProperties': False}, 'exhausted': {'type': 'boolean', 'description': 'True when the requested offset is past the end of a non-empty result set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'totalCount': {'type': 'number', 'description': 'Total number of location categories before the page limit.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['year'], 'properties': {'year': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1950, 'description': 'Calendar year to search (1950 through the current partial year). Required â\x80\x94 NCEI publishes one file per year, so an unscoped search would download every year back to 1950.'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of events to return (1â\x80\x93100). Defaults to 50.'}, 'month': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'Filter to events whose begin date falls in this month (1â\x80\x9312). Optional.'}, '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.'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Zero-based index of the first matching event to return. Defaults to 0.'}, '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.'}, 'minDamageInUsd': {'type': 'number', 'minimum': 0, 'description': 'Filter to events whose property damage parses to at least this many dollars. Excludes every row whose damage NCEI did not report â\x80\x94 about a fifth of a recent year â\x80\x94 since an unreported figure cannot be shown to clear the threshold. Optional.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['year', 'sourceFile', 'events', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit that was applied. Omitted otherwise.'}, 'year': {'type': 'number', 'description': 'The calendar year searched.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['year_unavailable', 'service_unavailable', 'malformed_export'], 'description': 'Machine-readable failure mode. Declared by this tool: `year_unavailable`: The NCEI directory listing has no details file for the requested year. `service_unavailable`: The NCEI bulk file server would not hand back a usable file: the directory index is unreachable or carried no details files, the year bundle it names is gone, or the downloaded bundle did not decompress. `malformed_export`: The year decompressed but is not the expected table â\x80\x94 required columns are missing, or the file carried no rows. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Events returned on this page. Omitted otherwise.'}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['eventId', 'eventType', 'state', 'beginDateTime'], 'properties': {'state': {'type': 'string', 'description': 'Full upper-case state or territory name, e.g. "FLORIDA".'}, 'source': {'type': 'string', 'description': 'Who reported the event, e.g. "ASOS", "Trained Spotter". Omitted when absent.'}, 'eventId': {'type': 'string', 'description': 'NCEI EVENT_ID â\x80\x94 unique within the Storm Events corpus.'}, 'timezone': {'type': 'string', 'description': 'Local time zone of the date fields, e.g. "CST-6". Omitted when absent.'}, 'episodeId': {'type': 'string', 'description': 'NCEI EPISODE_ID grouping events from one storm system. Omitted for pre-1996 records, which carry no episode.'}, 'eventType': {'type': 'string', 'description': 'NWS event type label, e.g. "Tornado", "Hail".'}, 'magnitude': {'type': 'number', 'description': 'Wind speed in knots or hail size in inches, depending on the event type â\x80\x94 NCEI populates it only for wind and hail events. Omitted otherwise.'}, 'torFScale': {'type': 'string', 'description': 'Tornado intensity â\x80\x94 Enhanced Fujita ("EF1", or "EFU" when unrated) from 2007 on, original Fujita ("F3") before that. Omitted for non-tornado events.'}, 'floodCause': {'type': 'string', 'description': 'Reported flood cause, e.g. "Heavy Rain". Omitted for non-flood events.'}, 'damageCrops': {'type': 'object', 'required': ['raw'], 'properties': {'raw': {'type': 'string', 'description': 'The upstream cell verbatim, e.g. "0.00K", "1.20M", "1.00B" â\x80\x94 never rewritten.'}, 'amountInUsd': {'type': 'number', 'description': 'Dollar value parsed from raw. Omitted when the cell did not parse (the live files carry a few malformed cells such as a bare "K"); the raw text is still returned.'}}, 'description': 'Crop damage. Omitted when NCEI reported no figure.', 'additionalProperties': False}, 'endDateTime': {'type': 'string', 'description': 'Event end. Omitted when not provided.'}, 'countyOrZone': {'type': 'string', 'description': 'County/parish or NWS forecast zone name. Omitted when not provided.'}, 'deathsDirect': {'type': 'number', 'description': 'Deaths caused directly by the event. Omitted when not reported.'}, 'beginDateTime': {'type': 'string', 'description': 'Event start as NCEI writes it, e.g. "30-APR-24 20:33:00".'}, 'beginLatitude': {'type': 'number', 'description': 'Latitude of the event start in decimal degrees. Omitted when absent.'}, 'magnitudeType': {'type': 'string', 'description': 'How a wind magnitude was determined: "EG" estimated gust, "ES" estimated sustained, "MG" measured gust, "MS" measured sustained. Omitted for non-wind events.'}, 'beginLongitude': {'type': 'number', 'description': 'Longitude of the event start in decimal degrees. Omitted when absent.'}, 'damageProperty': {'type': 'object', 'required': ['raw'], 'properties': {'raw': {'type': 'string', 'description': 'The upstream cell verbatim, e.g. "0.00K", "1.20M", "1.00B" â\x80\x94 never rewritten.'}, 'amountInUsd': {'type': 'number', 'description': 'Dollar value parsed from raw. Omitted when the cell did not parse (the live files carry a few malformed cells such as a bare "K"); the raw text is still returned.'}}, 'description': 'Property damage. Omitted when NCEI reported no figure.', 'additionalProperties': False}, 'deathsIndirect': {'type': 'number', 'description': 'Deaths indirectly attributed to the event. Omitted when not reported.'}, 'eventNarrative': {'type': 'string', 'description': 'Narrative for this individual event. Omitted when absent.'}, 'injuriesDirect': {'type': 'number', 'description': 'Injuries caused directly by the event. Omitted when not reported.'}, 'torWidthInYards': {'type': 'number', 'description': 'Tornado track width in yards. Omitted for non-tornado events.'}, 'countyOrZoneType': {'type': 'string', 'description': 'Whether countyOrZone is a county ("C") or an NWS forecast zone ("Z"). Omitted when not provided.'}, 'episodeNarrative': {'type': 'string', 'description': 'Narrative for the whole storm episode, shared by every event in it. Omitted when absent.'}, 'injuriesIndirect': {'type': 'number', 'description': 'Injuries indirectly attributed to the event. Omitted when not reported.'}, 'torLengthInMiles': {'type': 'number', 'description': 'Tornado track length in miles. Omitted for non-tornado events.'}}, 'description': 'A single storm event.', 'additionalProperties': False}, 'description': 'Matching events for the requested page, in the source fileâ\x80\x99s own row order.'}, 'notice': {'type': 'string', 'description': 'Guidance when nothing matched or the page ran past the end. Omitted otherwise.'}, 'exhausted': {'type': 'boolean', 'description': 'True when offset is past the end of a non-empty match set â\x80\x94 the page is empty but matches exist. Omitted otherwise.'}, 'truncated': {'type': 'boolean', 'description': 'True when more matches exist beyond this page. Omitted otherwise.'}, 'sourceFile': {'type': 'string', 'description': 'The exact NCEI file this page was read from, including its `_c<publishDate>` suffix â\x80\x94 the suffix changes whenever NCEI republishes a year.'}, 'totalCount': {'type': 'number', 'description': 'Events matching every filter across the whole year, before offset and limit.'}, 'scannedRowCount': {'type': 'number', 'description': 'Rows read from the source file, matched or not. Omitted when unavailable.'}, 'excludedUnknownDamage': {'type': 'number', 'description': 'Rows that satisfied every other filter but were dropped by minDamageInUsd because NCEI reported no property-damage figure for them. Omitted when minDamageInUsd was not supplied.'}}, 'additionalProperties': False}