Aller au contenu
Global sound

Model Context Protocol

Radioguide pour les assistants IA (MCP)

Connectez Claude, ChatGPT ou tout client MCP à Radioguide.fm : stations, titres en cours, chansons diffusées et classements radio.

Cette adresse est destinée aux applications d’IA, pas à votre navigateur. Ajoutez-la comme connecteur dans votre assistant :

https://www.radioguide.fm/mcp

Claude

Dans Claude (web ou bureau) : Paramètres, Connecteurs, Ajouter un connecteur personnalisé. Nom : Radioguide. URL :

https://www.radioguide.fm/mcp

Claude Code :

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

Fichier de configuration de Claude Desktop (claude_desktop_config.json), avec votre clé 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

Dans ChatGPT : Paramètres, Applications et connecteurs, Paramètres avancés : activez le mode développeur. Créez ensuite un connecteur avec cette URL, sans authentification :

https://www.radioguide.fm/mcp

Des fiches de stations avec un bouton de lecture apparaissent dans ChatGPT (bêta).

GPT personnalisé avec Actions : importez le schéma depuis cette URL et choisissez API key, Bearer, comme authentification :

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

Autres clients MCP

Tout client avec le transport Streamable HTTP fonctionne : envoyez des messages JSON-RPC en POST à l’URL. Exemple :

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"}}}'

Les clients qui ne peuvent pas envoyer d’en-têtes ajoutent la clé à l’URL : https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Utilisez une clé distincte pour cela.

Limites et attribution

Sans clé : 20 appels d’outil par minute et 300 par jour par réseau, avec jusqu’à 5 résultats par réponse. Avec une clé API, chaque appel d’outil compte comme un appel API de votre offre.

Les assistants doivent citer Radioguide.fm comme source et renvoyer vers les pages des stations mentionnées. Chaque résultat contient le lien et la mention de la source.

Outils

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).

Radio SoftContinuer l’écoute