earthquake-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'source': {'enum': ['usgs', 'emsc'], 'type': 'string', 'default': 'usgs', 'description': '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 â\x80\x94 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.'}, 'end_time': {'type': 'string', 'pattern': '^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$', 'description': 'End of time range as ISO 8601, in the same forms start_time accepts. Defaults to current time if omitted.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude for radius search. Requires longitude and radius_km.'}, 'min_felt': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Minimum number of DYFI (Did You Feel It?) reports. Use to count events with confirmed public impact. Only available from USGS.'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude for radius search. Requires latitude and radius_km.'}, 'radius_km': {'type': 'number', 'maximum': 20001.6, 'minimum': 0, 'description': "Search radius in kilometers from the lat/lon point. Max 20001.6, the ceiling USGS enforces â\x80\x94 half the Earth's great-circle circumference. Converted to degrees for EMSC (1° â\x89\x88 111.2 km)."}, 'event_type': {'type': 'string', 'minLength': 1, '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.'}, 'start_time': {'type': 'string', 'pattern': '^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$', 'description': '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 â\x80\x94 applied server-side so USGS and EMSC honor the same window.'}, 'alert_level': {'enum': ['green', 'yellow', 'orange', 'red'], 'type': 'string', 'description': 'Minimum PAGER alert level. PAGER estimates economic loss and casualties. "green" = minimal impact; "red" = extreme. Only available from USGS.'}, 'max_depth_km': {'type': 'number', 'maximum': 1000, 'minimum': -100, 'description': 'Maximum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope.'}, 'max_latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Northern edge of a bounding-box search, in degrees.'}, 'min_depth_km': {'type': 'number', 'maximum': 1000, 'minimum': -100, 'description': 'Minimum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope. Shallow quakes (0â\x80\x9370 km) typically cause more surface damage than deep quakes (>300 km).'}, 'min_latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Southern edge of a bounding-box search, in degrees. Independent of the other three box parameters â\x80\x94 supply any of them. Must not exceed max_latitude when both are given.'}, 'max_longitude': {'type': 'number', 'maximum': 360, 'minimum': -360, 'description': 'Eastern edge of a bounding-box search, in degrees.'}, 'max_magnitude': {'type': 'number', 'maximum': 10, 'minimum': -1, 'description': 'Maximum magnitude.'}, 'min_longitude': {'type': 'number', 'maximum': 360, 'minimum': -360, '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) â\x80\x94 always keep min_longitude at or below max_longitude rather than inverting the pair.'}, 'min_magnitude': {'type': 'number', 'maximum': 10, 'minimum': -1, 'description': 'Minimum magnitude (Richter or equivalent). M2.5+ is felt by some people; M5+ can cause damage; M7+ is major.'}, 'min_significance': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Minimum USGS significance score (0â\x80\x932000+). Combines magnitude, felt reports, and PAGER estimates. Significant events typically score 600+. Only available from USGS.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['count', 'max_allowed', 'source', 'exceeds_limit']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'count': {'type': 'number', 'description': 'Number of events matching the query.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['invalid_radius', 'invalid_bounding_box', 'source_unavailable', 'source_timeout', 'upstream_rejected', 'upstream_rejected_no_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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'source': {'enum': ['usgs', 'emsc'], 'type': 'string', 'description': 'Data source used.'}, 'queryEcho': {'type': 'object', 'required': ['source'], 'properties': {'source': {'enum': ['usgs', 'emsc'], 'type': 'string', 'description': 'Data source queried.'}, 'end_time': {'type': 'string', 'description': 'Effective query end time. Absent when omitted from input â\x80\x94 the upstream defaults to the current time.'}, 'latitude': {'type': 'number', 'description': 'Radius-search latitude sent upstream.'}, 'min_felt': {'type': 'number', 'description': 'DYFI felt-report filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}, 'longitude': {'type': 'number', 'description': 'Radius-search longitude sent upstream.'}, 'radius_km': {'type': 'number', 'description': 'Search radius in km sent upstream (converted to degrees for EMSC).'}, 'event_type': {'type': 'string', 'description': 'Event-type filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}, 'start_time': {'type': 'string', 'description': 'Effective query start time sent upstream â\x80\x94 server-resolved to a 30-day window when omitted from input.'}, 'alert_level': {'type': 'string', 'description': 'PAGER alert filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}, 'max_depth_km': {'type': 'number', 'description': 'Maximum depth filter sent upstream.'}, 'max_latitude': {'type': 'number', 'description': 'Northern bounding-box edge sent upstream, in degrees.'}, 'min_depth_km': {'type': 'number', 'description': 'Minimum depth filter sent upstream.'}, 'min_latitude': {'type': 'number', 'description': 'Southern bounding-box edge sent upstream, in degrees.'}, 'max_longitude': {'type': 'number', 'description': 'Eastern bounding-box edge sent upstream, in degrees.'}, 'max_magnitude': {'type': 'number', 'description': 'Maximum magnitude filter sent upstream.'}, 'min_longitude': {'type': 'number', 'description': 'Western bounding-box edge sent upstream, in degrees.'}, 'min_magnitude': {'type': 'number', 'description': 'Minimum magnitude filter sent upstream.'}, 'min_significance': {'type': 'number', 'description': 'Significance filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}}, '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 â\x80\x94 a filter absent here was not sent upstream.', 'additionalProperties': False}, 'max_allowed': {'type': ['number', 'null'], 'description': 'Maximum events the API would return for a full fetch. 20000 for USGS. Null for EMSC â\x80\x94 the EMSC count endpoint does not return this field.'}, 'exceeds_limit': {'type': 'boolean', 'description': 'True when count exceeds 20000 â\x80\x94 a full earthquake_search would be truncated. For EMSC, evaluated against the known 20000 limit since max_allowed is not returned. Narrow filters to retrieve all matching events.'}, 'ignoredFilters': {'type': 'array', 'items': {'type': 'string', 'description': 'Name of an input filter that was not applied.'}, '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 â\x80\x94 re-run with source=usgs to apply them. Absent when every supplied filter was applied.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['event_id'], 'properties': {'event_id': {'type': 'string', 'description': 'USGS event ID, e.g. "hv74966427" or "us6000sznj". Found in the "id" field of earthquake_get_feed and earthquake_search results.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['event']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'source_unavailable', 'source_timeout'], '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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'event': {'type': 'object', 'required': ['id', 'title', 'magnitude', 'magnitude_type', 'time', 'updated', 'place', 'latitude', 'longitude', 'depth_km', 'felt', 'cdi', 'mmi', 'alert', 'tsunami', 'significance', 'status'], 'properties': {'id': {'type': 'string', 'description': 'USGS or EMSC event identifier.'}, 'cdi': {'type': ['number', 'null'], 'description': 'Maximum reported intensity (Community Decimal Intensity, 0â\x80\x9312 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field.'}, 'mmi': {'type': ['number', 'null'], 'description': 'Maximum ShakeMap instrumental intensity (Modified Mercalli, 0â\x80\x9312 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field.'}, 'auth': {'type': 'string', '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.'}, 'felt': {'type': ['number', 'null'], 'description': '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 â\x80\x94 a null is not evidence the event went unfelt.'}, 'time': {'type': 'string', 'description': 'ISO 8601 UTC origin time.'}, 'alert': {'anyOf': [{'enum': ['green', 'yellow', 'orange', 'red'], 'type': 'string'}, {'type': 'null'}], 'description': 'PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field.'}, 'place': {'type': 'string', 'description': 'Nearest named location.'}, 'title': {'type': 'string', 'description': 'Human-readable event summary, e.g. "M 6.0 - 13 km S of Honaunau-Napoopoo, Hawaii".'}, 'status': {'anyOf': [{'enum': ['automatic', 'reviewed', 'deleted'], 'type': 'string'}, {'type': 'null'}], 'description': '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 â\x80\x94 EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final.'}, 'tsunami': {'type': ['number', 'null'], 'description': 'USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning â\x80\x94 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.'}, 'updated': {'type': 'string', 'description': 'ISO 8601 UTC time this record was last updated.'}, 'depth_km': {'type': ['number', 'null'], 'description': 'Hypocenter depth in kilometers. Shallow (<70 km), intermediate (70â\x80\x93300 km), or deep (>300 km). Null for historical events where depth was not measured.'}, 'latitude': {'type': 'number', 'description': 'Epicenter latitude in decimal degrees.'}, 'event_url': {'type': 'string', 'description': 'USGS event page URL. Present for USGS events only.'}, 'longitude': {'type': 'number', 'description': 'Epicenter longitude in decimal degrees.'}, 'magnitude': {'type': ['number', 'null'], 'description': 'Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as "M ?").'}, 'detail_url': {'type': 'string', 'description': 'URL to fetch the full GeoJSON detail record. Present in USGS list responses.'}, 'event_type': {'type': 'string', 'description': 'What kind of event this is, in one vocabulary whichever source served it â\x80\x94 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.'}, 'significance': {'type': ['number', 'null'], 'description': 'USGS significance score (0â\x80\x932000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field.'}, 'magnitude_type': {'type': 'string', 'description': 'Magnitude type (ml, mww, mw, mb, etc.).'}, 'source_catalog': {'type': 'string', '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.'}, 'event_certainty': {'enum': ['known', 'suspected', 'unknown', 'unreported'], 'type': 'string', '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 â\x80\x94 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.'}}, 'description': 'Full earthquake event detail.', 'additionalProperties': False}, 'detail': {'type': 'object', 'properties': {'dyfi': {'type': 'object', 'properties': {'map_url': {'type': 'string', 'description': 'URL of the rendered DYFI intensity map image.'}, 'max_cdi': {'type': 'number', 'description': 'Maximum Community Decimal Intensity derived from those reports (0â\x80\x9312 scale).'}, 'responses': {'type': 'number', 'description': 'Number of "Did You Feel It?" reports the public submitted.'}}, 'description': 'Felt-report summary. Absent when no DYFI product exists for the event.', 'additionalProperties': False}, 'origin': {'type': 'object', 'properties': {'review_status': {'type': 'string', 'description': 'Review state of the origin solution as the contributing network published it.'}, 'depth_error_km': {'type': 'number', 'description': 'Depth uncertainty in kilometers.'}, 'azimuthal_gap_deg': {'type': 'number', 'description': 'Largest azimuthal gap between stations, in degrees. Gaps above ~180 make the location poorly constrained.'}, 'num_stations_used': {'type': 'number', 'description': 'Number of seismic stations used in the location solution.'}, 'horizontal_error_km': {'type': 'number', 'description': 'Horizontal location uncertainty in kilometers.'}}, 'description': 'Location-quality metrics for the preferred origin.', 'additionalProperties': False}, 'shakemap': {'type': 'object', 'properties': {'max_mmi': {'type': 'number', 'description': 'Maximum modeled shaking intensity across the ShakeMap grid (Modified Mercalli).'}, 'max_pga': {'type': 'number', 'description': 'Maximum modeled peak ground acceleration, in g â\x80\x94 a fraction of standard gravity, as USGS ShakeMap publishes it (0.4 is four tenths of g).'}, 'max_pgv': {'type': 'number', 'description': 'Maximum modeled peak ground velocity, in cm/s.'}, 'intensity_map_url': {'type': 'string', 'description': 'URL of the rendered ShakeMap intensity map image.'}}, 'description': 'ShakeMap modeled ground-motion summary. Absent when no ShakeMap was produced.', 'additionalProperties': False}, 'losspager': {'type': 'object', 'properties': {'report_url': {'type': 'string', 'description': 'URL of the PAGER one-page PDF summary of estimated impact.'}, 'alert_level': {'type': 'string', 'description': 'PAGER impact alert level â\x80\x94 "green", "yellow", "orange", or "red".'}}, 'description': 'PAGER impact assessment. Estimated fatality and economic-loss brackets live in a separate content file and are not part of this response â\x80\x94 fetch report_url for them.', 'additionalProperties': False}, 'finite_fault': {'type': 'object', 'properties': {'model_url': {'type': 'string', 'description': 'URL of the finite-fault rupture model file.'}, 'rupture_width_km': {'type': 'number', 'description': 'Modeled rupture width down dip, in kilometers.'}, 'rupture_length_km': {'type': 'number', 'description': 'Modeled rupture length along strike, in kilometers.'}}, 'description': 'Finite-fault rupture model. Produced only for large events.', 'additionalProperties': False}, 'moment_tensor': {'type': 'object', 'properties': {'nodal_plane_1': {'type': 'object', 'required': ['strike', 'dip', 'rake'], 'properties': {'dip': {'type': 'number', 'description': 'Fault plane dip in degrees from horizontal (0â\x80\x9390).'}, 'rake': {'type': 'number', 'description': 'Slip direction in degrees (-180 to 180). Near 90 is reverse faulting, near -90 normal, near 0 or 180 strike-slip.'}, 'strike': {'type': 'number', 'description': 'Fault plane strike in degrees clockwise from north (0â\x80\x93360).'}}, 'description': 'First nodal plane of the focal mechanism. Either plane can be the true fault.', 'additionalProperties': False}, 'nodal_plane_2': {'type': 'object', 'required': ['strike', 'dip', 'rake'], 'properties': {'dip': {'type': 'number', 'description': 'Fault plane dip in degrees from horizontal (0â\x80\x9390).'}, 'rake': {'type': 'number', 'description': 'Slip direction in degrees (-180 to 180). Near 90 is reverse faulting, near -90 normal, near 0 or 180 strike-slip.'}, 'strike': {'type': 'number', 'description': 'Fault plane strike in degrees clockwise from north (0â\x80\x93360).'}}, 'description': 'Second nodal plane â\x80\x94 the auxiliary solution, indistinguishable from the first on seismic data alone.', 'additionalProperties': False}, 'derived_depth_km': {'type': 'number', 'description': 'Centroid depth in kilometers derived from the moment-tensor inversion.'}, 'scalar_moment_nm': {'type': 'number', 'description': 'Scalar seismic moment in newton-metres â\x80\x94 the physical size of the rupture.'}}, 'description': 'Focal-mechanism solution. Absent for events with no moment-tensor inversion.', 'additionalProperties': False}, 'ground_failure': {'type': 'object', 'properties': {'landslide_alert': {'type': 'string', 'description': 'Landslide hazard alert level â\x80\x94 "green", "yellow", "orange", or "red".'}, 'liquefaction_alert': {'type': 'string', 'description': 'Liquefaction hazard alert level â\x80\x94 "green", "yellow", "orange", or "red".'}}, 'description': 'Secondary-hazard alert levels. Absent when no ground-failure model was run.', 'additionalProperties': False}}, 'description': 'Analysis products USGS attached to this event. Absent when the event carries none â\x80\x94 that means no product was produced, not that impact was zero.', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 1000, 'minimum': 1, '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.'}, 'cursor': {'type': 'string', '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 â\x80\x94 it encodes a position in the feed snapshot and is rejected if malformed."}, 'time_window': {'enum': ['hour', 'day', 'week', 'month'], 'type': 'string', 'default': 'day', 'description': 'Time window for the feed. "hour" typically returns 0â\x80\x9310 events; "month" can exceed 10,000 for the "all" tier. Prefer "hour" or "day" for real-time status checks.'}, 'magnitude_tier': {'enum': ['all', '1.0', '2.5', '4.5', 'significant'], 'type': 'string', 'default': '2.5', 'description': 'Minimum magnitude threshold for the feed. "all" includes microseisms (M<1). "1.0" is M1.0+. "2.5" is M2.5+. "4.5" is M4.5+. "significant" is a USGS curated selection based on magnitude, felt reports, and PAGER impact estimates â\x80\x94 not purely magnitude-based.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['count', 'generated_at', 'events', 'feed_url']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'count': {'type': 'number', 'description': 'Number of events returned in this page, not the whole feed.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['feed_unavailable', 'feed_timeout'], '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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'magnitude', 'magnitude_type', 'time', 'updated', 'place', 'latitude', 'longitude', 'depth_km', 'felt', 'cdi', 'mmi', 'alert', 'tsunami', 'significance', 'status'], 'properties': {'id': {'type': 'string', 'description': 'USGS or EMSC event identifier.'}, 'cdi': {'type': ['number', 'null'], 'description': 'Maximum reported intensity (Community Decimal Intensity, 0â\x80\x9312 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field.'}, 'mmi': {'type': ['number', 'null'], 'description': 'Maximum ShakeMap instrumental intensity (Modified Mercalli, 0â\x80\x9312 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field.'}, 'auth': {'type': 'string', '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.'}, 'felt': {'type': ['number', 'null'], 'description': '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 â\x80\x94 a null is not evidence the event went unfelt.'}, 'time': {'type': 'string', 'description': 'ISO 8601 UTC origin time.'}, 'alert': {'anyOf': [{'enum': ['green', 'yellow', 'orange', 'red'], 'type': 'string'}, {'type': 'null'}], 'description': 'PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field.'}, 'place': {'type': 'string', 'description': 'Nearest named location.'}, 'title': {'type': 'string', 'description': 'Human-readable event summary, e.g. "M 6.0 - 13 km S of Honaunau-Napoopoo, Hawaii".'}, 'status': {'anyOf': [{'enum': ['automatic', 'reviewed', 'deleted'], 'type': 'string'}, {'type': 'null'}], 'description': '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 â\x80\x94 EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final.'}, 'tsunami': {'type': ['number', 'null'], 'description': 'USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning â\x80\x94 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.'}, 'updated': {'type': 'string', 'description': 'ISO 8601 UTC time this record was last updated.'}, 'depth_km': {'type': ['number', 'null'], 'description': 'Hypocenter depth in kilometers. Shallow (<70 km), intermediate (70â\x80\x93300 km), or deep (>300 km). Null for historical events where depth was not measured.'}, 'latitude': {'type': 'number', 'description': 'Epicenter latitude in decimal degrees.'}, 'event_url': {'type': 'string', 'description': 'USGS event page URL. Present for USGS events only.'}, 'longitude': {'type': 'number', 'description': 'Epicenter longitude in decimal degrees.'}, 'magnitude': {'type': ['number', 'null'], 'description': 'Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as "M ?").'}, 'detail_url': {'type': 'string', 'description': 'URL to fetch the full GeoJSON detail record. Present in USGS list responses.'}, 'event_type': {'type': 'string', 'description': 'What kind of event this is, in one vocabulary whichever source served it â\x80\x94 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.'}, 'significance': {'type': ['number', 'null'], 'description': 'USGS significance score (0â\x80\x932000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field.'}, 'magnitude_type': {'type': 'string', 'description': 'Magnitude type (ml, mww, mw, mb, etc.).'}, 'source_catalog': {'type': 'string', '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.'}, 'event_certainty': {'enum': ['known', 'suspected', 'unknown', 'unreported'], 'type': 'string', '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 â\x80\x94 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.'}}, 'description': 'A single earthquake event.', 'additionalProperties': False}, 'description': 'Earthquake events for this page, newest first.'}, 'notice': {'type': 'string', 'description': 'Recovery guidance when the feed contains no events, or how to continue when a page was capped â\x80\x94 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.'}, 'feed_url': {'type': 'string', 'description': 'Source feed URL.'}, 'truncated': {'type': 'boolean', 'description': 'True when the feed holds more events than this page returned. nextCursor carries the input for the following page.'}, 'nextCursor': {'type': 'string', '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.'}, 'totalCount': {'type': 'number', 'description': 'Number of events in the whole feed, across every page.'}, 'generated_at': {'type': 'string', 'description': 'ISO 8601 UTC timestamp when this feed was generated by USGS.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 20000, 'minimum': 1, 'description': '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.'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Index of the first event to return, counting from 1 â\x80\x94 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.'}, 'source': {'enum': ['usgs', 'emsc'], 'type': 'string', 'default': 'usgs', 'description': '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 â\x80\x94 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.'}, 'end_time': {'type': 'string', 'pattern': '^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$', 'description': 'End of time range as ISO 8601, in the same forms start_time accepts. Defaults to current time if omitted.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude for radius search. Requires longitude and radius_km.'}, 'min_felt': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Minimum number of DYFI (Did You Feel It?) reports. Use to find events with confirmed public impact. Only available from USGS.'}, 'order_by': {'enum': ['time', 'time-asc', 'magnitude', 'magnitude-asc'], 'type': 'string', 'default': 'time', 'description': 'Sort order. "time" returns newest first; "magnitude" returns largest first.'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude for radius search. Requires latitude and radius_km.'}, 'radius_km': {'type': 'number', 'maximum': 20001.6, 'minimum': 0, 'description': '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° â\x89\x88 111.2 km).'}, 'event_type': {'type': 'string', 'minLength': 1, '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.'}, 'start_time': {'type': 'string', 'pattern': '^\\d{4}(-\\d{1,2}(-\\d{1,2})?)?([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$', 'description': '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 â\x80\x94 applied server-side so USGS and EMSC honor the same window.'}, 'alert_level': {'enum': ['green', 'yellow', 'orange', 'red'], 'type': 'string', 'description': 'Minimum PAGER alert level. PAGER estimates economic loss and casualties. "green" = minimal impact; "red" = extreme. Only available from USGS.'}, 'max_depth_km': {'type': 'number', 'maximum': 1000, 'minimum': -100, 'description': 'Maximum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope.'}, 'max_latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Northern edge of a bounding-box search, in degrees.'}, 'min_depth_km': {'type': 'number', 'maximum': 1000, 'minimum': -100, 'description': 'Minimum depth in kilometers. Bounded to the documented -100 to 1000 km catalog envelope. Shallow quakes (0â\x80\x9370 km) typically cause more surface damage than deep quakes (>300 km).'}, 'min_latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Southern edge of a bounding-box search, in degrees. Independent of the other three box parameters â\x80\x94 supply any of them. Must not exceed max_latitude when both are given.'}, 'max_longitude': {'type': 'number', 'maximum': 360, 'minimum': -360, 'description': 'Eastern edge of a bounding-box search, in degrees.'}, 'max_magnitude': {'type': 'number', 'maximum': 10, 'minimum': -1, 'description': 'Maximum magnitude.'}, 'min_longitude': {'type': 'number', 'maximum': 360, 'minimum': -360, '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) â\x80\x94 always keep min_longitude at or below max_longitude rather than inverting the pair.'}, 'min_magnitude': {'type': 'number', 'maximum': 10, 'minimum': -1, 'description': 'Minimum magnitude (Richter or equivalent). M2.5+ is felt by some people; M5+ can cause damage; M7+ is major.'}, 'min_significance': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Minimum USGS significance score (0â\x80\x932000+). Combines magnitude, felt reports, and PAGER estimates. Significant events typically score 600+. Only available from USGS.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['count', 'source', 'events']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'count': {'type': 'number', 'description': 'Number of events returned.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['invalid_radius', 'invalid_bounding_box', 'source_unavailable', 'source_timeout', 'upstream_rejected', 'upstream_rejected_no_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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'magnitude', 'magnitude_type', 'time', 'updated', 'place', 'latitude', 'longitude', 'depth_km', 'felt', 'cdi', 'mmi', 'alert', 'tsunami', 'significance', 'status'], 'properties': {'id': {'type': 'string', 'description': 'USGS or EMSC event identifier.'}, 'cdi': {'type': ['number', 'null'], 'description': 'Maximum reported intensity (Community Decimal Intensity, 0â\x80\x9312 scale), derived from DYFI responses. Null when USGS computed no DYFI intensity, and always null for EMSC, which publishes no such field.'}, 'mmi': {'type': ['number', 'null'], 'description': 'Maximum ShakeMap instrumental intensity (Modified Mercalli, 0â\x80\x9312 scale). Null when USGS produced no ShakeMap for the event, and always null for EMSC, which publishes no such field.'}, 'auth': {'type': 'string', '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.'}, 'felt': {'type': ['number', 'null'], 'description': '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 â\x80\x94 a null is not evidence the event went unfelt.'}, 'time': {'type': 'string', 'description': 'ISO 8601 UTC origin time.'}, 'alert': {'anyOf': [{'enum': ['green', 'yellow', 'orange', 'red'], 'type': 'string'}, {'type': 'null'}], 'description': 'PAGER estimated impact alert level. Null when USGS ran no PAGER assessment, and always null for EMSC, which publishes no such field.'}, 'place': {'type': 'string', 'description': 'Nearest named location.'}, 'title': {'type': 'string', 'description': 'Human-readable event summary, e.g. "M 6.0 - 13 km S of Honaunau-Napoopoo, Hawaii".'}, 'status': {'anyOf': [{'enum': ['automatic', 'reviewed', 'deleted'], 'type': 'string'}, {'type': 'null'}], 'description': '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 â\x80\x94 EMSC does not, so treat an EMSC solution as unverified and subject to revision rather than final.'}, 'tsunami': {'type': ['number', 'null'], 'description': 'USGS tsunami flag: 1 for large events in oceanic regions, 0 otherwise. It is not a warning â\x80\x94 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.'}, 'updated': {'type': 'string', 'description': 'ISO 8601 UTC time this record was last updated.'}, 'depth_km': {'type': ['number', 'null'], 'description': 'Hypocenter depth in kilometers. Shallow (<70 km), intermediate (70â\x80\x93300 km), or deep (>300 km). Null for historical events where depth was not measured.'}, 'latitude': {'type': 'number', 'description': 'Epicenter latitude in decimal degrees.'}, 'event_url': {'type': 'string', 'description': 'USGS event page URL. Present for USGS events only.'}, 'longitude': {'type': 'number', 'description': 'Epicenter longitude in decimal degrees.'}, 'magnitude': {'type': ['number', 'null'], 'description': 'Preferred magnitude value. Null when no magnitude was computed for the event (the title renders it as "M ?").'}, 'detail_url': {'type': 'string', 'description': 'URL to fetch the full GeoJSON detail record. Present in USGS list responses.'}, 'event_type': {'type': 'string', 'description': 'What kind of event this is, in one vocabulary whichever source served it â\x80\x94 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.'}, 'significance': {'type': ['number', 'null'], 'description': 'USGS significance score (0â\x80\x932000+). Combines magnitude, felt reports, PAGER. Null when USGS computed no score, and always null for EMSC, which publishes no such field.'}, 'magnitude_type': {'type': 'string', 'description': 'Magnitude type (ml, mww, mw, mb, etc.).'}, 'source_catalog': {'type': 'string', '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.'}, 'event_certainty': {'enum': ['known', 'suspected', 'unknown', 'unreported'], 'type': 'string', '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 â\x80\x94 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.'}}, 'description': 'A single earthquake event.', 'additionalProperties': False}, 'description': 'Matching earthquake events.'}, 'notice': {'type': 'string', 'description': 'Recovery guidance when results are empty or capped â\x80\x94 how to broaden filters or get the full count. Absent when the result set is non-empty and within the limit.'}, 'source': {'enum': ['usgs', 'emsc'], 'type': 'string', 'description': 'Data source used.'}, 'queryEcho': {'type': 'object', 'required': ['source', 'limit', 'order_by'], 'properties': {'limit': {'type': 'number', 'description': 'Effective result limit sent upstream.'}, 'offset': {'type': 'number', 'description': '1-based paging offset sent upstream. Absent when the first page was fetched.'}, 'source': {'enum': ['usgs', 'emsc'], 'type': 'string', 'description': 'Data source queried.'}, 'end_time': {'type': 'string', 'description': 'Effective query end time. Absent when omitted from input â\x80\x94 the upstream defaults to the current time.'}, 'latitude': {'type': 'number', 'description': 'Radius-search latitude sent upstream.'}, 'min_felt': {'type': 'number', 'description': 'DYFI felt-report filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}, 'order_by': {'type': 'string', 'description': 'Sort order sent upstream.'}, 'longitude': {'type': 'number', 'description': 'Radius-search longitude sent upstream.'}, 'radius_km': {'type': 'number', 'description': 'Search radius in km sent upstream (converted to degrees for EMSC).'}, 'event_type': {'type': 'string', 'description': 'Event-type filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}, 'start_time': {'type': 'string', 'description': 'Effective query start time sent upstream â\x80\x94 server-resolved to a 30-day window when omitted from input.'}, 'alert_level': {'type': 'string', 'description': 'PAGER alert filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}, 'max_depth_km': {'type': 'number', 'description': 'Maximum depth filter sent upstream.'}, 'max_latitude': {'type': 'number', 'description': 'Northern bounding-box edge sent upstream, in degrees.'}, 'min_depth_km': {'type': 'number', 'description': 'Minimum depth filter sent upstream.'}, 'min_latitude': {'type': 'number', 'description': 'Southern bounding-box edge sent upstream, in degrees.'}, 'max_longitude': {'type': 'number', 'description': 'Eastern bounding-box edge sent upstream, in degrees.'}, 'max_magnitude': {'type': 'number', 'description': 'Maximum magnitude filter sent upstream.'}, 'min_longitude': {'type': 'number', 'description': 'Western bounding-box edge sent upstream, in degrees.'}, 'min_magnitude': {'type': 'number', 'description': 'Minimum magnitude filter sent upstream.'}, 'min_significance': {'type': 'number', 'description': 'Significance filter sent upstream. Absent for EMSC â\x80\x94 not supported there.'}}, 'description': 'Echo of the effective parameters sent to the upstream API, including server-resolved defaults. Use to diagnose unexpected or empty results â\x80\x94 a filter absent here was not sent upstream.', 'additionalProperties': False}, 'truncated': {'type': 'boolean', 'description': '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.'}, 'nextOffset': {'type': 'number', '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.'}, 'totalCount': {'type': 'number', 'description': '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 â\x80\x94 countUnavailable separates the two.'}, 'ignoredFilters': {'type': 'array', 'items': {'type': 'string', 'description': 'Name of an input filter that was not applied.'}, '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 â\x80\x94 re-run with source=usgs to apply them. Absent when every supplied filter was applied.'}, 'countUnavailable': {'type': 'boolean', '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.'}}, 'additionalProperties': False}