Get the track currently playing on a radio station.

Args:
    station_name: Station name, e.g. "Smooth FM Sydney" or "smooth 95.3".
    timeout: Seconds for directory + stream reads; clamped to 1-60, and
        shared as an overall deadline across all candidates tried.

Returns:
    Dict with artist, title, raw_title, station_matched, country and
    stream_url (track fields null when the station is reachable but
    sending no track titles right now). Raises (as an MCP error) when
    nothing is found.

Search the Radio Browser directory for stations matching a name.

Args:
    query: Free-text station name, e.g. "smooth sydney".
    limit: Max results; clamped to 1-20.

Returns:
    List of station dicts with name, stream URL, codec, bitrate, country.

Advanced station search with field filters (GET /json/stations/search).

At least one of name/country/countrycode/state/language/tag/codec is required.
The *_exact flags switch that field to exact matching.

List stations in the directory (GET /json/stations). Paginate with offset/limit.

Get one station by its stationuuid (GET /json/stations/byuuid/{uuid}).

Find stations by name (GET /json/stations/byname[/exact]/{name}).

Find stations by country, e.g. "Australia" (GET /json/stations/bycountry[/exact]/{country}).

Find stations by ISO 3166-1 country code, e.g. "AU" (GET /json/stations/bycountrycodeexact/{code}).

Find stations by state/region (GET /json/stations/bystate[/exact]/{state}).

Find stations by broadcast language, e.g. "english" (GET /json/stations/bylanguage[/exact]/{language}).

Find stations by tag/genre, e.g. "chill" (GET /json/stations/bytag[/exact]/{tag}).

Find stations by stream codec, e.g. "MP3" (GET /json/stations/bycodec[/exact]/{codec}).

Highest-voted stations (GET /json/stations/topvote/{count}).

Most-clicked stations (GET /json/stations/topclick/{count}).

Most recently clicked stations (GET /json/stations/lastclick/{count}).

Most recently changed/added stations (GET /json/stations/lastchange/{count}).

Automated stream-check history for a station (GET /json/checks).

Args:
    station_uuid: Station uuid.
    seconds: Only checks newer than this many seconds. The API ignores
        `limit` here (verified live), so use `seconds` to bound the
        response — e.g. 86400 for the last day. Defaults to 0, which
        returns the FULL history (can be thousands of entries).

Register a click (listen) for a station (GET /json/click/{uuid}).

NOTE: increments the station's public click counter. Returns the station record.

Vote for a station (GET /json/vote/{uuid}). NOTE: increments the public vote counter.

Get the current stream URL for a station (GET /json/url/{uuid}). Also counts as a click.

Submit a new station to the directory (POST /json/add). Only name + url are required.

Countries in the directory with station counts (GET /json/countries).

ISO 3166-1 country codes in the directory with station counts (GET /json/countrycodes).

Stream codecs with station counts (GET /json/codecs[/{filter}]).

States/regions with station counts (GET /json/states[/{country}]).

Country must be the exact directory name, e.g. "Australia".

Broadcast languages with station counts (GET /json/languages[/{filter}]).

Tags/genres with station counts (GET /json/tags[/{filter}]).

Directory server statistics (GET /json/stats): station counts, checks, clicks, etc.

Known directory mirror servers (GET /json/servers).