Saltar al contenido
Global sound

Model Context Protocol

Radioguide para asistentes de IA (MCP)

Conecta Claude, ChatGPT o cualquier cliente MCP con Radioguide.fm: emisoras, lo que suena ahora, canciones en antena y listas de éxitos.

Esta dirección es para apps de IA, no para tu navegador. Añádela como conector en tu asistente:

https://www.radioguide.fm/mcp

Claude

En Claude (web o escritorio): Configuración, Conectores, Añadir conector personalizado. Nombre: 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_..."

Archivo de configuración de Claude Desktop (claude_desktop_config.json), con tu clave 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

En ChatGPT: Configuración, Aplicaciones y conectores, Configuración avanzada: activa el modo desarrollador. Después crea un conector con esta URL y sin autenticación:

https://www.radioguide.fm/mcp

En ChatGPT aparecen fichas de emisoras con botón de reproducción (beta).

GPT personalizado con Actions: importa el esquema desde esta URL y elige API key, Bearer, como autenticación:

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

Otros clientes MCP

Funciona cualquier cliente con el transporte Streamable HTTP: envía mensajes JSON-RPC con POST a la URL. Ejemplo:

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

Los clientes que no pueden enviar cabeceras añaden la clave a la URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Usa una clave aparte para esto.

Límites y atribución

Sin clave: 20 llamadas a herramientas por minuto y 300 al día por red, con hasta 5 resultados por respuesta. Con una clave API, cada llamada cuenta como una llamada API de tu plan.

Los asistentes deben citar Radioguide.fm como fuente y enlazar a las páginas de las emisoras que mencionan. Cada resultado incluye el enlace y el crédito.

Herramientas

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

Radio SoftSeguir escuchando