earthquake-mcp-server

Previous value: -"Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions from the count, or \"quarry blast\" to count only those. Matched verbatim against the USGS catalog, which accepts any string and returns a count of zero for an unrecognized one. Only available from USGS."New value: +"Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions from the count, or \"quarry blast\" to count only those; a comma-separated list such as \"earthquake,explosion\" counts any of them. USGS matches case-insensitively and counts zero for a value it does not list, which the notice then names. Only available from USGS."

Previous value: -"Magnitude type, e.g. \"mb\" or \"mww\"; both sources. Blank means omitted."New value: +"Magnitude type, e.g. \"mb\" or \"mww\"; both sources. USGS matches case-insensitively; EMSC matches its own lowercase types (\"mb\", \"mw\") case-sensitively and has no \"mww\". Blank means omitted."

Added value: +{
+  "description": "Minimum DYFI (Did You Feel It?) community intensity (1–12): the strongest shaking people reported for the event. An event without DYFI reports never matches. Only available from USGS.",
+  "maximum": 12,
+  "minimum": 1,
+  "type": "number"
+}

Added value: +{
+  "description": "Minimum ShakeMap intensity on the Modified Mercalli scale (1–12): the strongest shaking USGS modeled for the event, e.g. 7 for very strong shaking. Finds shaking a magnitude floor or alert_level misses. An event without a ShakeMap never matches; product_type \"shakemap\" requires one at any intensity. Only available from USGS.",
+  "maximum": 12,
+  "minimum": 1,
+  "type": "number"
+}

Previous value: -"Required product type, e.g. \"moment-tensor\"; USGS only. Blank means omitted."New value: +"Required product type, e.g. \"moment-tensor\" (hyphenated, unlike the moment_tensor detail group); USGS only, matched case-insensitively. Blank means omitted."

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx, serves HTML or an unreadable body, or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."

Added value: +{
+  "description": "On a USGS count of zero, names each supplied event_type, magnitude_type, or product_type value USGS does not list, which matches no events, with the listed value it likely meant. Absent otherwise.",
+  "type": "string"
+}

Added value: +{
+  "description": "Applied minimum DYFI community intensity (CDI); absent for EMSC.",
+  "type": "number"
+}

Added value: +{
+  "description": "Applied minimum ShakeMap intensity (MMI); absent for EMSC.",
+  "type": "number"
+}

Previous value: -"Optional groups: origins (every contributed origin solution, no extra request), magnitudes and arrivals (one shared phase-data download; every arrival of the preferred origin, nearest first), aftershock_forecast (one extra request). Omit for the default response."New value: +"Optional groups: origins (every contributed origin solution, no extra request), magnitudes and arrivals (one shared phase-data download; every arrival of the preferred origin, nearest first), aftershock_forecast (one extra request), pager (fatality and economic-loss brackets with probabilities, and people exposed at each intensity by country; two or three extra requests). Omit for the default response."

Previous value: -[
-  "origins",
-  "magnitudes",
-  "arrivals",
-  "aftershock_forecast"
-]New value: +[
+  "origins",
+  "magnitudes",
+  "arrivals",
+  "aftershock_forecast",
+  "pager"
+]

Previous value: -"PAGER assessment; fatality/economic-loss brackets are in report_url, not this projection. Absent without projected fields."New value: +"PAGER alert and report link. The fatality and economic-loss brackets behind the alert, and population exposure, come from the pager include group of earthquake_get_event. Absent without projected fields."

Previous value: -"Machine-readable failure mode. Declared by this tool: `event_deleted`: USGS reports that the requested event was deleted. `not_found`: No USGS or EMSC event matches the provided event_id. `source_unavailable`: The USGS or EMSC event API returns a 5xx, serves HTML, or is unreachable. `source_timeout`: The USGS or EMSC event API did not answer before the request deadline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `event_deleted`: USGS reports that the requested event was deleted. `not_found`: No USGS or EMSC event matches the provided event_id. `source_unavailable`: The USGS or EMSC event API returns a 5xx, serves HTML or an unreadable body, or is unreachable. `source_timeout`: The USGS or EMSC event API did not answer before the request deadline. Other values are possible when a failure originates below the handler."

Previous value: -"Maximum ShakeMap Modified Mercalli intensity (0–12); null without a ShakeMap or for EMSC."New value: +"Maximum ShakeMap Modified Mercalli intensity (1–12); null without a ShakeMap, when the ShakeMap computed no intensity, or for EMSC."

Previous value: -"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC); such solutions remain unverified and subject to revision."New value: +"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC, or a USGS record without one of these values); such solutions remain unverified and subject to revision."

Added value: +{
+  "additionalProperties": false,
+  "description": "USGS PAGER loss estimates and population exposure; values change with each PAGER update.",
+  "properties": {
+    "economic": {
+      "additionalProperties": false,
+      "description": "Estimated economic losses.",
+      "properties": {
+        "bins": {
+          "description": "Every bracket in upstream order.",
+          "items": {
+            "additionalProperties": false,
+            "description": "One probability bracket.",
+            "properties": {
+              "color": {
+                "description": "Alert color of this bracket. Absent when unpublished.",
+                "type": "string"
+              },
+              "max": {
+                "description": "Upper bound, exclusive, in millions of USD.",
+                "type": "number"
+              },
+              "min": {
+                "description": "Lower bound, inclusive, in millions of USD.",
+                "type": "number"
+              },
+              "probability": {
+                "description": "Probability (0–1) that the outcome falls in this bracket.",
+                "type": "number"
+              }
+            },
+            "required": [
+              "min",
+              "max",
+              "probability"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "level": {
+          "description": "Alert level this estimate sets — \"green\", \"yellow\", \"orange\", or \"red\"; the event alert is the higher of the two estimates. Absent when unpublished.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "bins"
+      ],
+      "type": "object"
+    },
+    "exposure": {
+      "additionalProperties": false,
+      "description": "Estimated population exposed to each shaking intensity.",
+      "properties": {
+        "countries": {
+          "description": "Every country row in published order, all-zero rows included; empty when PAGER lists none.",
+          "items": {
+            "additionalProperties": false,
+            "description": "One country row.",
+            "properties": {
+              "country_code": {
+                "description": "Two-letter country code as PAGER publishes it; \"UK\" marks areas assigned to no country, not the United Kingdom (GB).",
+                "type": "string"
+              },
+              "population": {
+                "description": "Estimated people exposed at each intensity in this country.",
+                "items": {
+                  "type": "number"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "country_code",
+              "population"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "mmi": {
+          "description": "Modified Mercalli intensity of each column, in published order.",
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "population": {
+          "description": "Estimated people exposed at each intensity, all areas combined.",
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "mmi",
+        "population",
+        "countries"
+      ],
+      "type": "object"
+    },
+    "fatality": {
+      "additionalProperties": false,
+      "description": "Estimated shaking-related fatalities.",
+      "properties": {
+        "bins": {
+          "description": "Every bracket in upstream order.",
+          "items": {
+            "additionalProperties": false,
+            "description": "One probability bracket.",
+            "properties": {
+              "color": {
+                "description": "Alert color of this bracket. Absent when unpublished.",
+                "type": "string"
+              },
+              "max": {
+                "description": "Upper bound, exclusive, in deaths.",
+                "type": "number"
+              },
+              "min": {
+                "description": "Lower bound, inclusive, in deaths.",
+                "type": "number"
+              },
+              "probability": {
+                "description": "Probability (0–1) that the outcome falls in this bracket.",
+                "type": "number"
+              }
+            },
+            "required": [
+              "min",
+              "max",
+              "probability"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "level": {
+          "description": "Alert level this estimate sets — \"green\", \"yellow\", \"orange\", or \"red\"; the event alert is the higher of the two estimates. Absent when unpublished.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "bins"
+      ],
+      "type": "object"
+    },
+    "impact": {
+      "description": "PAGER impact statements in published order; absent when none is published.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "fatality",
+    "economic",
+    "exposure"
+  ],
+  "type": "object"
+}

Previous value: -[
-  "origins",
-  "magnitudes",
-  "arrivals",
-  "aftershock_forecast"
-]New value: +[
+  "origins",
+  "magnitudes",
+  "arrivals",
+  "aftershock_forecast",
+  "pager"
+]

Previous value: -"not_published: the event has no product for it. fetch_failed: the product exists but could not be fetched or parsed."New value: +"not_published: the event has no product for it, or its product lacks the files the group reads. fetch_failed: the product exists but could not be fetched or parsed."

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_cursor`: The feed cursor is malformed. `cursor_expired`: The retained generation expired, was evicted, or does not belong to this tenant and feed. `snapshot_too_large`: The feed exceeds retained storage capacity. `feed_unavailable`: USGS feed endpoint returns a 5xx, HTML, or is unreachable. `feed_timeout`: USGS feed endpoint did not answer before the request deadline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_cursor`: The feed cursor is malformed. `cursor_expired`: The retained generation expired, was evicted, or does not belong to this tenant and feed. `snapshot_too_large`: The feed exceeds retained storage capacity. `feed_unavailable`: USGS feed endpoint returns a 5xx, serves HTML or an unreadable body, or is unreachable. `feed_timeout`: USGS feed endpoint did not answer before the request deadline. Other values are possible when a failure originates below the handler."

Previous value: -"Maximum ShakeMap Modified Mercalli intensity (0–12); null without a ShakeMap or for EMSC."New value: +"Maximum ShakeMap Modified Mercalli intensity (1–12); null without a ShakeMap, when the ShakeMap computed no intensity, or for EMSC."

Previous value: -"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC); such solutions remain unverified and subject to revision."New value: +"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC, or a USGS record without one of these values); such solutions remain unverified and subject to revision."

Previous value: -"Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions, or \"quarry blast\" to see only those. Matched verbatim against the USGS catalog, which accepts any string and returns zero matches for an unrecognized one. Only available from USGS."New value: +"Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions, or \"quarry blast\" to see only those; a comma-separated list such as \"earthquake,explosion\" matches any of them. USGS matches case-insensitively and returns zero matches for a value it does not list, which the notice then names. Only available from USGS."

Previous value: -"Magnitude type, e.g. \"mb\" or \"mww\"; both sources. Blank means omitted."New value: +"Magnitude type, e.g. \"mb\" or \"mww\"; both sources. USGS matches case-insensitively; EMSC matches its own lowercase types (\"mb\", \"mw\") case-sensitively and has no \"mww\". Blank means omitted."

Added value: +{
+  "description": "Minimum DYFI (Did You Feel It?) community intensity (1–12): the strongest shaking people reported for the event. An event without DYFI reports never matches. Only available from USGS.",
+  "maximum": 12,
+  "minimum": 1,
+  "type": "number"
+}

Added value: +{
+  "description": "Minimum ShakeMap intensity on the Modified Mercalli scale (1–12): the strongest shaking USGS modeled for the event, e.g. 7 for very strong shaking. Finds shaking a magnitude floor or alert_level misses. An event without a ShakeMap never matches; product_type \"shakemap\" requires one at any intensity. Only available from USGS.",
+  "maximum": 12,
+  "minimum": 1,
+  "type": "number"
+}

Previous value: -"Required product type, e.g. \"moment-tensor\"; USGS only. Blank means omitted."New value: +"Required product type, e.g. \"moment-tensor\" (hyphenated, unlike the moment_tensor detail group); USGS only, matched case-insensitively. Blank means omitted."

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx, serves HTML or an unreadable body, or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."

Previous value: -"Maximum ShakeMap Modified Mercalli intensity (0–12); null without a ShakeMap or for EMSC."New value: +"Maximum ShakeMap Modified Mercalli intensity (1–12); null without a ShakeMap, when the ShakeMap computed no intensity, or for EMSC."

Previous value: -"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC); such solutions remain unverified and subject to revision."New value: +"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC, or a USGS record without one of these values); such solutions remain unverified and subject to revision."

Previous value: -"Guidance when limit was clamped to 1,000 (requested and applied values), when results are empty (how to broaden filters), or when more pages remain (the next offset). Absent when none applies."New value: +"Guidance when limit was clamped to 1,000 (requested and applied values), when results are empty (how to broaden filters, or on USGS each supplied event_type, magnitude_type, or product_type value USGS does not list, with the listed value it likely meant), or when more pages remain (the next offset). Absent when none applies."

Added value: +{
+  "description": "Applied minimum DYFI community intensity (CDI); absent for EMSC.",
+  "type": "number"
+}

Added value: +{
+  "description": "Applied minimum ShakeMap intensity (MMI); absent for EMSC.",
+  "type": "number"
+}

Previous value: -"USGS event ID, e.g. \"hv74966427\" or \"us6000sznj\". Found in the \"id\" field of earthquake_get_feed and earthquake_search_events results."New value: +"USGS event ID, e.g. \"hv74966427\" or \"us6000sznj\", or EMSC event ID, e.g. \"20190706_0000043\". Found in the \"id\" field of earthquake_get_feed and earthquake_search_events results."

Added value: +{
+  "description": "Optional groups: origins (every contributed origin solution, no extra request), magnitudes and arrivals (one shared phase-data download; every arrival of the preferred origin, nearest first), aftershock_forecast (one extra request). Omit for the default response.",
+  "items": {
+    "enum": [
+      "origins",
+      "magnitudes",
+      "arrivals",
+      "aftershock_forecast"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "USGS Operational Aftershock Forecast; probabilities change with each update.",
+  "properties": {
+    "advisory_window": {
+      "description": "Window USGS headlines in its advisory, e.g. \"1 Week\".",
+      "type": "string"
+    },
+    "created": {
+      "description": "ISO 8601 UTC time the forecast was issued.",
+      "type": "string"
+    },
+    "expires": {
+      "description": "ISO 8601 UTC expiry of the forecast.",
+      "type": "string"
+    },
+    "next_update": {
+      "description": "ISO 8601 UTC time of the next scheduled update; absent once updates stop.",
+      "type": "string"
+    },
+    "windows": {
+      "description": "Forecast windows in upstream order.",
+      "items": {
+        "additionalProperties": false,
+        "description": "One forecast window.",
+        "properties": {
+          "above_mainshock": {
+            "additionalProperties": false,
+            "description": "Chance of an aftershock as large as the mainshock; absent when unpublished.",
+            "properties": {
+              "magnitude": {
+                "description": "Mainshock magnitude.",
+                "type": "number"
+              },
+              "probability": {
+                "description": "Probability (0–1) of an aftershock at or above the mainshock magnitude.",
+                "type": "number"
+              }
+            },
+            "required": [
+              "magnitude",
+              "probability"
+            ],
+            "type": "object"
+          },
+          "bins": {
+            "description": "Magnitude bins in upstream order.",
+            "items": {
+              "additionalProperties": false,
+              "description": "One magnitude bin.",
+              "properties": {
+                "count_median": {
+                  "description": "Median expected count.",
+                  "type": "number"
+                },
+                "count_p95_max": {
+                  "description": "Upper bound of the 95% count range.",
+                  "type": "number"
+                },
+                "count_p95_min": {
+                  "description": "Lower bound of the 95% count range.",
+                  "type": "number"
+                },
+                "magnitude": {
+                  "description": "Minimum magnitude of this bin.",
+                  "type": "number"
+                },
+                "probability": {
+                  "description": "Probability (0–1) of at least one aftershock at or above it.",
+                  "type": "number"
+                }
+              },
+              "required": [
+                "magnitude",
+                "probability"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "end": {
+            "description": "ISO 8601 UTC window end.",
+            "type": "string"
+          },
+          "label": {
+            "description": "Window label, e.g. \"1 Day\", \"1 Week\".",
+            "type": "string"
+          },
+          "start": {
+            "description": "ISO 8601 UTC window start (the forecast issue time, not now).",
+            "type": "string"
+          }
+        },
+        "required": [
+          "label",
+          "start",
+          "end",
+          "bins"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "advisory_window",
+    "created",
+    "expires",
+    "windows"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "All phase arrivals of the preferred origin, sorted by distance ascending.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One phase arrival joined to its pick.",
+    "properties": {
+      "azimuth_deg": {
+        "description": "Azimuth from epicenter to station, degrees.",
+        "type": "number"
+      },
+      "channel": {
+        "description": "SEED channel code.",
+        "type": "string"
+      },
+      "distance_deg": {
+        "description": "Epicentral distance, degrees.",
+        "type": "number"
+      },
+      "location": {
+        "description": "SEED location code as published; \"\" and \"--\" both mean blank.",
+        "type": "string"
+      },
+      "network": {
+        "description": "SEED network code.",
+        "type": "string"
+      },
+      "phase": {
+        "description": "Phase name, e.g. P, Pn, S.",
+        "type": "string"
+      },
+      "station": {
+        "description": "SEED station code.",
+        "type": "string"
+      },
+      "time": {
+        "description": "ISO 8601 UTC pick time.",
+        "type": "string"
+      },
+      "time_residual_s": {
+        "description": "Travel-time residual, seconds.",
+        "type": "number"
+      },
+      "time_weight": {
+        "description": "Weight of the arrival time in the location.",
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "How the depth was set, as published, e.g. \"from location\" or \"operator assigned\" (fixed, not solved for).",
+  "type": "string"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `event_deleted`: USGS reports that the requested event was deleted. `not_found`: No event matches the provided event_id. `source_unavailable`: The USGS event API returns a 5xx, serves HTML, or is unreachable. `source_timeout`: The USGS event API did not answer before the request deadline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `event_deleted`: USGS reports that the requested event was deleted. `not_found`: No USGS or EMSC event matches the provided event_id. `source_unavailable`: The USGS or EMSC event API returns a 5xx, serves HTML, or is unreachable. `source_timeout`: The USGS or EMSC event API did not answer before the request deadline. Other values are possible when a failure originates below the handler."

Added value: +{
+  "description": "Other network IDs USGS lists for this event, in upstream order; earthquake_get_event accepts them. Absent when USGS lists none, and for EMSC events.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Magnitude solutions from the preferred phase-data product, in document order.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One event-level magnitude solution.",
+    "properties": {
+      "agency": {
+        "description": "Agency that computed the magnitude.",
+        "type": "string"
+      },
+      "evaluation_mode": {
+        "description": "QuakeML evaluation mode: manual or automatic.",
+        "type": "string"
+      },
+      "evaluation_status": {
+        "description": "QuakeML evaluation status, e.g. reviewed.",
+        "type": "string"
+      },
+      "is_preferred": {
+        "description": "True for the document's preferred magnitude.",
+        "type": "boolean"
+      },
+      "station_count": {
+        "description": "Stations contributing to this magnitude.",
+        "type": "number"
+      },
+      "type": {
+        "description": "Magnitude type, e.g. Mww, mb, Ml.",
+        "type": "string"
+      },
+      "value": {
+        "description": "Magnitude value.",
+        "type": "number"
+      }
+    },
+    "required": [
+      "is_preferred"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Every origin product, preferred first. Present when requested and published.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One origin solution from an origin product.",
+    "properties": {
+      "azimuthal_gap_deg": {
+        "description": "Largest azimuthal gap, degrees.",
+        "type": "number"
+      },
+      "depth_error_km": {
+        "description": "Depth uncertainty, km.",
+        "type": "number"
+      },
+      "depth_km": {
+        "description": "Hypocenter depth, km.",
+        "type": "number"
+      },
+      "depth_type": {
+        "description": "How the depth was set, as published, e.g. \"from location\" or \"operator assigned\".",
+        "type": "string"
+      },
+      "evaluation_status": {
+        "description": "QuakeML evaluation status, e.g. final.",
+        "type": "string"
+      },
+      "event_id": {
+        "description": "Contributing network's ID for the event.",
+        "type": "string"
+      },
+      "horizontal_error_km": {
+        "description": "Horizontal location uncertainty, km.",
+        "type": "number"
+      },
+      "is_preferred": {
+        "description": "True for the origin USGS prefers (listed first).",
+        "type": "boolean"
+      },
+      "latitude": {
+        "description": "Epicenter latitude, decimal degrees.",
+        "type": "number"
+      },
+      "longitude": {
+        "description": "Epicenter longitude, decimal degrees.",
+        "type": "number"
+      },
+      "magnitude": {
+        "description": "Magnitude published with this origin.",
+        "type": "number"
+      },
+      "magnitude_type": {
+        "description": "Magnitude type, e.g. mww, mb, Mi.",
+        "type": "string"
+      },
+      "minimum_distance_deg": {
+        "description": "Distance to the nearest station, degrees.",
+        "type": "number"
+      },
+      "num_phases_used": {
+        "description": "Phases used in the location.",
+        "type": "number"
+      },
+      "num_stations_used": {
+        "description": "Stations used in the location.",
+        "type": "number"
+      },
+      "review_status": {
+        "description": "Review status as published by the network.",
+        "type": "string"
+      },
+      "source": {
+        "description": "Network that contributed this origin product.",
+        "type": "string"
+      },
+      "standard_error_s": {
+        "description": "RMS travel-time residual, seconds.",
+        "type": "number"
+      },
+      "time": {
+        "description": "ISO 8601 UTC origin time.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "is_preferred"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Requested groups not returned, with the reason. Absent when all were returned.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One requested group that was not returned.",
+    "properties": {
+      "group": {
+        "description": "The requested group.",
+        "enum": [
+          "origins",
+          "magnitudes",
+          "arrivals",
+          "aftershock_forecast"
+        ],
+        "type": "string"
+      },
+      "reason": {
+        "description": "not_published: the event has no product for it. fetch_failed: the product exists but could not be fetched or parsed.",
+        "enum": [
+          "not_published",
+          "fetch_failed"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "group",
+      "reason"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Maximum events to return in this call. Default 100, max 1000. Applies to the first page; later pages carry the page size inside the cursor, so set it on the first call rather than changing it mid-sequence."New value: +"Events to return per page. Default 15; a larger value returns at most 1,000 and says so. Applies to the first page; later pages carry the page size inside the cursor and ignore limit, so set it on the first call."

Removed value: -1000

Added value: +1

Previous value: -"integer"New value: +"number"

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_cursor`: The feed cursor is malformed. `cursor_expired`: The retained generation expired, was evicted, or does not belong to this tenant and feed. `snapshot_too_large`: The feed exceeds retained storage capacity. `result_too_large`: One event or page metadata cannot fit the response budget. `feed_unavailable`: USGS feed endpoint returns a 5xx, HTML, or is unreachable. `feed_timeout`: USGS feed endpoint did not answer before the request deadline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_cursor`: The feed cursor is malformed. `cursor_expired`: The retained generation expired, was evicted, or does not belong to this tenant and feed. `snapshot_too_large`: The feed exceeds retained storage capacity. `feed_unavailable`: USGS feed endpoint returns a 5xx, HTML, or is unreachable. `feed_timeout`: USGS feed endpoint did not answer before the request deadline. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "invalid_cursor",
-  "cursor_expired",
-  "snapshot_too_large",
-  "result_too_large",
-  "feed_unavailable",
-  "feed_timeout"
-]New value: +[
+  "invalid_cursor",
+  "cursor_expired",
+  "snapshot_too_large",
+  "feed_unavailable",
+  "feed_timeout"
+]

Added value: +{
+  "description": "Other network IDs USGS lists for this event, in upstream order; earthquake_get_event accepts them. Absent when USGS lists none, and for EMSC events.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Recovery guidance when the feed contains no events, or how to continue when a page was capped — narrowing the magnitude tier, widening the time window, paging with the cursor, or using earthquake_search_events for filtered queries. Absent when a single page covers the whole feed."New value: +"Guidance when a first-page limit was clamped to 1,000 (requested and applied values), when the feed or cursor position holds no events (a wider window, lower tier, or earthquake_search_events), or when more pages remain (paging with the cursor). Absent when none applies."

Previous value: -"Maximum events to return per call. Default 100. Accepts up to 20000; fetches at most 100 candidates and returns a byte-bounded page. Combine with offset to retrieve match sets larger than one call can return."New value: +"Events to return per call. Default 15; a larger value returns at most 1,000 and says so. Combine with offset to retrieve match sets larger than one call can return."

Removed value: -20000

Added value: +1

Previous value: -"integer"New value: +"number"

Previous value: -"USGS includes PAGER, DYFI and ShakeMap; EMSC (European-Mediterranean Seismological Centre) is an independent global catalog, with densest station coverage around Europe/Mediterranean and no such impact products. Event-detail tool accepts USGS IDs only."New value: +"USGS includes PAGER, DYFI and ShakeMap; EMSC (European-Mediterranean Seismological Centre) is an independent global catalog, with densest station coverage around Europe/Mediterranean and no such impact products. earthquake_get_event accepts IDs from either source."

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `result_too_large`: One event or page metadata cannot fit the response budget. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "invalid_range",
-  "result_too_large",
-  "invalid_radius",
-  "invalid_bounding_box",
-  "source_unavailable",
-  "source_timeout",
-  "upstream_rejected",
-  "upstream_rejected_no_reason"
-]New value: +[
+  "invalid_range",
+  "invalid_radius",
+  "invalid_bounding_box",
+  "source_unavailable",
+  "source_timeout",
+  "upstream_rejected",
+  "upstream_rejected_no_reason"
+]

Added value: +{
+  "description": "Other network IDs USGS lists for this event, in upstream order; earthquake_get_event accepts them. Absent when USGS lists none, and for EMSC events.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Recovery guidance when results are empty or capped — how to broaden filters or get the full count. Absent when the result set is non-empty and within the limit."New value: +"Guidance when limit was clamped to 1,000 (requested and applied values), when results are empty (how to broaden filters), or when more pages remain (the next offset). Absent when none applies."

Previous value: -"Effective result limit sent upstream."New value: +"Applied result limit sent upstream, after any clamp."

Previous value: -"Page capped by limit, candidates or bytes. Continue with nextOffset. Without totalCount, more events may remain but are not confirmed."New value: +"Page filled the applied limit and more matches remain or may remain. Continue with nextOffset. Without totalCount, more events may remain but are not confirmed."

Added value: +{
+  "description": "Magnitude type, e.g. \"mb\" or \"mww\"; both sources. Blank means omitted.",
+  "type": "string"
+}

Added value: +{
+  "description": "Required product type, e.g. \"moment-tensor\"; USGS only. Blank means omitted.",
+  "type": "string"
+}

Added value: +{
+  "description": "USGS review status: automatic or reviewed. Blank means omitted; unsupported by EMSC.",
+  "type": "string"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "invalid_radius",
-  "invalid_bounding_box",
-  "source_unavailable",
-  "source_timeout",
-  "upstream_rejected",
-  "upstream_rejected_no_reason"
-]New value: +[
+  "invalid_range",
+  "invalid_radius",
+  "invalid_bounding_box",
+  "source_unavailable",
+  "source_timeout",
+  "upstream_rejected",
+  "upstream_rejected_no_reason"
+]

Previous value: -"True when count exceeds 20000 — a full earthquake_search_events would be truncated. For EMSC, evaluated against the known 20000 limit since max_allowed is not returned. Narrow filters to retrieve all matching events."New value: +"Count exceeds the single-request threshold (20000 for EMSC despite null max_allowed). Use search offset paging or narrower filters."

Previous value: -"Maximum events the API would return for a full fetch. 20000 for USGS. Null for EMSC — the EMSC count endpoint does not return this field."New value: +"Upstream single-request threshold: 20000 for USGS; null because EMSC count omits it. Offset paging can retrieve larger sets."

Previous value: -"PAGER alert filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied minimum PAGER alert; absent for EMSC."

Previous value: -"Effective query end time. Absent when omitted from input — the upstream defaults to the current time."New value: +"Applied end time; absent means upstream current-time default."

Previous value: -"Event-type filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied event type; absent for EMSC."

Previous value: -"Radius-search latitude sent upstream."New value: +"Circle latitude, degrees."

Previous value: -"Radius-search longitude sent upstream."New value: +"Circle longitude, degrees."

Added value: +{
+  "description": "Applied magnitude type.",
+  "type": "string"
+}

Previous value: -"Maximum depth filter sent upstream."New value: +"Applied maximum depth, km."

Previous value: -"Maximum magnitude filter sent upstream."New value: +"Applied maximum magnitude."

Previous value: -"Minimum depth filter sent upstream."New value: +"Applied minimum depth, km."

Previous value: -"DYFI felt-report filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied minimum DYFI response count; absent for EMSC."

Previous value: -"Minimum magnitude filter sent upstream."New value: +"Applied minimum magnitude."

Previous value: -"Significance filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied minimum significance; absent for EMSC."

Added value: +{
+  "description": "Applied required product; USGS only.",
+  "type": "string"
+}

Added value: +{
+  "description": "Applied review status; USGS only.",
+  "enum": [
+    "automatic",
+    "reviewed"
+  ],
+  "type": "string"
+}

Previous value: -"Effective query start time sent upstream — server-resolved to a 30-day window when omitted from input."New value: +"Applied start time; defaults to 30 days before end/now."

Added value: +1

Previous value: -"Analysis products USGS attached to this event. Absent when the event carries none — that means no product was produced, not that impact was zero."New value: +"Projected USGS analysis products. Absent when no projected field is available; absence does not mean impact was zero."

Previous value: -"Felt-report summary. Absent when no DYFI product exists for the event."New value: +"Felt-report summary. Absent without projected fields."

Previous value: -"Number of \"Did You Feel It?\" reports the public submitted."New value: +"Public DYFI (Did You Feel It?) report count."

Previous value: -"Finite-fault rupture model. Produced only for large events."New value: +"Finite-fault rupture model for large events; absent without projected fields."

Previous value: -"Secondary-hazard alert levels. Absent when no ground-failure model was run."New value: +"Secondary-hazard alert levels. Absent without projected fields."

Previous value: -"PAGER impact assessment. Estimated fatality and economic-loss brackets live in a separate content file and are not part of this response — fetch report_url for them."New value: +"PAGER assessment; fatality/economic-loss brackets are in report_url, not this projection. Absent without projected fields."

Previous value: -"Focal-mechanism solution. Absent for events with no moment-tensor inversion."New value: +"Focal mechanism; absent without projected fields."

Previous value: -"Centroid depth in kilometers derived from the moment-tensor inversion."New value: +"Moment-tensor centroid depth, km."

Previous value: -"First nodal plane of the focal mechanism. Either plane can be the true fault."New value: +"First nodal plane; either plane may be the fault."

Previous value: -"Slip direction in degrees (-180 to 180). Near 90 is reverse faulting, near -90 normal, near 0 or 180 strike-slip."New value: +"Slip direction, degrees (-180..180): ~90 reverse, ~-90 normal, ~0/180 strike-slip."

Previous value: -"Second nodal plane — the auxiliary solution, indistinguishable from the first on seismic data alone."New value: +"Auxiliary nodal plane; seismic data alone cannot distinguish the true fault."

Previous value: -"Slip direction in degrees (-180 to 180). Near 90 is reverse faulting, near -90 normal, near 0 or 180 strike-slip."New value: +"Slip direction, degrees (-180..180): ~90 reverse, ~-90 normal, ~0/180 strike-slip."

Previous value: -"Scalar seismic moment in newton-metres — the physical size of the rupture."New value: +"Scalar seismic moment, newton-metres."

Previous value: -"Location-quality metrics for the preferred origin."New value: +"Location-quality metrics for the preferred origin; absent without projected fields."

Previous value: -"Largest azimuthal gap between stations, in degrees. Gaps above ~180 make the location poorly constrained."New value: +"Largest station azimuthal gap, degrees; >~180 means poorly constrained location."

Previous value: -"Review state of the origin solution as the contributing network published it."New value: +"Origin review state published by its network."

Previous value: -"ShakeMap modeled ground-motion summary. Absent when no ShakeMap was produced."New value: +"ShakeMap modeled ground-motion summary. Absent without projected fields."

Added value: +{
+  "description": "ShakeMap producer code version reported by USGS.",
+  "type": "string"
+}

Previous value: -"Maximum modeled peak ground acceleration, in g — a fraction of standard gravity, as USGS ShakeMap publishes it (0.4 is four tenths of g)."New value: +"Maximum modeled peak ground acceleration, in g (fraction of standard gravity)."

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: No event matches the provided event_id. `source_unavailable`: The USGS event API returns a 5xx, serves HTML, or is unreachable. `source_timeout`: The USGS event API did not answer before the request deadline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `event_deleted`: USGS reports that the requested event was deleted. `not_found`: No event matches the provided event_id. `source_unavailable`: The USGS event API returns a 5xx, serves HTML, or is unreachable. `source_timeout`: The USGS event API did not answer before the request deadline. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "not_found",
-  "source_unavailable",
-  "source_timeout"
-]New value: +[
+  "event_deleted",
+  "not_found",
+  "source_unavailable",
+  "source_timeout"
+]

Previous value: -"PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field."New value: +"PAGER estimated impact; null without an assessment or for EMSC."

Previous value: -"Code of the agency or network the source names as authoritative for this solution, e.g. \"NEIC\", \"BMKG\", \"NDI\" from EMSC or \"us\", \"ci\", \"ak\" from USGS. Absent when the source reports none."New value: +"Authoritative agency/network code (EMSC auth or USGS net); absent if unpublished."

Previous value: -"Maximum reported intensity (Community Decimal Intensity, 0–12 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field."New value: +"Maximum DYFI Community Decimal Intensity (0–12); null if uncomputed or unsupported (EMSC)."

Previous value: -"Hypocenter depth in kilometers. Shallow (<70 km), intermediate (70–300 km), or deep (>300 km). Null for historical events where depth was not measured."New value: +"Hypocenter depth in km; null if unmeasured."

Previous value: -"How certain the source is of event_type: \"known\" (asserted), \"suspected\", \"unknown\", or \"unreported\". EMSC publishes this as the first character of its event-type code — a suspected explosion is not a confirmed one, and this is the only field that says so. Absent for USGS, which publishes no certainty axis, and absent for an EMSC code outside the published nomenclature."New value: +"EMSC classification certainty: known (asserted), suspected, unknown, or unreported. Suspected is not confirmed. Absent for USGS and unrecognized EMSC codes."

Previous value: -"What kind of event this is, in one vocabulary whichever source served it — the QuakeML type names USGS publishes (\"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\"). EMSC's two-character code is decoded to the same names, so the same event carries the same value from either source; how sure the source is rides on event_certainty instead. A code outside the published nomenclature is forwarded verbatim rather than guessed at. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."New value: +"QuakeML classification (earthquake, quarry blast, explosion, etc.). EMSC codes decode to USGS names; unknown codes pass through verbatim. Certainty is separate. Absent if unpublished; either catalog includes non-tectonic events."

Previous value: -"Number of DYFI (Did You Feel It?) responses. Null when USGS has received no reports for the event, and always null for EMSC, which publishes no DYFI field — a null is not evidence the event went unfelt."New value: +"DYFI (Did You Feel It?) response count; null if no USGS reports or source has no DYFI (EMSC). Null does not mean unfelt."

Previous value: -"Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as \"M ?\")."New value: +"Preferred magnitude; null if not computed (title: \"M ?\")."

Previous value: -"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field."New value: +"Maximum ShakeMap Modified Mercalli intensity (0–12); null without a ShakeMap or for EMSC."

Previous value: -"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field."New value: +"USGS significance (0–2000+), combining magnitude, felt reports and PAGER; null if uncomputed or for EMSC."

Previous value: -"Upstream catalog this solution came from, e.g. \"EMSC-RTS\" (EMSC real-time seismicity, revised as analysis continues). Absent for USGS, which publishes no catalog identifier on event records."New value: +"Solution catalog, e.g. EMSC-RTS (real-time, subject to revision). Absent for USGS."

Previous value: -"Human-review state: \"automatic\" (posted by automatic processing, not yet verified by a person), \"reviewed\" (examined by an analyst), or \"deleted\". Null when the source publishes no review status — EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final."New value: +"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC); such solutions remain unverified and subject to revision."

Previous value: -"Human-readable event summary, e.g. \"M 6.0 - 13 km S of Honaunau-Napoopoo, Hawaii\"."New value: +"Event summary, e.g. \"M 6.0 - Hawaii\"."

Previous value: -"USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning — USGS states the flag does not indicate whether a tsunami did or will exist; check NOAA (tsunami.gov) for actual alert status. Null when the source publishes no such flag, as EMSC does not."New value: +"USGS tsunami flag: 1 for large oceanic events, 0 otherwise; null if unpublished (EMSC). Not a warning or evidence of a tsunami; check NOAA tsunami.gov for alerts."

Previous value: -"PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field."New value: +"PAGER estimated impact; null without an assessment or for EMSC."

Previous value: -"Code of the agency or network the source names as authoritative for this solution, e.g. \"NEIC\", \"BMKG\", \"NDI\" from EMSC or \"us\", \"ci\", \"ak\" from USGS. Absent when the source reports none."New value: +"Authoritative agency/network code (EMSC auth or USGS net); absent if unpublished."

Previous value: -"Maximum reported intensity (Community Decimal Intensity, 0–12 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field."New value: +"Maximum DYFI Community Decimal Intensity (0–12); null if uncomputed or unsupported (EMSC)."

Previous value: -"Hypocenter depth in kilometers. Shallow (<70 km), intermediate (70–300 km), or deep (>300 km). Null for historical events where depth was not measured."New value: +"Hypocenter depth in km; null if unmeasured."

Previous value: -"How certain the source is of event_type: \"known\" (asserted), \"suspected\", \"unknown\", or \"unreported\". EMSC publishes this as the first character of its event-type code — a suspected explosion is not a confirmed one, and this is the only field that says so. Absent for USGS, which publishes no certainty axis, and absent for an EMSC code outside the published nomenclature."New value: +"EMSC classification certainty: known (asserted), suspected, unknown, or unreported. Suspected is not confirmed. Absent for USGS and unrecognized EMSC codes."

Previous value: -"What kind of event this is, in one vocabulary whichever source served it — the QuakeML type names USGS publishes (\"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\"). EMSC's two-character code is decoded to the same names, so the same event carries the same value from either source; how sure the source is rides on event_certainty instead. A code outside the published nomenclature is forwarded verbatim rather than guessed at. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."New value: +"QuakeML classification (earthquake, quarry blast, explosion, etc.). EMSC codes decode to USGS names; unknown codes pass through verbatim. Certainty is separate. Absent if unpublished; either catalog includes non-tectonic events."

Previous value: -"Number of DYFI (Did You Feel It?) responses. Null when USGS has received no reports for the event, and always null for EMSC, which publishes no DYFI field — a null is not evidence the event went unfelt."New value: +"DYFI (Did You Feel It?) response count; null if no USGS reports or source has no DYFI (EMSC). Null does not mean unfelt."

Previous value: -"Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as \"M ?\")."New value: +"Preferred magnitude; null if not computed (title: \"M ?\")."

Previous value: -"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field."New value: +"Maximum ShakeMap Modified Mercalli intensity (0–12); null without a ShakeMap or for EMSC."

Previous value: -"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field."New value: +"USGS significance (0–2000+), combining magnitude, felt reports and PAGER; null if uncomputed or for EMSC."

Previous value: -"Upstream catalog this solution came from, e.g. \"EMSC-RTS\" (EMSC real-time seismicity, revised as analysis continues). Absent for USGS, which publishes no catalog identifier on event records."New value: +"Solution catalog, e.g. EMSC-RTS (real-time, subject to revision). Absent for USGS."

Previous value: -"Human-review state: \"automatic\" (posted by automatic processing, not yet verified by a person), \"reviewed\" (examined by an analyst), or \"deleted\". Null when the source publishes no review status — EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final."New value: +"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC); such solutions remain unverified and subject to revision."

Previous value: -"Human-readable event summary, e.g. \"M 6.0 - 13 km S of Honaunau-Napoopoo, Hawaii\"."New value: +"Event summary, e.g. \"M 6.0 - Hawaii\"."

Previous value: -"USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning — USGS states the flag does not indicate whether a tsunami did or will exist; check NOAA (tsunami.gov) for actual alert status. Null when the source publishes no such flag, as EMSC does not."New value: +"USGS tsunami flag: 1 for large oceanic events, 0 otherwise; null if unpublished (EMSC). Not a warning or evidence of a tsunami; check NOAA tsunami.gov for alerts."

Added value: +{
+  "description": "Magnitude type, e.g. \"mb\" or \"mww\"; both sources. Blank means omitted.",
+  "type": "string"
+}

Added value: +{
+  "description": "Required product type, e.g. \"moment-tensor\"; USGS only. Blank means omitted.",
+  "type": "string"
+}

Added value: +{
+  "description": "USGS review status: automatic or reviewed. Blank means omitted; unsupported by EMSC.",
+  "type": "string"
+}

Previous value: -"Data source. Both catalogs are global. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" is an independent global catalog operated by the European-Mediterranean Seismological Centre — use it to cross-check any event, anywhere, against a separate network. It publishes no PAGER, DYFI, or ShakeMap metadata and no per-event detail endpoint; its station coverage is densest around Europe and the Mediterranean."New value: +"USGS includes PAGER, DYFI and ShakeMap; EMSC (European-Mediterranean Seismological Centre) is an independent global catalog, with densest station coverage around Europe/Mediterranean and no such impact products. Event-detail tool accepts USGS IDs only."

Previous value: -"True when the follow-up total-count query failed, so the total is unknown for this call rather than never requested. The returned events are complete and unaffected; only totalCount is missing. Retry earthquake_count_events with the same filters to recover the total. Absent whenever the count succeeded or was never needed."New value: +"True if the count lookup failed; events are unaffected, totalCount unknown. Retry earthquake_count_events with identical filters. Absent if count succeeded or was unnecessary."

Previous value: -"Machine-readable failure mode. Declared by this tool: `result_too_large`: One event or page metadata cannot fit the response budget. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_range`: Minimum magnitude or depth exceeds its maximum, or start_time is after end_time. `result_too_large`: One event or page metadata cannot fit the response budget. `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "result_too_large",
-  "invalid_radius",
-  "invalid_bounding_box",
-  "source_unavailable",
-  "source_timeout",
-  "upstream_rejected",
-  "upstream_rejected_no_reason"
-]New value: +[
+  "invalid_range",
+  "result_too_large",
+  "invalid_radius",
+  "invalid_bounding_box",
+  "source_unavailable",
+  "source_timeout",
+  "upstream_rejected",
+  "upstream_rejected_no_reason"
+]

Previous value: -"PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field."New value: +"PAGER estimated impact; null without an assessment or for EMSC."

Previous value: -"Code of the agency or network the source names as authoritative for this solution, e.g. \"NEIC\", \"BMKG\", \"NDI\" from EMSC or \"us\", \"ci\", \"ak\" from USGS. Absent when the source reports none."New value: +"Authoritative agency/network code (EMSC auth or USGS net); absent if unpublished."

Previous value: -"Maximum reported intensity (Community Decimal Intensity, 0–12 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field."New value: +"Maximum DYFI Community Decimal Intensity (0–12); null if uncomputed or unsupported (EMSC)."

Previous value: -"Hypocenter depth in kilometers. Shallow (<70 km), intermediate (70–300 km), or deep (>300 km). Null for historical events where depth was not measured."New value: +"Hypocenter depth in km; null if unmeasured."

Previous value: -"How certain the source is of event_type: \"known\" (asserted), \"suspected\", \"unknown\", or \"unreported\". EMSC publishes this as the first character of its event-type code — a suspected explosion is not a confirmed one, and this is the only field that says so. Absent for USGS, which publishes no certainty axis, and absent for an EMSC code outside the published nomenclature."New value: +"EMSC classification certainty: known (asserted), suspected, unknown, or unreported. Suspected is not confirmed. Absent for USGS and unrecognized EMSC codes."

Previous value: -"What kind of event this is, in one vocabulary whichever source served it — the QuakeML type names USGS publishes (\"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\"). EMSC's two-character code is decoded to the same names, so the same event carries the same value from either source; how sure the source is rides on event_certainty instead. A code outside the published nomenclature is forwarded verbatim rather than guessed at. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."New value: +"QuakeML classification (earthquake, quarry blast, explosion, etc.). EMSC codes decode to USGS names; unknown codes pass through verbatim. Certainty is separate. Absent if unpublished; either catalog includes non-tectonic events."

Previous value: -"Number of DYFI (Did You Feel It?) responses. Null when USGS has received no reports for the event, and always null for EMSC, which publishes no DYFI field — a null is not evidence the event went unfelt."New value: +"DYFI (Did You Feel It?) response count; null if no USGS reports or source has no DYFI (EMSC). Null does not mean unfelt."

Previous value: -"Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as \"M ?\")."New value: +"Preferred magnitude; null if not computed (title: \"M ?\")."

Previous value: -"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field."New value: +"Maximum ShakeMap Modified Mercalli intensity (0–12); null without a ShakeMap or for EMSC."

Previous value: -"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field."New value: +"USGS significance (0–2000+), combining magnitude, felt reports and PAGER; null if uncomputed or for EMSC."

Previous value: -"Upstream catalog this solution came from, e.g. \"EMSC-RTS\" (EMSC real-time seismicity, revised as analysis continues). Absent for USGS, which publishes no catalog identifier on event records."New value: +"Solution catalog, e.g. EMSC-RTS (real-time, subject to revision). Absent for USGS."

Previous value: -"Human-review state: \"automatic\" (posted by automatic processing, not yet verified by a person), \"reviewed\" (examined by an analyst), or \"deleted\". Null when the source publishes no review status — EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final."New value: +"Review state: automatic (unverified), reviewed (analyst checked), or deleted. Null if unpublished (EMSC); such solutions remain unverified and subject to revision."

Previous value: -"Human-readable event summary, e.g. \"M 6.0 - 13 km S of Honaunau-Napoopoo, Hawaii\"."New value: +"Event summary, e.g. \"M 6.0 - Hawaii\"."

Previous value: -"USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning — USGS states the flag does not indicate whether a tsunami did or will exist; check NOAA (tsunami.gov) for actual alert status. Null when the source publishes no such flag, as EMSC does not."New value: +"USGS tsunami flag: 1 for large oceanic events, 0 otherwise; null if unpublished (EMSC). Not a warning or evidence of a tsunami; check NOAA tsunami.gov for alerts."

Previous value: -"Value to pass as the offset input to retrieve the next page, with every other input unchanged. Present when more events remain or may remain with an unknown total; absent means this was the last page."New value: +"Next 1-based offset; keep other inputs unchanged. Present if more events remain or may remain with unknown total; absent on last page."

Previous value: -"PAGER alert filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied minimum PAGER alert; absent for EMSC."

Previous value: -"Effective query end time. Absent when omitted from input — the upstream defaults to the current time."New value: +"Applied end time; absent means upstream current-time default."

Previous value: -"Event-type filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied event type; absent for EMSC."

Previous value: -"Radius-search latitude sent upstream."New value: +"Circle latitude, degrees."

Previous value: -"Radius-search longitude sent upstream."New value: +"Circle longitude, degrees."

Added value: +{
+  "description": "Applied magnitude type.",
+  "type": "string"
+}

Previous value: -"Maximum depth filter sent upstream."New value: +"Applied maximum depth, km."

Previous value: -"Maximum magnitude filter sent upstream."New value: +"Applied maximum magnitude."

Previous value: -"Minimum depth filter sent upstream."New value: +"Applied minimum depth, km."

Previous value: -"DYFI felt-report filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied minimum DYFI response count; absent for EMSC."

Previous value: -"Minimum magnitude filter sent upstream."New value: +"Applied minimum magnitude."

Previous value: -"Significance filter sent upstream. Absent for EMSC — not supported there."New value: +"Applied minimum significance; absent for EMSC."

Added value: +{
+  "description": "Applied required product; USGS only.",
+  "type": "string"
+}

Added value: +{
+  "description": "Applied review status; USGS only.",
+  "enum": [
+    "automatic",
+    "reviewed"
+  ],
+  "type": "string"
+}

Previous value: -"Effective query start time sent upstream — server-resolved to a 30-day window when omitted from input."New value: +"Applied start time; defaults to 30 days before end/now."

Previous value: -"Total events matching the query before the limit was applied. Fetched via a follow-up count query when results are truncated at the limit. Absent when results were not capped, and when that follow-up query failed — countUnavailable separates the two."New value: +"Full match total, inferred from a nonempty short upstream page (or empty first page), otherwise counted for full pages. Absent for empty later pages or failed counts; countUnavailable marks failures."

Previous value: -"True when results were capped by the requested limit, candidate limit, or response byte budget. totalCount carries the full match count when available, and nextOffset the input for the following page. With countUnavailable set the total is unknown, so this flag means the page was filled, not that more events are confirmed to remain."New value: +"Page capped by limit, candidates or bytes. Continue with nextOffset. Without totalCount, more events may remain but are not confirmed."

Previous value: -"USGS event ID, e.g. \"hv74966427\" or \"us6000sznj\". Found in the \"id\" field of earthquake_get_feed and earthquake_search results."New value: +"USGS event ID, e.g. \"hv74966427\" or \"us6000sznj\". Found in the \"id\" field of earthquake_get_feed and earthquake_search_events results."

Previous value: -"Machine-readable failure mode. Declared by this tool: `feed_unavailable`: USGS feed endpoint returns a 5xx, HTML, or is unreachable. `feed_timeout`: USGS feed endpoint did not answer before the request deadline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_cursor`: The feed cursor is malformed. `cursor_expired`: The retained generation expired, was evicted, or does not belong to this tenant and feed. `snapshot_too_large`: The feed exceeds retained storage capacity. `result_too_large`: One event or page metadata cannot fit the response budget. `feed_unavailable`: USGS feed endpoint returns a 5xx, HTML, or is unreachable. `feed_timeout`: USGS feed endpoint did not answer before the request deadline. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "feed_unavailable",
-  "feed_timeout"
-]New value: +[
+  "invalid_cursor",
+  "cursor_expired",
+  "snapshot_too_large",
+  "result_too_large",
+  "feed_unavailable",
+  "feed_timeout"
+]

Previous value: -"Recovery guidance when the feed contains no events, or how to continue when a page was capped — narrowing the magnitude tier, widening the time window, paging with the cursor, or using earthquake_search for filtered queries. Absent when a single page covers the whole feed."New value: +"Recovery guidance when the feed contains no events, or how to continue when a page was capped — narrowing the magnitude tier, widening the time window, paging with the cursor, or using earthquake_search_events for filtered queries. Absent when a single page covers the whole feed."

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "number",
+  "null"
+]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "count",
+      "max_allowed",
+      "source",
+      "exceeds_limit"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "invalid_radius",
+            "invalid_bounding_box",
+            "source_unavailable",
+            "source_timeout",
+            "upstream_rejected",
+            "upstream_rejected_no_reason"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "count",
-  "max_allowed",
-  "source",
-  "exceeds_limit"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "event"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: No event matches the provided event_id. `source_unavailable`: The USGS event API returns a 5xx, serves HTML, or is unreachable. `source_timeout`: The USGS event API did not answer before the request deadline. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found",
+            "source_unavailable",
+            "source_timeout"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "event"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "count",
+      "generated_at",
+      "events",
+      "feed_url"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `feed_unavailable`: USGS feed endpoint returns a 5xx, HTML, or is unreachable. `feed_timeout`: USGS feed endpoint did not answer before the request deadline. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "feed_unavailable",
+            "feed_timeout"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "count",
-  "generated_at",
-  "events",
-  "feed_url"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "count",
+      "source",
+      "events"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `invalid_radius`: latitude or longitude provided without radius_km, or vice versa. `invalid_bounding_box`: min_latitude exceeds max_latitude, or min_longitude exceeds max_longitude. `source_unavailable`: Selected source API returns a 5xx or is unreachable. `source_timeout`: Selected source API did not answer before the request deadline. `upstream_rejected`: The source API rejected the query parameters and explained why in its response body. `upstream_rejected_no_reason`: The source API rejected the query but its response body carried no usable explanation. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "invalid_radius",
+            "invalid_bounding_box",
+            "source_unavailable",
+            "source_timeout",
+            "upstream_rejected",
+            "upstream_rejected_no_reason"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "count",
-  "source",
-  "events"
-]

Previous value: -"Maximum modeled peak ground acceleration, in percent of g."New value: +"Maximum modeled peak ground acceleration, in g — a fraction of standard gravity, as USGS ShakeMap publishes it (0.4 is four tenths of g)."

Added value: +{
+  "description": "How certain the source is of event_type: \"known\" (asserted), \"suspected\", \"unknown\", or \"unreported\". EMSC publishes this as the first character of its event-type code — a suspected explosion is not a confirmed one, and this is the only field that says so. Absent for USGS, which publishes no certainty axis, and absent for an EMSC code outside the published nomenclature.",
+  "enum": [
+    "known",
+    "suspected",
+    "unknown",
+    "unreported"
+  ],
+  "type": "string"
+}

Previous value: -"Upstream event classification. USGS spells it out — \"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\" — while EMSC publishes a two-letter evtype code, \"ke\" for a known earthquake and \"ue\" for an unknown event. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."New value: +"What kind of event this is, in one vocabulary whichever source served it — the QuakeML type names USGS publishes (\"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\"). EMSC's two-character code is decoded to the same names, so the same event carries the same value from either source; how sure the source is rides on event_certainty instead. A code outside the published nomenclature is forwarded verbatim rather than guessed at. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."

Added value: +{
+  "description": "How certain the source is of event_type: \"known\" (asserted), \"suspected\", \"unknown\", or \"unreported\". EMSC publishes this as the first character of its event-type code — a suspected explosion is not a confirmed one, and this is the only field that says so. Absent for USGS, which publishes no certainty axis, and absent for an EMSC code outside the published nomenclature.",
+  "enum": [
+    "known",
+    "suspected",
+    "unknown",
+    "unreported"
+  ],
+  "type": "string"
+}

Previous value: -"Upstream event classification. USGS spells it out — \"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\" — while EMSC publishes a two-letter evtype code, \"ke\" for a known earthquake and \"ue\" for an unknown event. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."New value: +"What kind of event this is, in one vocabulary whichever source served it — the QuakeML type names USGS publishes (\"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\"). EMSC's two-character code is decoded to the same names, so the same event carries the same value from either source; how sure the source is rides on event_certainty instead. A code outside the published nomenclature is forwarded verbatim rather than guessed at. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."

Added value: +{
+  "description": "True when the follow-up total-count query failed, so the total is unknown for this call rather than never requested. The returned events are complete and unaffected; only totalCount is missing. Retry earthquake_count with the same filters to recover the total. Absent whenever the count succeeded or was never needed.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How certain the source is of event_type: \"known\" (asserted), \"suspected\", \"unknown\", or \"unreported\". EMSC publishes this as the first character of its event-type code — a suspected explosion is not a confirmed one, and this is the only field that says so. Absent for USGS, which publishes no certainty axis, and absent for an EMSC code outside the published nomenclature.",
+  "enum": [
+    "known",
+    "suspected",
+    "unknown",
+    "unreported"
+  ],
+  "type": "string"
+}

Previous value: -"Upstream event classification. USGS spells it out — \"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\" — while EMSC publishes a two-letter evtype code, \"ke\" for a known earthquake and \"ue\" for an unknown event. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."New value: +"What kind of event this is, in one vocabulary whichever source served it — the QuakeML type names USGS publishes (\"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\"). EMSC's two-character code is decoded to the same names, so the same event carries the same value from either source; how sure the source is rides on event_certainty instead. A code outside the published nomenclature is forwarded verbatim rather than guessed at. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification."

Previous value: -"Total events matching the query before the limit was applied. Fetched via a follow-up count query when results are truncated at the limit; absent otherwise."New value: +"Total events matching the query before the limit was applied. Fetched via a follow-up count query when results are truncated at the limit. Absent when results were not capped, and when that follow-up query failed — countUnavailable separates the two."

Previous value: -"True when results were capped by the limit parameter and more events remain. totalCount carries the full match count when available, and nextOffset the input for the following page."New value: +"True when results were capped by the limit parameter. totalCount carries the full match count when available, and nextOffset the input for the following page. With countUnavailable set the total is unknown, so this flag means the page was filled, not that more events are confirmed to remain."

Previous value: -"End of time range as ISO 8601. Defaults to current time if omitted."New value: +"End of time range as ISO 8601, in the same forms start_time accepts. Defaults to current time if omitted."

Added value: +"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"

Added value: +1

Previous value: -"Maximum depth in kilometers."New value: +"Maximum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope."

Added value: +1000

Added value: +-100

Added value: +{
+  "description": "Northern edge of a bounding-box search, in degrees.",
+  "maximum": 90,
+  "minimum": -90,
+  "type": "number"
+}

Added value: +{
+  "description": "Eastern edge of a bounding-box search, in degrees.",
+  "maximum": 360,
+  "minimum": -360,
+  "type": "number"
+}

Previous value: -"Minimum depth in kilometers. Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km)."New value: +"Minimum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope. Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km)."

Added value: +1000

Added value: +-100

Added value: +{
+  "description": "Southern edge of a bounding-box search, in degrees. Independent of the other three box parameters — supply any of them. Must not exceed max_latitude when both are given.",
+  "maximum": 90,
+  "minimum": -90,
+  "type": "number"
+}

Added value: +{
+  "description": "Western edge of a bounding-box search, in degrees. Range extends beyond ±180 so a box can cross the antimeridian (e.g. min_longitude=170, max_longitude=190) — always keep min_longitude at or below max_longitude rather than inverting the pair.",
+  "maximum": 360,
+  "minimum": -360,
+  "type": "number"
+}

Previous value: -"Search radius in kilometers from the lat/lon point. Converted to degrees for EMSC (1° ≈ 111.2 km)."New value: +"Search radius in kilometers from the lat/lon point. Max 20001.6, the ceiling USGS enforces — half the Earth's great-circle circumference. Converted to degrees for EMSC (1° ≈ 111.2 km)."

Previous value: -20002New value: +20001.6

Previous value: -"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window."New value: +"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). A bare year expands to January 1st and an unpadded month or day is zero-padded, so both sources honor the same window. Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window."

Added value: +"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"

Added value: +{
+  "description": "Northern bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Added value: +{
+  "description": "Eastern bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Added value: +{
+  "description": "Southern bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Added value: +{
+  "description": "Western bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Previous value: -"End of time range as ISO 8601. Defaults to current time if omitted."New value: +"End of time range as ISO 8601, in the same forms start_time accepts. Defaults to current time if omitted."

Added value: +"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"

Added value: +1

Previous value: -"Maximum depth in kilometers."New value: +"Maximum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope."

Added value: +1000

Added value: +-100

Added value: +{
+  "description": "Northern edge of a bounding-box search, in degrees.",
+  "maximum": 90,
+  "minimum": -90,
+  "type": "number"
+}

Added value: +{
+  "description": "Eastern edge of a bounding-box search, in degrees.",
+  "maximum": 360,
+  "minimum": -360,
+  "type": "number"
+}

Previous value: -"Minimum depth in kilometers. Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km)."New value: +"Minimum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope. Shallow quakes (0–70 km) typically cause more surface damage than deep quakes (>300 km)."

Added value: +1000

Added value: +-100

Added value: +{
+  "description": "Southern edge of a bounding-box search, in degrees. Independent of the other three box parameters — supply any of them. Must not exceed max_latitude when both are given.",
+  "maximum": 90,
+  "minimum": -90,
+  "type": "number"
+}

Added value: +{
+  "description": "Western edge of a bounding-box search, in degrees. Range extends beyond ±180 so a box can cross the antimeridian (e.g. min_longitude=170, max_longitude=190) — always keep min_longitude at or below max_longitude rather than inverting the pair.",
+  "maximum": 360,
+  "minimum": -360,
+  "type": "number"
+}

Previous value: -"Search radius in kilometers from the lat/lon point. 100 km covers a metro region; 500 km covers a large country. Converted to degrees for EMSC (1° ≈ 111.2 km)."New value: +"Search radius in kilometers from the lat/lon point. 100 km covers a metro region; 500 km covers a large country. Max 20001.6, the ceiling USGS enforces. Converted to degrees for EMSC (1° ≈ 111.2 km)."

Previous value: -20002New value: +20001.6

Previous value: -"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window."New value: +"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). A bare year expands to January 1st and an unpadded month or day is zero-padded, so both sources honor the same window. Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window."

Added value: +"^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"

Added value: +{
+  "description": "Northern bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Added value: +{
+  "description": "Eastern bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Added value: +{
+  "description": "Southern bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Added value: +{
+  "description": "Western bounding-box edge sent upstream, in degrees.",
+  "type": "number"
+}

Added value: +{
+  "description": "Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions from the count, or \"quarry blast\" to count only those. Matched verbatim against the USGS catalog, which accepts any string and returns a count of zero for an unrecognized one. Only available from USGS.",
+  "type": "string"
+}

Added value: +{
+  "description": "Event-type filter sent upstream. Absent for EMSC — not supported there.",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Analysis products USGS attached to this event. Absent when the event carries none — that means no product was produced, not that impact was zero.",
+  "properties": {
+    "dyfi": {
+      "additionalProperties": false,
+      "description": "Felt-report summary. Absent when no DYFI product exists for the event.",
+      "properties": {
+        "map_url": {
+          "description": "URL of the rendered DYFI intensity map image.",
+          "type": "string"
+        },
+        "max_cdi": {
+          "description": "Maximum Community Decimal Intensity derived from those reports (0–12 scale).",
+          "type": "number"
+        },
+        "responses": {
+          "description": "Number of \"Did You Feel It?\" reports the public submitted.",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "finite_fault": {
+      "additionalProperties": false,
+      "description": "Finite-fault rupture model. Produced only for large events.",
+      "properties": {
+        "model_url": {
+          "description": "URL of the finite-fault rupture model file.",
+          "type": "string"
+        },
+        "rupture_length_km": {
+          "description": "Modeled rupture length along strike, in kilometers.",
+          "type": "number"
+        },
+        "rupture_width_km": {
+          "description": "Modeled rupture width down dip, in kilometers.",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "ground_failure": {
+      "additionalProperties": false,
+      "description": "Secondary-hazard alert levels. Absent when no ground-failure model was run.",
+      "properties": {
+        "landslide_alert": {
+          "description": "Landslide hazard alert level — \"green\", \"yellow\", \"orange\", or \"red\".",
+          "type": "string"
+        },
+        "liquefaction_alert": {
+          "description": "Liquefaction hazard alert level — \"green\", \"yellow\", \"orange\", or \"red\".",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "losspager": {
+      "additionalProperties": false,
+      "description": "PAGER impact assessment. Estimated fatality and economic-loss brackets live in a separate content file and are not part of this response — fetch report_url for them.",
+      "properties": {
+        "alert_level": {
+          "description": "PAGER impact alert level — \"green\", \"yellow\", \"orange\", or \"red\".",
+          "type": "string"
+        },
+        "report_url": {
+          "description": "URL of the PAGER one-page PDF summary of estimated impact.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "moment_tensor": {
+      "additionalProperties": false,
+      "description": "Focal-mechanism solution. Absent for events with no moment-tensor inversion.",
+      "properties": {
+        "derived_depth_km": {
+          "description": "Centroid depth in kilometers derived from the moment-tensor inversion.",
+          "type": "number"
+        },
+        "nodal_plane_1": {
+          "additionalProperties": false,
+          "description": "First nodal plane of the focal mechanism. Either plane can be the true fault.",
+          "properties": {
+            "dip": {
+              "description": "Fault plane dip in degrees from horizontal (0–90).",
+              "type": "number"
+            },
+            "rake": {
+              "description": "Slip direction in degrees (-180 to 180). Near 90 is reverse faulting, near -90 normal, near 0 or 180 strike-slip.",
+              "type": "number"
+            },
+            "strike": {
+              "description": "Fault plane strike in degrees clockwise from north (0–360).",
+              "type": "number"
+            }
+          },
+          "required": [
+            "strike",
+            "dip",
+            "rake"
+          ],
+          "type": "object"
+        },
+        "nodal_plane_2": {
+          "additionalProperties": false,
+          "description": "Second nodal plane — the auxiliary solution, indistinguishable from the first on seismic data alone.",
+          "properties": {
+            "dip": {
+              "description": "Fault plane dip in degrees from horizontal (0–90).",
+              "type": "number"
+            },
+            "rake": {
+              "description": "Slip direction in degrees (-180 to 180). Near 90 is reverse faulting, near -90 normal, near 0 or 180 strike-slip.",
+              "type": "number"
+            },
+            "strike": {
+              "description": "Fault plane strike in degrees clockwise from north (0–360).",
+              "type": "number"
+            }
+          },
+          "required": [
+            "strike",
+            "dip",
+            "rake"
+          ],
+          "type": "object"
+        },
+        "scalar_moment_nm": {
+          "description": "Scalar seismic moment in newton-metres — the physical size of the rupture.",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "origin": {
+      "additionalProperties": false,
+      "description": "Location-quality metrics for the preferred origin.",
+      "properties": {
+        "azimuthal_gap_deg": {
+          "description": "Largest azimuthal gap between stations, in degrees. Gaps above ~180 make the location poorly constrained.",
+          "type": "number"
+        },
+        "depth_error_km": {
+          "description": "Depth uncertainty in kilometers.",
+          "type": "number"
+        },
+        "horizontal_error_km": {
+          "description": "Horizontal location uncertainty in kilometers.",
+          "type": "number"
+        },
+        "num_stations_used": {
+          "description": "Number of seismic stations used in the location solution.",
+          "type": "number"
+        },
+        "review_status": {
+          "description": "Review state of the origin solution as the contributing network published it.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "shakemap": {
+      "additionalProperties": false,
+      "description": "ShakeMap modeled ground-motion summary. Absent when no ShakeMap was produced.",
+      "properties": {
+        "intensity_map_url": {
+          "description": "URL of the rendered ShakeMap intensity map image.",
+          "type": "string"
+        },
+        "max_mmi": {
+          "description": "Maximum modeled shaking intensity across the ShakeMap grid (Modified Mercalli).",
+          "type": "number"
+        },
+        "max_pga": {
+          "description": "Maximum modeled peak ground acceleration, in percent of g.",
+          "type": "number"
+        },
+        "max_pgv": {
+          "description": "Maximum modeled peak ground velocity, in cm/s.",
+          "type": "number"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Upstream event classification. USGS spells it out — \"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\" — while EMSC publishes a two-letter evtype code, \"ke\" for a known earthquake and \"ue\" for an unknown event. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification.",
+  "type": "string"
+}

Added value: +{
+  "description": "Upstream event classification. USGS spells it out — \"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\" — while EMSC publishes a two-letter evtype code, \"ke\" for a known earthquake and \"ue\" for an unknown event. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification.",
+  "type": "string"
+}

Added value: +{
+  "description": "Filter by upstream event classification, e.g. \"earthquake\" to exclude quarry blasts and explosions, or \"quarry blast\" to see only those. Matched verbatim against the USGS catalog, which accepts any string and returns zero matches for an unrecognized one. Only available from USGS.",
+  "type": "string"
+}

Added value: +{
+  "description": "Upstream event classification. USGS spells it out — \"earthquake\", \"quarry blast\", \"explosion\", \"ice quake\" — while EMSC publishes a two-letter evtype code, \"ke\" for a known earthquake and \"ue\" for an unknown event. Not every record in either catalog is a tectonic earthquake. Absent when the source publishes no classification.",
+  "type": "string"
+}

Added value: +{
+  "description": "Event-type filter sent upstream. Absent for EMSC — not supported there.",
+  "type": "string"
+}

Previous value: -"Data source. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" covers the European-Mediterranean region."New value: +"Data source. Both catalogs are global. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" is an independent global catalog operated by the European-Mediterranean Seismological Centre — use it to cross-check a count from a separate network. It has no PAGER, DYFI, or ShakeMap metadata; its station coverage is densest around Europe and the Mediterranean, so counts of small events differ most by region."

Added value: +{
+  "description": "USGS-only filters supplied in the input but not sent upstream because source=emsc does not support them. The count is NOT constrained by these — re-run with source=usgs to apply them. Absent when every supplied filter was applied.",
+  "items": {
+    "description": "Name of an input filter that was not applied.",
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"PAGER estimated impact alert level. Null if not computed. USGS only."New value: +"PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field."

Added value: +{
+  "description": "Code of the agency or network the source names as authoritative for this solution, e.g. \"NEIC\", \"BMKG\", \"NDI\" from EMSC or \"us\", \"ci\", \"ak\" from USGS. Absent when the source reports none.",
+  "type": "string"
+}

Previous value: -"Maximum reported intensity (Community Decimal Intensity, 0–12 scale). USGS only."New value: +"Maximum reported intensity (Community Decimal Intensity, 0–12 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field."

Previous value: -"Number of DYFI (Did You Feel It?) responses. Null if no reports. USGS only."New value: +"Number of DYFI (Did You Feel It?) responses. Null when USGS has received no reports for the event, and always null for EMSC, which publishes no DYFI field — a null is not evidence the event went unfelt."

Previous value: -"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). USGS only."New value: +"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field."

Previous value: -"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. USGS only."New value: +"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field."

Added value: +{
+  "description": "Upstream catalog this solution came from, e.g. \"EMSC-RTS\" (EMSC real-time seismicity, revised as analysis continues). Absent for USGS, which publishes no catalog identifier on event records.",
+  "type": "string"
+}

Added value: +[
+  {
+    "enum": [
+      "automatic",
+      "reviewed",
+      "deleted"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Review status. Automatic detections may be revised."New value: +"Human-review state: \"automatic\" (posted by automatic processing, not yet verified by a person), \"reviewed\" (examined by an analyst), or \"deleted\". Null when the source publishes no review status — EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final."

Removed value: -[
-  "automatic",
-  "reviewed",
-  "deleted"
-]

Removed value: -"string"

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"1 if a tsunami warning was issued; 0 otherwise. USGS only; 0 for EMSC events."New value: +"USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning — USGS states the flag does not indicate whether a tsunami did or will exist; check NOAA (tsunami.gov) for actual alert status. Null when the source publishes no such flag, as EMSC does not."

Removed value: -"number"

Previous value: -"PAGER estimated impact alert level. Null if not computed. USGS only."New value: +"PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field."

Added value: +{
+  "description": "Code of the agency or network the source names as authoritative for this solution, e.g. \"NEIC\", \"BMKG\", \"NDI\" from EMSC or \"us\", \"ci\", \"ak\" from USGS. Absent when the source reports none.",
+  "type": "string"
+}

Previous value: -"Maximum reported intensity (Community Decimal Intensity, 0–12 scale). USGS only."New value: +"Maximum reported intensity (Community Decimal Intensity, 0–12 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field."

Previous value: -"Number of DYFI (Did You Feel It?) responses. Null if no reports. USGS only."New value: +"Number of DYFI (Did You Feel It?) responses. Null when USGS has received no reports for the event, and always null for EMSC, which publishes no DYFI field — a null is not evidence the event went unfelt."

Previous value: -"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). USGS only."New value: +"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field."

Previous value: -"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. USGS only."New value: +"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field."

Added value: +{
+  "description": "Upstream catalog this solution came from, e.g. \"EMSC-RTS\" (EMSC real-time seismicity, revised as analysis continues). Absent for USGS, which publishes no catalog identifier on event records.",
+  "type": "string"
+}

Added value: +[
+  {
+    "enum": [
+      "automatic",
+      "reviewed",
+      "deleted"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Review status. Automatic detections may be revised."New value: +"Human-review state: \"automatic\" (posted by automatic processing, not yet verified by a person), \"reviewed\" (examined by an analyst), or \"deleted\". Null when the source publishes no review status — EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final."

Removed value: -[
-  "automatic",
-  "reviewed",
-  "deleted"
-]

Removed value: -"string"

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"1 if a tsunami warning was issued; 0 otherwise. USGS only; 0 for EMSC events."New value: +"USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning — USGS states the flag does not indicate whether a tsunami did or will exist; check NOAA (tsunami.gov) for actual alert status. Null when the source publishes no such flag, as EMSC does not."

Removed value: -"number"

Previous value: -"Data source. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" covers the European-Mediterranean region with an independent catalog — useful for cross-verification or European-focused queries."New value: +"Data source. Both catalogs are global. \"usgs\" covers global events with PAGER, DYFI, and ShakeMap metadata. \"emsc\" is an independent global catalog operated by the European-Mediterranean Seismological Centre — use it to cross-check any event, anywhere, against a separate network. It publishes no PAGER, DYFI, or ShakeMap metadata and no per-event detail endpoint; its station coverage is densest around Europe and the Mediterranean."

Previous value: -"PAGER estimated impact alert level. Null if not computed. USGS only."New value: +"PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field."

Added value: +{
+  "description": "Code of the agency or network the source names as authoritative for this solution, e.g. \"NEIC\", \"BMKG\", \"NDI\" from EMSC or \"us\", \"ci\", \"ak\" from USGS. Absent when the source reports none.",
+  "type": "string"
+}

Previous value: -"Maximum reported intensity (Community Decimal Intensity, 0–12 scale). USGS only."New value: +"Maximum reported intensity (Community Decimal Intensity, 0–12 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field."

Previous value: -"Number of DYFI (Did You Feel It?) responses. Null if no reports. USGS only."New value: +"Number of DYFI (Did You Feel It?) responses. Null when USGS has received no reports for the event, and always null for EMSC, which publishes no DYFI field — a null is not evidence the event went unfelt."

Previous value: -"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). USGS only."New value: +"Maximum ShakeMap instrumental intensity (Modified Mercalli, 0–12 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field."

Previous value: -"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. USGS only."New value: +"USGS significance score (0–2000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field."

Added value: +{
+  "description": "Upstream catalog this solution came from, e.g. \"EMSC-RTS\" (EMSC real-time seismicity, revised as analysis continues). Absent for USGS, which publishes no catalog identifier on event records.",
+  "type": "string"
+}

Added value: +[
+  {
+    "enum": [
+      "automatic",
+      "reviewed",
+      "deleted"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Review status. Automatic detections may be revised."New value: +"Human-review state: \"automatic\" (posted by automatic processing, not yet verified by a person), \"reviewed\" (examined by an analyst), or \"deleted\". Null when the source publishes no review status — EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final."

Removed value: -[
-  "automatic",
-  "reviewed",
-  "deleted"
-]

Removed value: -"string"

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"1 if a tsunami warning was issued; 0 otherwise. USGS only; 0 for EMSC events."New value: +"USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning — USGS states the flag does not indicate whether a tsunami did or will exist; check NOAA (tsunami.gov) for actual alert status. Null when the source publishes no such flag, as EMSC does not."

Removed value: -"number"

Added value: +{
+  "description": "USGS-only filters supplied in the input but not sent upstream because source=emsc does not support them. The result set is NOT constrained by these — re-run with source=usgs to apply them. Absent when every supplied filter was applied.",
+  "items": {
+    "description": "Name of an input filter that was not applied.",
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Echo of the effective parameters the count covers, including server-resolved defaults. Read start_time and end_time to know which window the count spans — a filter absent here was not sent upstream.",
+  "properties": {
+    "alert_level": {
+      "description": "PAGER alert filter sent upstream. Absent for EMSC — not supported there.",
+      "type": "string"
+    },
+    "end_time": {
+      "description": "Effective query end time. Absent when omitted from input — the upstream defaults to the current time.",
+      "type": "string"
+    },
+    "latitude": {
+      "description": "Radius-search latitude sent upstream.",
+      "type": "number"
+    },
+    "longitude": {
+      "description": "Radius-search longitude sent upstream.",
+      "type": "number"
+    },
+    "max_depth_km": {
+      "description": "Maximum depth filter sent upstream.",
+      "type": "number"
+    },
+    "max_magnitude": {
+      "description": "Maximum magnitude filter sent upstream.",
+      "type": "number"
+    },
+    "min_depth_km": {
+      "description": "Minimum depth filter sent upstream.",
+      "type": "number"
+    },
+    "min_felt": {
+      "description": "DYFI felt-report filter sent upstream. Absent for EMSC — not supported there.",
+      "type": "number"
+    },
+    "min_magnitude": {
+      "description": "Minimum magnitude filter sent upstream.",
+      "type": "number"
+    },
+    "min_significance": {
+      "description": "Significance filter sent upstream. Absent for EMSC — not supported there.",
+      "type": "number"
+    },
+    "radius_km": {
+      "description": "Search radius in km sent upstream (converted to degrees for EMSC).",
+      "type": "number"
+    },
+    "source": {
+      "description": "Data source queried.",
+      "enum": [
+        "usgs",
+        "emsc"
+      ],
+      "type": "string"
+    },
+    "start_time": {
+      "description": "Effective query start time sent upstream — server-resolved to a 30-day window when omitted from input.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Opaque token for the next page, taken verbatim from a previous call's nextCursor. Omit for the first page. Do not construct, parse, or edit it — it encodes a position in the feed snapshot and is rejected if malformed.",
+  "type": "string"
+}

Added value: +{
+  "description": "Maximum events to return in this call. Default 100, max 1000. Applies to the first page; later pages carry the page size inside the cursor, so set it on the first call rather than changing it mid-sequence.",
+  "maximum": 1000,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"Number of events in the feed."New value: +"Number of events returned in this page, not the whole feed."

Previous value: -"Earthquake events, newest first."New value: +"Earthquake events for this page, newest first."

Added value: +{
+  "description": "Opaque token to pass back as the cursor input for the next page. Present only when more events remain; absent means this was the last page.",
+  "type": "string"
+}

Previous value: -"Recovery guidance when the feed contains no events — suggests narrowing the magnitude tier, widening the time window, or using earthquake_search for filtered queries. Absent when the feed contains events."New value: +"Recovery guidance when the feed contains no events, or how to continue when a page was capped — narrowing the magnitude tier, widening the time window, paging with the cursor, or using earthquake_search for filtered queries. Absent when a single page covers the whole feed."

Added value: +{
+  "description": "Number of events in the whole feed, across every page.",
+  "type": "number"
+}

Added value: +{
+  "description": "True when the feed holds more events than this page returned. nextCursor carries the input for the following page.",
+  "type": "boolean"
+}

Previous value: -"Maximum events to return. Default 100. Large limits (>1000) may result in slow responses. Max 20000."New value: +"Maximum events to return per call. Default 100. Large limits (>1000) may result in slow responses. Max 20000. Combine with offset to retrieve match sets larger than one call can return."

Added value: +{
+  "description": "Index of the first event to return, counting from 1 — offset=1 is the first match (both upstream APIs reject 0). Omit for the first page, then pass the nextOffset value from a capped result to fetch the next one. Ordering is set by order_by, so keep order_by, limit, and every filter identical across pages.",
+  "maximum": 9007199254740991,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Value to pass as the offset input to retrieve the next page, with every other input unchanged. Present only when more events remain; absent means this was the last page.",
+  "type": "number"
+}

Added value: +{
+  "description": "1-based paging offset sent upstream. Absent when the first page was fetched.",
+  "type": "number"
+}

Previous value: -"True when results were capped by the limit parameter and more events likely exist. totalCount carries the full match count when available."New value: +"True when results were capped by the limit parameter and more events remain. totalCount carries the full match count when available, and nextOffset the input for the following page."

Previous value: -"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). Defaults to 30 days before end_time if omitted."New value: +"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window."

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Preferred magnitude value."New value: +"Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as \"M ?\")."

Removed value: -"number"

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Preferred magnitude value."New value: +"Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as \"M ?\")."

Removed value: -"number"

Previous value: -"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). Defaults to 30 days before end_time if omitted."New value: +"Start of time range as ISO 8601 (e.g. \"2026-01-01\" or \"2026-05-23T00:00:00\"). Defaults to 30 days before end_time (or before the current time) if omitted — applied server-side so USGS and EMSC honor the same window."

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Preferred magnitude value."New value: +"Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as \"M ?\")."

Removed value: -"number"

Added value: +{
+  "additionalProperties": false,
+  "description": "Echo of the effective parameters sent to the upstream API, including server-resolved defaults. Use to diagnose unexpected or empty results — a filter absent here was not sent upstream.",
+  "properties": {
+    "alert_level": {
+      "description": "PAGER alert filter sent upstream. Absent for EMSC — not supported there.",
+      "type": "string"
+    },
+    "end_time": {
+      "description": "Effective query end time. Absent when omitted from input — the upstream defaults to the current time.",
+      "type": "string"
+    },
+    "latitude": {
+      "description": "Radius-search latitude sent upstream.",
+      "type": "number"
+    },
+    "limit": {
+      "description": "Effective result limit sent upstream.",
+      "type": "number"
+    },
+    "longitude": {
+      "description": "Radius-search longitude sent upstream.",
+      "type": "number"
+    },
+    "max_depth_km": {
+      "description": "Maximum depth filter sent upstream.",
+      "type": "number"
+    },
+    "max_magnitude": {
+      "description": "Maximum magnitude filter sent upstream.",
+      "type": "number"
+    },
+    "min_depth_km": {
+      "description": "Minimum depth filter sent upstream.",
+      "type": "number"
+    },
+    "min_felt": {
+      "description": "DYFI felt-report filter sent upstream. Absent for EMSC — not supported there.",
+      "type": "number"
+    },
+    "min_magnitude": {
+      "description": "Minimum magnitude filter sent upstream.",
+      "type": "number"
+    },
+    "min_significance": {
+      "description": "Significance filter sent upstream. Absent for EMSC — not supported there.",
+      "type": "number"
+    },
+    "order_by": {
+      "description": "Sort order sent upstream.",
+      "type": "string"
+    },
+    "radius_km": {
+      "description": "Search radius in km sent upstream (converted to degrees for EMSC).",
+      "type": "number"
+    },
+    "source": {
+      "description": "Data source queried.",
+      "enum": [
+        "usgs",
+        "emsc"
+      ],
+      "type": "string"
+    },
+    "start_time": {
+      "description": "Effective query start time sent upstream — server-resolved to a 30-day window when omitted from input.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "limit",
+    "order_by"
+  ],
+  "type": "object"
+}

Previous value: -"Total events matching the query before the limit was applied. Absent when the upstream API does not report a total count."New value: +"Total events matching the query before the limit was applied. Fetched via a follow-up count query when results are truncated at the limit; absent otherwise."

Previous value: -"True when results were capped by the limit parameter and more events likely exist. Use earthquake_count to get the total match count."New value: +"True when results were capped by the limit parameter and more events likely exist. totalCount carries the full match count when available."