Radioguide for AI assistants (MCP)

Claude

In Claude (web or desktop): Settings, Connectors, Add custom connector. 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_..."

Claude Desktop config file (claude_desktop_config.json), with your API key:

{
    "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: Settings, Apps and Connectors, Advanced settings: turn on developer mode. Then create a connector with this URL and no authentication:

https://www.radioguide.fm/mcp

Station cards with a play button appear in ChatGPT (beta).

Custom GPT with Actions: import the schema from this URL and choose API key, Bearer, as authentication:

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

Other MCP clients

Any client with the Streamable HTTP transport works: send JSON-RPC messages with POST to the URL. Example:

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 that cannot send headers can add the key to the URL: https://www.radioguide.fm/mcp?api_key=YOUR_KEY. Use a separate key for this.