noaa-climate-mcp-server
An MCP server that allows agents to search NOAA CDO stations and datasets, fetch historical weather observations, list data categories and types, find locations and stations, and query storm events and billion-dollar disasters.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://noaa-climate.caseyjhand.com/mcpWhat its tools do
10 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (10)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- List available NOAA CDO datasets with IDs and temporal coverage
- Search weather stations by location, bounding box, or dataset
- Fetch historical observation records for a specific dataset and date range
- Search the NCEI Storm Events Database for tornadoes, floods, and hurricanes
Source and maintenance
Community listingRegistry 0.8.0
- Maintenance checked
Protocol and capabilities
- Server
- noaa-climate-mcp-server 0.8.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 10 advertised
- Resources
- 2 advertised
- Resource templates
- 2 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
10 advertised
noaa_climate_list_datasets — List NOAA Climate Datasets
Advertised read-only
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 (1981–2010 climate normals). Use this first to discover available datasets before calling noaa_climate_fetch_data.
noaa_climate_list_datasets input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"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": "Inclusive upper coverage bound: dataset mindate must be on or before this date. Applied locally before pagination. 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": "Inclusive lower coverage bound: dataset maxdate must be on or after this date. Applied locally to the complete matching catalog before pagination. Optional."
},
"stationId": {
"type": "string",
"pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
"minLength": 1,
"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."
},
"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
}noaa_climate_list_datasets output schema
{
"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 — 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, startDate after endDate, 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": "Station ID normalization, page-limit adjustment, and empty or exhausted-page guidance. Omitted when no guidance applies."
},
"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–1). 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": "Zero-based starting index of this page, echoing the requested offset."
}
},
"description": "Pagination cursor fields for this response.",
"additionalProperties": false
}
},
"description": "Pagination metadata. Synthesized for date-filtered views; otherwise 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 — the page is empty but matches exist. Omitted otherwise."
},
"totalCount": {
"type": "number",
"description": "Total number of matching datasets before the page limit."
}
},
"additionalProperties": false
}noaa_climate_list_datasets annotations
{
"readOnlyHint": true,
"openWorldHint": false
}noaa_climate_list_data_categories — List NOAA Climate Data Categories
Advertised read-only
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.
noaa_climate_list_data_categories input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"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",
"pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
"minLength": 1,
"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."
},
"locationId": {
"type": "string",
"minLength": 1,
"description": "Filter to categories available at this location ID. Optional."
}
},
"additionalProperties": false
}noaa_climate_list_data_categories output schema
{
"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 — the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: startDate is after endDate, or a filter parameter is not recognized by NOAA CDO (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": "Station ID normalization, page-limit adjustment, and empty or exhausted-page guidance. Omitted when no guidance applies."
},
"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": "Zero-based starting index of this page, echoing the requested offset."
}
},
"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 — 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
}noaa_climate_list_data_categories annotations
{
"readOnlyHint": true,
"openWorldHint": false
}noaa_climate_list_data_types — List NOAA Climate Data Types
Advertised read-only
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).
noaa_climate_list_data_types input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"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",
"pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
"minLength": 1,
"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."
},
"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
}noaa_climate_list_data_types output schema
{
"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 — the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: startDate is after endDate, or a filter parameter is not recognized by NOAA CDO (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": "Station ID normalization, page-limit adjustment, and empty or exhausted-page guidance. Omitted when no guidance applies."
},
"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–1). 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": "Zero-based starting index of this page, echoing the requested offset."
}
},
"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 — 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
}noaa_climate_list_data_types annotations
{
"readOnlyHint": true,
"openWorldHint": false
}noaa_climate_list_location_categories — List NOAA Climate Location Categories
Advertised read-only
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.
noaa_climate_list_location_categories input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"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
}noaa_climate_list_location_categories output schema
{
"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 — 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": "Page-limit adjustment and empty or exhausted-page guidance. Omitted when no guidance applies."
},
"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": "Zero-based starting index of this page, echoing the requested offset."
}
},
"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 — the page is empty but matches exist. Omitted otherwise."
},
"totalCount": {
"type": "number",
"description": "Total number of location categories before the page limit."
}
},
"additionalProperties": false
}noaa_climate_list_location_categories annotations
{
"readOnlyHint": true,
"openWorldHint": false
}noaa_climate_find_locations — Find NOAA Climate Locations
Advertised read-onlyOpen-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.
noaa_climate_find_locations input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"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 — 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 — 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."
}
},
"additionalProperties": false
}noaa_climate_find_locations output schema
{
"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 — the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: startDate is after endDate, or a filter parameter is not recognized by NOAA CDO (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": "Page-limit adjustment and empty or exhausted-page guidance. Omitted when no guidance applies."
},
"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–1). 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 — the post-filter match count when appliedNameFilter is present."
},
"limit": {
"type": "number",
"description": "Page size used for this response."
},
"offset": {
"type": "number",
"description": "Zero-based starting index of this page, echoing the requested offset."
}
},
"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 — 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
}noaa_climate_find_locations annotations
{
"readOnlyHint": true,
"openWorldHint": true
}noaa_climate_find_stations — Find NOAA Climate Stations
Advertised read-onlyOpen-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.
noaa_climate_find_stations input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"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."
},
"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
}noaa_climate_find_stations output schema
{
"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 — the configured token went over its rate limit. `upstream_auth_failed`: NOAA CDO rejected the API token this server is configured with. `validation_error`: startDate is after endDate, or a filter parameter is not recognized by NOAA CDO (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": "Page-limit adjustment and empty or exhausted-page guidance. Omitted when no guidance applies."
},
"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–1). 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": "Zero-based starting index of this page, echoing the requested offset."
}
},
"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 — the page is empty but matches exist. Omitted otherwise."
},
"totalCount": {
"type": "number",
"description": "Total number of matching stations before the page limit."
}
},
"additionalProperties": false
}noaa_climate_find_stations annotations
{
"readOnlyHint": true,
"openWorldHint": true
}noaa_climate_get_station — Get NOAA Climate Station
Advertised read-only
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.
noaa_climate_get_station input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"stationId"
],
"properties": {
"stationId": {
"type": "string",
"pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
"minLength": 1,
"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."
}
},
"additionalProperties": false
}noaa_climate_get_station output schema
{
"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 — 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": {}
},
"notice": {
"type": "string",
"description": "Discloses station ID normalization when an alias was supplied."
},
"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–1). Omitted when not provided by the API."
},
"elevationUnit": {
"type": "string",
"description": "Unit for elevation (e.g., \"Meters\"). Omitted when not provided."
}
},
"additionalProperties": false
}noaa_climate_get_station annotations
{
"readOnlyHint": true,
"openWorldHint": false
}noaa_climate_fetch_data — Fetch NOAA Climate Observation Data
Advertised read-onlyOpen-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. For NORMAL_* use the API proxy year 2010. 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.
noaa_climate_fetch_data input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"datasetId",
"startDate",
"endDate"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"units": {
"enum": [
"standard",
"metric"
],
"type": "string",
"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. 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) — 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–2010 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 — 2010 is the API proxy year for all normals."
},
"stationId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\s*(?:[A-Za-z]{2}[A-Za-z0-9]{9}|[^:\\s]+:[^\\s]+)\\s*$",
"minLength": 1,
"description": "Station ID. Trims surrounding whitespace, uppercases IDs, and accepts bare 11-character GHCN aliases (USW00024233 → GHCND:USW00024233). Other namespaced IDs remain accepted."
},
"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 — 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
}noaa_climate_fetch_data output schema
{
"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 — 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, unknown station/location/datatype ID, or encoded observation query exceeding 4000 characters. 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": "Composed guidance for station ID normalization, page-limit adjustments, raw units, missing precipitation, GHCND quality-check failures, and empty or exhausted pages. Omitted when no guidance applies."
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"datatype",
"station"
],
"properties": {
"date": {
"type": "string",
"description": "Observation date-time in ISO 8601 format."
},
"flags": {
"type": "object",
"properties": {
"source": {
"type": "string",
"description": "GHCND source flag, including unknown codes and explicit blanks."
},
"quality": {
"type": "string",
"description": "GHCND quality flag; a nonblank code means a failed quality check. Explicit blanks are preserved."
},
"measurement": {
"type": "string",
"description": "GHCND measurement flag; an explicit blank is preserved."
},
"observationTime": {
"type": "string",
"description": "GHCND local observation time, preserving leading zeros and explicit blanks."
}
},
"description": "Decoded GHCND attributes only. Absent trailing positions remain omitted; raw attributes and numeric values are retained.",
"additionalProperties": false
},
"value": {
"type": "number",
"description": "Observed value, omitted for identified missing precipitation. With units omitted, scale depends on datatype: GHCND TMAX/TMIN tenths °C, PRCP tenths mm, SNOW/SNWD whole mm; GSOM/GSOY temperature/precipitation °C/mm; NORMAL_* temperature normals tenths °F, precipitation normals hundredths inches; HPCP/QPCP hundredths inches. Examples are not universal conversion rules."
},
"missing": {
"type": "boolean",
"const": true,
"description": "True for a documented PRECIP_HLY/HPCP or PRECIP_15/QPCP missing sentinel; value is omitted."
},
"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": "Untouched upstream attributes. GHCND positions are measurement, quality, source, observation time; other datasets have their own layouts documented at https://www.ncei.noaa.gov/pub/data/cdo/documentation/."
}
},
"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": "Zero-based starting index of this page, echoing the requested offset."
}
},
"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 — 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
}noaa_climate_fetch_data annotations
{
"readOnlyHint": true,
"openWorldHint": true
}noaa_climate_search_storm_events — Search NOAA Storm Events
Advertised read-onlyOpen-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"), eventType (exact NWS label such as "Tornado", "Flash Flood", or "Hurricane (Typhoon)", case-insensitive), begin month, inclusive local-calendar startDate/endDate overlap, and minDamageInUsd. 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.
noaa_climate_search_storm_events input schema
{
"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 — NCEI publishes one file per year, so an unscoped search would download every year back to 1950."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum events per page (1–100, default 50). Oversized positive integers are clamped to 100 with a notice; NOAA_CLAMP_LIMITS=false restores rejection above 100."
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Filter to events whose begin date falls in this month (1–12). 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."
},
"endDate": {
"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])))$",
"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."
},
"episodeId": {
"type": "string",
"pattern": "^\\s*(?:\\d+\\s*)?$",
"description": "Exact EPISODE_ID from a returned event. Surrounding whitespace is trimmed; blank means no filter. Leading zeros are significant. Keep year supplied."
},
"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."
},
"startDate": {
"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])))$",
"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."
},
"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 — about a fifth of a recent year — since an unreported figure cannot be shown to clear the threshold. Optional."
}
},
"additionalProperties": false
}noaa_climate_search_storm_events output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"year",
"sourceFile",
"events",
"episodeNarratives",
"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": [
"invalid_date_range",
"year_unavailable",
"service_unavailable",
"malformed_export"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_date_range`: startDate is later than endDate. `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 — 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."
},
"endDate": {
"type": "string",
"description": "Local ISO calendar end date (YYYY-MM-DD). Omitted when source components are missing or invalid; not a UTC conversion."
},
"eventId": {
"type": "string",
"description": "NCEI EVENT_ID — unique within the Storm Events corpus."
},
"timezone": {
"type": "string",
"description": "Local time zone of the date fields, e.g. \"CST-6\". Omitted when absent."
},
"beginDate": {
"type": "string",
"description": "Local ISO calendar start date (YYYY-MM-DD), usable with CDO date filters. Omitted when source components are missing or invalid."
},
"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 — NCEI populates it only for wind and hail events. Omitted otherwise."
},
"torFScale": {
"type": "string",
"description": "Tornado intensity — 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\" — 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\" — 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."
},
"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."
},
"episodeNarrativeRef": {
"type": "string",
"description": "Reference to this page’s episodeNarratives text. Omitted when no narrative was reported."
}
},
"description": "A single storm event.",
"additionalProperties": false
},
"description": "Matching events for the requested page, in the source file’s own row order."
},
"notice": {
"type": "string",
"description": "Clamp disclosure and guidance for truncation, no matches, or exhausted pages. Omitted when none applies."
},
"exhausted": {
"type": "boolean",
"description": "True when offset is past the end of a non-empty match set — 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 — 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."
},
"appliedDateRange": {
"type": "object",
"properties": {
"endDate": {
"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])))$",
"description": "Inclusive upper overlap bound supplied by the caller."
},
"startDate": {
"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])))$",
"description": "Inclusive lower overlap bound supplied by the caller."
}
},
"description": "The applied inclusive local-calendar overlap interval. Omitted when neither bound was supplied; year still selects one export.",
"additionalProperties": false
},
"episodeNarratives": {
"type": "array",
"items": {
"type": "object",
"required": [
"ref",
"text"
],
"properties": {
"ref": {
"type": "string",
"description": "Page-local narrative reference, e.g. n1."
},
"text": {
"type": "string",
"description": "Distinct nonblank episode narrative text, preserved from the service."
}
},
"description": "One distinct episode narrative on this page.",
"additionalProperties": false
},
"description": "Each distinct episode narrative on this page, once; referenced by events[].episodeNarrativeRef."
},
"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
}noaa_climate_search_storm_events annotations
{
"readOnlyHint": true,
"openWorldHint": true
}noaa_climate_get_billion_dollar_disasters — Get NOAA Billion-Dollar Disasters
Advertised read-onlyOpen-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.
noaa_climate_get_billion_dollar_disasters input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 9007199254740991,
"minimum": 1,
"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."
},
"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."
},
"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). The retired archive ends in 2024; years past coveredYears.last return no records 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 — 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 — 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."
}
},
"additionalProperties": false
}noaa_climate_get_billion_dollar_disasters output schema
{
"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": [
"unknown_state",
"invalid_year_range",
"malformed_export"
],
"description": "Machine-readable failure mode. Declared by this tool: `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 — 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": "Archive retirement and preserved CPI-adjustment disclosure, composed with any clamp, empty-page, exhaustion, or truncation guidance."
},
"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’s 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’s 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’s 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 with the CPI adjustment preserved from the archived NCEI export; not rebased to current prices."
}
},
"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 — 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’s 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’s 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’s tally within the year.",
"additionalProperties": false
},
"description": "One entry per class the year’s 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 this archived export. The retired product covers no years after 2024."
},
"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
}noaa_climate_get_billion_dollar_disasters annotations
{
"readOnlyHint": true,
"openWorldHint": true
}Prompts
0 advertised
Resources
2 advertised
NOAA Climate Datasets — NOAA Climate Datasets
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.
NOAA Climate Datasets URI
noaa://datasetsnoaa-climate-guide
Use noaa_climate_* tools for historical climate comparisons, coverage checks, and connecting storm events to station observations. Resolve identifiers across corpora and check missing data, quality flags, baselines, and cost scope before drawing conclusions.
noaa-climate-guide URI
skill://noaa-climate-guide/SKILL.mdNOAA Climate Station — NOAA Climate Station
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.
NOAA Climate Station URI template
noaa://stations/{stationId}io.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 729 ms
- 95th percentile latency
- 729 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 729 ms · metadata changed · 10 tool(s), 2 resource(s), 2 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http noaa-climate-mcp-server-caseyjhand https://noaa-climate.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add noaa-climate-mcp-server-caseyjhand --url https://noaa-climate.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"noaa-climate-mcp-server-caseyjhand": {
"url": "https://noaa-climate.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"noaa-climate-mcp-server-caseyjhand": {
"type": "streamableHttp",
"url": "https://noaa-climate.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"noaa-climate-mcp-server-caseyjhand": {
"type": "http",
"url": "https://noaa-climate.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http noaa-climate-mcp-server-caseyjhand https://noaa-climate.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
https://noaa-climate.caseyjhand.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"noaa-climate-mcp-server-caseyjhand": {
"serverUrl": "https://noaa-climate.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like noaa-climate-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.