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.
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).
API de Radioguide Obtener una clave API Socios de IA y datos