Capabilities
earthquake_revisions
Page through versions actually collected for a retained earthquake.
How this capability is exposed
- Stable ID
ursy.live:tool:earthquake_revisions- Owning service
- URSY.live
- Runtime
- See the source declaration
Capability declarations describe what the service exposes. They are not a guarantee of availability or permission to execute an operation.
Accepted contract
{
"id": "ursy.live:tool:earthquake_revisions",
"name": "earthquake_revisions",
"description": "Page through versions actually collected for a retained earthquake.",
"kind": "mcp_tool",
"input_schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^usgs:[a-zA-Z0-9_-]{1,80}$",
"maxLength": 85
},
"since": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"default": 0
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
}
},
"required": [
"id"
],
"additionalProperties": false
},
"output_schema": {
"allOf": [
{
"$ref": "#/$defs/Envelope"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/$defs/Changes"
}
},
"required": [
"data"
]
}
],
"type": "object",
"$defs": {
"Envelope": {
"type": "object",
"properties": {
"schema_version": {
"const": "1.1"
},
"generated_at": {
"type": "string",
"format": "date-time"
},
"data": [],
"sources": {
"type": "array",
"items": {
"$ref": "#/$defs/Source"
}
},
"access": {
"const": "public"
},
"links": {
"type": "object"
},
"sponsor": {
"$ref": "#/$defs/Sponsor"
}
},
"required": [
"schema_version",
"generated_at",
"data",
"sources",
"access"
]
},
"Source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"observed",
"forecast",
"estimated"
]
},
"url": {
"type": "string",
"format": "uri"
},
"licence": {
"type": "string"
},
"licence_url": {
"type": "string",
"format": "uri"
},
"coverage": {
"type": "string"
},
"retention": {
"type": "string"
},
"cadence_seconds": {
"type": "integer"
},
"stale_seconds": {
"type": "integer"
},
"last_success": {
"type": [
"string",
"null"
]
},
"last_attempt": {
"type": [
"string",
"null"
]
},
"last_error": {
"type": [
"string",
"null"
]
},
"collection_state": {
"type": "string",
"enum": [
"pending",
"stale",
"degraded",
"current"
]
},
"last_run": {
"type": [
"object",
"null"
]
}
},
"required": [
"id",
"name",
"kind",
"url",
"licence",
"coverage",
"retention",
"collection_state"
]
},
"Sponsor": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"month": {
"type": "string"
},
"sponsored": {
"const": true
},
"disclosure": {
"type": "string"
},
"rel": {
"type": "string"
}
},
"required": [
"message",
"name",
"url",
"sponsored",
"disclosure"
]
},
"Changes": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/Revision"
}
},
"next_cursor": {
"type": "integer"
},
"has_more": {
"type": "boolean"
},
"earliest_available": {
"type": [
"integer",
"null"
]
},
"latest_available": {
"type": [
"integer",
"null"
]
},
"retention_days": {
"const": 30
},
"scope": {
"type": "string"
}
},
"required": [
"items",
"next_cursor",
"has_more",
"retention_days"
]
},
"Revision": {
"type": "object",
"properties": {
"seq": {
"type": "integer"
},
"event_id": {
"type": "string"
},
"change_type": {
"type": "string",
"enum": [
"created",
"revised"
]
},
"source_updated_ms": {
"type": "integer"
},
"collected_at": {
"type": "string",
"format": "date-time"
},
"data": {
"$ref": "#/$defs/Event"
}
},
"required": [
"seq",
"event_id",
"change_type",
"source_updated_ms",
"collected_at",
"data"
]
},
"Event": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^usgs:[a-zA-Z0-9_-]{1,80}$"
},
"source_id": {
"type": "string"
},
"source": {
"const": "usgs"
},
"type": {
"const": "earthquake"
},
"title": {
"type": "string"
},
"magnitude": {
"type": [
"number",
"null"
]
},
"magnitude_type": {
"type": "string"
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"depth_km": {
"type": [
"number",
"null"
]
},
"observed_ms": {
"type": "integer"
},
"updated_ms": {
"type": "integer"
},
"observed_at": {
"type": "string",
"format": "date-time"
},
"source_updated_at": {
"type": "string",
"format": "date-time"
},
"status": {
"type": "string"
},
"alert": {
"type": [
"string",
"null"
]
},
"felt_reports": {
"type": [
"integer",
"null"
]
},
"source_url": {
"type": "string",
"format": "uri"
},
"url": {
"type": "string",
"format": "uri"
},
"citation_url": {
"type": "string",
"format": "uri"
},
"api_url": {
"type": "string",
"format": "uri"
},
"units": {
"type": "object"
},
"provenance": {
"type": "object"
},
"first_recorded_version_history": {
"type": "array",
"description": "Latest twenty retained versions; use the revisions endpoint for paging.",
"items": {
"type": "object"
}
}
},
"required": [
"id",
"source_id",
"source",
"type",
"title",
"magnitude",
"latitude",
"longitude",
"depth_km",
"observed_ms",
"updated_ms",
"source_url"
]
}
}
},
"read_only": true,
"auth_required": false,
"service_id": "ursy-live",
"parent_id": "",
"summary": "Page through versions actually collected for a retained earthquake.",
"source_url": "https://ursy.live/wp-json/ursy-live/v1/developer-capabilities",
"source_type": "capability_manifest",
"verified_at": "2026-10-14 06:04:18",
"revision": "14aac80afcc654bab147b136ae2afe4d3a18d838241c8e5612c9e75f38b8bfbc",
"type": "capabilities",
"source": {
"url": "https://ursy.live/wp-json/ursy-live/v1/developer-capabilities",
"type": "capability_manifest"
},
"last_verified_at": "2026-10-14 06:04:18",
"stale": false
}