Model Context Protocol

Radioguide for AI-assistenter (MCP)

Koble Claude, ChatGPT eller en annen MCP-klient til Radioguide.fm: stasjoner, hva som spilles nå, sanger på lufta og hitlister.

Denne adressen er for AI-apper, ikke for nettleseren din. Legg den til som kobling i assistenten din:

https://www.radioguide.fm/mcp

Claude

I Claude (nett eller skrivebord): Innstillinger, Koblinger, Legg til egendefinert kobling. Navn: Radioguide. Adresse:

https://www.radioguide.fm/mcp

Claude Code:

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

Konfigurasjonsfil for Claude Desktop (claude_desktop_config.json) med API-nøkkelen din:

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

ChatGPT

I ChatGPT: Innstillinger, Apper og koblinger, Avanserte innstillinger: slå på utviklermodus. Opprett deretter en kobling med denne adressen og uten autentisering:

https://www.radioguide.fm/mcp

I ChatGPT vises stasjonskort med en avspillingsknapp (beta).

Egen GPT med Actions: importer skjemaet fra denne adressen og velg API key, Bearer, som autentisering:

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

Andre MCP-klienter

Alle klienter med Streamable HTTP-transport fungerer: send JSON-RPC-meldinger med POST til adressen. Eksempel:

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

Klienter som ikke kan sende headere, legger nøkkelen i adressen: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Bruk en egen nøkkel til dette.

Grenser og kildehenvisning

Uten nøkkel: 20 verktøykall per minutt og 300 per dag per nettverk, med opptil 5 resultater per svar. Med en API-nøkkel teller hvert verktøykall som ett API-kall i pakken din.

Assistenter må oppgi Radioguide.fm som kilde og lenke til stasjonssidene de nevner. Hvert verktøyresultat inneholder lenken og kildehenvisningen.

Verktøy

`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 Få en API-nøkkel AI- og datapartnere