Capabilities
get_planetary_kp
Read estimated planetary Kp, not a local aurora-visibility probability.
How this capability is exposed
- Stable ID
ursy.live:tool:get_planetary_kp- 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:get_planetary_kp",
"name": "get_planetary_kp",
"description": "Read estimated planetary Kp, not a local aurora-visibility probability.",
"kind": "mcp_tool",
"input_schema": {
"type": "object",
"properties": {
"from": {
"type": "string",
"format": "date-time",
"maxLength": 30,
"description": "RFC 3339 with seconds and a timezone; returned timestamps use UTC."
},
"to": {
"type": "string",
"format": "date-time",
"maxLength": 30,
"description": "RFC 3339 with seconds and a timezone; returned timestamps use UTC."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 100
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 20000,
"default": 0
}
},
"required": [],
"additionalProperties": false
},
"output_schema": {
"allOf": [
{
"$ref": "#/$defs/Envelope"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/$defs/Series"
}
},
"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"
]
},
"Series": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"available",
"pending",
"stale"
]
},
"snapshot": {
"anyOf": [
{
"$ref": "#/$defs/Snapshot"
},
{
"type": "null"
}
]
},
"points": {
"type": "array",
"items": {
"oneOf": [
{
"$ref": "#/$defs/ForecastPoint"
},
{
"$ref": "#/$defs/KpPoint"
}
]
}
},
"total": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"type": [
"integer",
"null"
]
},
"units": {
"type": "object"
},
"time_semantics": {
"type": "string"
}
},
"required": [
"state",
"snapshot",
"points",
"total",
"has_more"
]
},
"Snapshot": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"source": {
"type": "string"
},
"issued_at": {
"type": [
"string",
"null"
]
},
"collected_at": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"stale": {
"type": "boolean"
},
"data": {
"type": "object"
}
},
"required": [
"id",
"source",
"issued_at",
"collected_at",
"expires_at",
"stale",
"data"
]
},
"ForecastPoint": {
"type": "object",
"properties": {
"time": {
"type": "string",
"format": "date-time"
},
"temperature_c": {
"type": "number"
},
"wind_ms": {
"type": [
"number",
"null"
]
},
"cloud_percent": {
"type": [
"number",
"null"
]
},
"precipitation_mm_1h": {
"type": [
"number",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
}
},
"required": [
"time",
"temperature_c",
"wind_ms",
"cloud_percent",
"precipitation_mm_1h",
"symbol"
]
},
"KpPoint": {
"type": "object",
"properties": {
"time": {
"type": "string",
"format": "date-time"
},
"kp": {
"type": "number",
"minimum": 0,
"maximum": 9
}
},
"required": [
"time",
"kp"
]
}
}
},
"read_only": true,
"auth_required": false,
"service_id": "ursy-live",
"parent_id": "",
"summary": "Read estimated planetary Kp, not a local aurora-visibility probability.",
"source_url": "https://ursy.live/wp-json/ursy-live/v1/developer-capabilities",
"source_type": "capability_manifest",
"verified_at": "2026-10-14 06:33:55",
"revision": "8b18292acdd0a08d9c71b24e1cc45c6f7a375f8281efcf5656aeb52bc6036afa",
"type": "capabilities",
"source": {
"url": "https://ursy.live/wp-json/ursy-live/v1/developer-capabilities",
"type": "capability_manifest"
},
"last_verified_at": "2026-10-14 06:33:55",
"stale": false
}