Model Context Protocol

Radioguide pentru asistenți AI (MCP)

Conectează Claude, ChatGPT sau orice client MCP la Radioguide.fm: posturi, ce se difuzează acum, melodii în eter și topuri radio.

Această adresă este pentru aplicații AI, nu pentru browser. Adaug-o ca conector în asistentul tău:

https://www.radioguide.fm/mcp

Claude

În Claude (web sau desktop): Setări, Conectori, Adaugă conector personalizat. Nume: Radioguide. Adresă:

https://www.radioguide.fm/mcp

Claude Code:

claude mcp add --transport http radioguide https://www.radioguide.fm/mcp --header "Authorization: Bearer rg_live_..."

Fișierul de configurare Claude Desktop (claude_desktop_config.json), cu cheia ta API:

{
    "mcpServers": {
        "radioguide": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://www.radioguide.fm/mcp",
                "--header",
                "Authorization:${RADIOGUIDE_AUTH}"
            ],
            "env": {
                "RADIOGUIDE_AUTH": "Bearer rg_live_..."
            }
        }
    }
}

ChatGPT

În ChatGPT: Setări, Aplicații și conectori, Setări avansate: activează modul dezvoltator. Apoi creează un conector cu această adresă, fără autentificare:

https://www.radioguide.fm/mcp

În ChatGPT apar carduri de posturi cu buton de redare (beta).

GPT personalizat cu Actions: importă schema de la această adresă și alege API key, Bearer, ca autentificare:

https://www.radioguide.fm/api/openapi.json?profile=gpt

Alți clienți MCP

Funcționează orice client cu transport Streamable HTTP: trimite mesaje JSON-RPC prin POST la această adresă. Exemplu:

curl -s https://www.radioguide.fm/mcp -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0"}}}'

curl -s https://www.radioguide.fm/mcp -H "Content-Type: application/json" \
  -H "Authorization: Bearer rg_live_..." \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_stations","arguments":{"genre":"jazz","country":"FR"}}}'

Clienții care nu pot trimite antete adaugă cheia în adresă: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Folosește o cheie separată pentru asta.

Limite și atribuire

Fără cheie: 20 apeluri de instrumente pe minut și 300 pe zi pentru fiecare rețea, cu cel mult 5 rezultate pe răspuns. Cu o cheie API, fiecare apel contează ca un apel API din pachetul tău.

Asistenții trebuie să menționeze Radioguide.fm ca sursă și să trimită către paginile posturilor pe care le menționează. Fiecare rezultat conține linkul și mențiunea sursei.

Instrumente

`search_stations`

Find radio stations on Radioguide.fm by name or keyword, optionally filtered by country, genre and broadcast language. Returns stations with their Radioguide page URL, genres, country, logo and whether the stream works. Use recommend_stations for mood-based suggestions.

`get_station`

Facts about one radio station: country, city, genres, languages, website, stream status, description, most played songs this week, similar stations and the Radioguide page where people can listen live.

`now_playing`

The song a radio station is playing right now (from its stream metadata) and the songs before it, with links to the song pages on Radioguide.fm.

`find_song_on_air`

Find radio stations that are playing an artist (and optionally a specific song) right now or played it in the last 3 hours, from the now-playing data of thousands of stations. Falls back to the stations that play the artist most.

`charts`

Most played songs or artists on the radio stations Radioguide follows, worldwide or per country and genre, over the last 1-30 days.

`recommend_stations`

Suggest radio stations for a mood (relax, party, focus, workout, throwback, news), genre, country or language, or stations like one the listener already likes. Set no_talk to leave out news and talk stations.

`radioguide_channels`

Radioguide's own themed radio channels with new music from independent artists, and the track playing on each channel now.

`song_at_time`

Which song a radio station was playing at a given moment ("what song was on Radio 538 at 14:05 yesterday?"), with the songs 10 minutes before and after it and a link to that day's playlist on Radioguide.fm. Works for today and earlier days (archived playlists).

`get_listen_link`

Link where the listener can play a station right now: the Radioguide station page (always), and for clients with a Radioguide API key a direct stream link (signed, valid for a limited time).

API Radioguide Obține o cheie API Parteneri AI și de date