Model Context Protocol
Radioguide voor AI-assistenten (MCP)
Verbind Claude, ChatGPT of een andere MCP-client met Radioguide.fm: zenders, wat er nu speelt, nummers op de radio en hitlijsten.
Dit adres is voor AI-apps, niet voor je browser. Voeg het toe als connector in je assistent:
https://www.radioguide.fm/mcp
Claude
In Claude (web of desktop): Instellingen, Connectors, Aangepaste connector toevoegen. Naam: 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_..."
Configuratiebestand van Claude Desktop (claude_desktop_config.json), met je API-sleutel:
{
"mcpServers": {
"radioguide": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.radioguide.fm/mcp",
"--header",
"Authorization:${RADIOGUIDE_AUTH}"
],
"env": {
"RADIOGUIDE_AUTH": "Bearer rg_live_..."
}
}
}
}
ChatGPT
In ChatGPT: Instellingen, Apps en connectors, Geavanceerde instellingen: zet de ontwikkelaarsmodus aan. Maak dan een connector met deze URL en zonder authenticatie:
https://www.radioguide.fm/mcp
In ChatGPT verschijnen zenderkaarten met een afspeelknop (bèta).
Eigen GPT met Actions: importeer het schema van deze URL en kies API key, Bearer, als authenticatie:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Andere MCP-clients
Elke client met het Streamable HTTP-transport werkt: stuur JSON-RPC-berichten met POST naar de URL. Voorbeeld:
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"}}}'
Clients die geen headers kunnen sturen, zetten de sleutel in de URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Gebruik hier een aparte sleutel voor.
Zonder sleutel: 20 toolaanroepen per minuut en 300 per dag per netwerk, met maximaal 5 resultaten per antwoord. Met een API-sleutel telt elke toolaanroep als één API-call van je pakket.
Assistenten moeten Radioguide.fm als bron noemen en linken naar de zenderpagina’s die ze noemen. Elk toolresultaat bevat de link en de bronvermelding.
Tools
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).
