Capabilities
Station Describe
This API does not stream third-party radio audio. Public metadata for worldwide station discovery. The public catalogue does not determine what URSY can directly play. Source provenance and station country are distinct from rights and listener territory.
How this capability is exposed
- Stable ID
ursy.fm:station-describe- Owning service
- URSY.fm
- 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.fm:station-describe",
"description": "This API does not stream third-party radio audio. Public metadata for worldwide station discovery. The public catalogue does not determine what URSY can directly play. Source provenance and station country are distinct from rights and listener territory.",
"operationId": "getStation",
"rest": {
"method": "GET",
"path": "/stations/{id}"
},
"mcp_tool": "get_station",
"input_schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^stn_[a-z0-9]{16,64}$"
}
},
"additionalProperties": false,
"required": [
"id"
]
},
"output_schema": {
"type": "object",
"required": [
"schema",
"id",
"name",
"station_country",
"official",
"playback"
],
"properties": {
"schema": {
"const": "ursy.fm/station/v3"
},
"id": {
"type": "string",
"pattern": "^stn_[a-z0-9]{16,64}$"
},
"name": {
"type": "string"
},
"station_country": {
"type": [
"string",
"null"
]
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"official": {
"type": "object",
"properties": {
"homepage": {
"type": [
"string",
"null"
]
},
"player_url": {
"type": [
"string",
"null"
]
}
}
},
"playback": {
"type": "object",
"required": [
"evaluation_required",
"audio_hosted_by_ursy",
"audio_proxied_by_ursy"
],
"properties": {
"evaluation_required": {
"const": true
},
"audio_hosted_by_ursy": {
"const": false
},
"audio_proxied_by_ursy": {
"const": false
}
}
}
}
},
"service_id": "ursy-fm",
"parent_id": "",
"name": "Station Describe",
"summary": "This API does not stream third-party radio audio. Public metadata for worldwide station discovery. The public catalogue does not determine what URSY can directly play. Source provenance and station country are distinct from rights and listener territory.",
"source_url": "https://ursy.fm/.well-known/ursy-capabilities.json",
"source_type": "capability_manifest",
"verified_at": "2026-10-14 07:03:16",
"revision": "8bcc41150a796c7ef0ade57a0be4d801c413ece79015ab6c368e29da4c9affec",
"type": "capabilities",
"source": {
"url": "https://ursy.fm/.well-known/ursy-capabilities.json",
"type": "capability_manifest"
},
"last_verified_at": "2026-10-14 07:03:16",
"stale": false
}