Model Context Protocol
Radioguide dla asystentów AI (MCP)
Połącz Claude, ChatGPT lub dowolnego klienta MCP z Radioguide.fm: stacje, co teraz gra, utwory na antenie i listy przebojów.
Ten adres jest dla aplikacji AI, nie dla przeglądarki. Dodaj go jako łącznik w swoim asystencie:
https://www.radioguide.fm/mcp
Claude
W Claude (web lub desktop): Ustawienia, Łączniki, Dodaj własny łącznik. Nazwa: 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_..."
Plik konfiguracyjny Claude Desktop (claude_desktop_config.json) z Twoim kluczem 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
W ChatGPT: Ustawienia, Aplikacje i łączniki, Ustawienia zaawansowane: włącz tryb dewelopera. Następnie utwórz łącznik z tym adresem, bez uwierzytelniania:
https://www.radioguide.fm/mcp
W ChatGPT pojawiają się karty stacji z przyciskiem odtwarzania (beta).
Własny GPT z Actions: zaimportuj schemat z tego adresu i wybierz API key, Bearer, jako uwierzytelnianie:
https://www.radioguide.fm/api/openapi.json?profile=gpt
Inni klienci MCP
Działa każdy klient z transportem Streamable HTTP: wysyłaj wiadomości JSON-RPC metodą POST na ten adres. Przykład:
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"}}}'
Klienci, którzy nie mogą wysyłać nagłówków, dodają klucz do adresu: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Użyj do tego osobnego klucza.
Bez klucza: 20 wywołań narzędzi na minutę i 300 dziennie na sieć, do 5 wyników na odpowiedź. Z kluczem API każde wywołanie liczy się jako jedno wywołanie API Twojego pakietu.
Asystenci muszą podawać Radioguide.fm jako źródło i linkować do wymienionych stron stacji. Każdy wynik zawiera link i informację o źródle.
Narzędzia
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).