Model Context Protocol

Radioguide para assistentes de IA (MCP)

Conecte o Claude, o ChatGPT ou qualquer cliente MCP ao Radioguide.fm: rádios, o que está tocando, músicas no ar e rankings de rádio.

Este endereço é para apps de IA, não para o seu navegador. Adicione-o como conector no seu assistente:

https://www.radioguide.fm/mcp

Claude

No Claude (web ou desktop): Configurações, Conectores, Adicionar conector personalizado. Nome: 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_..."

Arquivo de configuração do Claude Desktop (claude_desktop_config.json), com a sua chave 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

No ChatGPT: Configurações, Apps e conectores, Configurações avançadas: ative o modo de programador. Depois crie um conector com este URL e sem autenticação:

https://www.radioguide.fm/mcp

No ChatGPT aparecem cartões de rádios com botão de reprodução (beta).

GPT personalizado com Actions: importe o esquema deste URL e escolha API key, Bearer, como autenticação:

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

Outros clientes MCP

Funciona qualquer cliente com o transporte Streamable HTTP: envie mensagens JSON-RPC por POST para o URL. Exemplo:

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

Os clientes que não conseguem enviar cabeçalhos juntam a chave ao URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Use uma chave separada para isso.

Limites e atribuição

Sem chave: 20 chamadas de ferramentas por minuto e 300 por dia por rede, com até 5 resultados por resposta. Com uma chave API, cada chamada conta como uma chamada API do seu plano.

Os assistentes devem indicar o Radioguide.fm como fonte e incluir links para as páginas das rádios que mencionam. Cada resultado de ferramenta contém o link e a menção da fonte.

Ferramentas

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

API do Radioguide Obter uma chave API Parceiros de IA e dados