Model Context Protocol

Radioguide für KI-Assistenten (MCP)

Verbinde Claude, ChatGPT oder einen anderen MCP-Client mit Radioguide.fm: Sender, aktuelle Titel, Songs im Radio und Radiocharts.

Diese Adresse ist für KI-Apps, nicht für deinen Browser. Füge sie als Connector in deinem Assistenten hinzu:

https://www.radioguide.fm/mcp

Claude

In Claude (Web oder Desktop): Einstellungen, Connectors, Benutzerdefinierten Connector hinzufügen. Name: 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_..."

Konfigurationsdatei von Claude Desktop (claude_desktop_config.json) mit deinem API-Schlüssel:

{
    "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: Einstellungen, Apps und Connectors, Erweiterte Einstellungen: Entwicklermodus einschalten. Dann einen Connector mit dieser URL und ohne Authentifizierung anlegen:

https://www.radioguide.fm/mcp

In ChatGPT erscheinen Senderkarten mit Play-Button (Beta).

Eigenes GPT mit Actions: Schema von dieser URL importieren und als Authentifizierung API key, Bearer wählen:

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

Andere MCP-Clients

Jeder Client mit dem Streamable-HTTP-Transport funktioniert: Sende JSON-RPC-Nachrichten per POST an die URL. Beispiel:

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 keine Header senden können, hängen den Schlüssel an die URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Verwende dafür einen eigenen Schlüssel.

Limits und Quellenangabe

Ohne Schlüssel: 20 Tool-Aufrufe pro Minute und 300 pro Tag pro Netzwerk, mit bis zu 5 Ergebnissen pro Antwort. Mit API-Schlüssel zählt jeder Tool-Aufruf als ein API-Call deines Pakets.

Assistenten müssen Radioguide.fm als Quelle nennen und auf die genannten Senderseiten verlinken. Jedes Tool-Ergebnis enthält den Link und den Quellenhinweis.

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

Radioguide API API-Schlüssel holen KI- und Datenpartner