RoamDial MCP server
Commit Nov 7, 2026Lets an AI client search and discover over 35,000 live radio stations globally by location, genre, mood, or current track metadata.
Also known as ddter/roamdial-mcp, roamdial
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Nov 7, 2026
- License
- MIT
What is RoamDial MCP?
RoamDial lets an AI client search and discover over 35,000 live radio stations globally by location, genre, mood, or current track metadata.
Summary generated from the project's README
About RoamDial MCP server
RoamDial provides access to over 35,000 verified live radio streams across 215 countries and territories. This MCP server allows AI clients to discover global broadcasts by searching for specific keywords, locations, genres, or languages. It is designed for developers and users who want to integrate live audio discovery into their AI workflows through tools like Claude Code, Cursor, or ChatGPT.
Users can connect via a remote HTTP transport at roamdial.com/mcp, which requires no installation or API keys. For environments that only support local processes, a lightweight stdio bridge is available via npx. The server provides structured data including direct listening URLs and 3D globe map links.
Available tools include search_stations for finding specific broadcasts, spin_globe for discovering random stations based on mood or local time, get_station for detailed profiles, and get_now_playing to retrieve live track metadata. The system supports mood-based discovery such as late_night, morning, focus, upbeat, and relax.
What you can do with it
- 1Discover stations by moodFind a random radio station that matches a specific atmosphere like focus or upbeat.
- 2Search for local broadcastsLocate live radio stations in a specific city or country using keywords.
- 3Identify current music tracksCheck the live metadata to see exactly what song is playing on a specific station.
Written from the project's README. Every use case is checked against a quote from it.
How to install RoamDial MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall RoamDial MCP in Claude Code
$ claude mcp add --transport http roamdial https://roamdial.com/mcpInstall RoamDial MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"roamdial": {
"url": "https://roamdial.com/mcp"
}
}
}Install RoamDial MCP in VS Code
.vscode/mcp.json
{
"servers": {
"roamdial": {
"type": "http",
"url": "https://roamdial.com/mcp"
}
}
}Install RoamDial MCP in VS Code CLI
$ code --add-mcp '{"name":"roamdial","type":"http","url":"https://roamdial.com/mcp"}'Install RoamDial MCP in Codex
$ codex mcp add roamdial --url https://roamdial.com/mcpInstall RoamDial MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.roamdial] url = "https://roamdial.com/mcp"
Install RoamDial MCP in Gemini CLI
$ gemini mcp add -s user --transport http roamdial https://roamdial.com/mcpInstall RoamDial MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"roamdial": {
"url": "https://roamdial.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableddter/roamdial-mcp is public and reachablegithub.com/ddter/roamdial-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/ddter/roamdial-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 65 msPass
README
View on GitHubRoamDial MCP Server — Live World Radio on a 3D Globe
RoamDial is a free, ad-free interactive 3D world radio map with 35,000+ verified live radio streams across 215 countries and territories.
This repository provides the official Model Context Protocol (MCP) integration for RoamDial:
- Direct Remote Streamable HTTP Server (
https://roamdial.com/mcp) — zero install, no API key or authentication required. - Lightweight Local
stdioBridge (npx -y github:ddter/roamdial-mcp) — zero-dependency Node.js wrapper for local-only MCP clients.
Quick Start
Option 1: Remote Streamable HTTP (Recommended — Zero Install)
Point any MCP client supporting Streamable HTTP (2025-06-18 / 2025-03-26 / 2026-07-28) directly at:
https://roamdial.com/mcp
Claude Code
claude mcp add --transport http roamdial https://roamdial.com/mcp
Cursor / VS Code / Windsurf (mcp.json)
{
"mcpServers": {
"roamdial": {
"url": "https://roamdial.com/mcp"
}
}
}
OpenAI Codex (~/.codex/config.toml)
[mcp_servers.roamdial]
url = "https://roamdial.com/mcp"
ChatGPT / Claude.ai Web Connectors
Add https://roamdial.com/mcp under Settings → Connectors (no authentication required).
Option 2: Local stdio Bridge (claude_desktop_config.json)
For MCP clients that only support local stdio processes (requires Node.js >= 18):
{
"mcpServers": {
"roamdial": {
"command": "npx",
"args": ["-y", "github:ddter/roamdial-mcp"]
}
}
}
Available MCP Tools (4 Tools)
All tools are read-only, require no authentication, and return both human-readable Markdown (content) and machine-typed JSON (structuredContent + outputSchema), including direct one-click listening URLs (listenUrl and 3D globe mapUrl).
1. search_stations
Search live radio stations across 35,000+ verified streams by keyword, country, city, genre, or language.
- Parameters:
query(string, optional): Station name, callsign, frequency, city, or keyword (e.g."BBC","Jazz","Tokyo","KEXP").country(string, optional): ISO-2 country code, country slug, or country name (e.g."JP","united-kingdom","Brazil").city(string, optional): City name filter (e.g."Paris","New York","Seoul").genre(string, optional): Genre slug or keyword (e.g."jazz","classical","news","electronic","rock","ambient").language(string, optional): Broadcast language filter (e.g."English","Japanese","French").limit(integer, optional, 1–20, default 10): Maximum stations to return.
2. spin_globe
Spin the 3D globe and land on a random live radio station, optionally constrained by country, genre, or mood/time-of-day, and probe its live ICY track title.
- Parameters:
country(string, optional): ISO-2 code, slug, or country name.genre(string, optional): Genre slug or keyword.mood(enum, optional):"late_night"— stations where local time at the broadcast city is currently 22:00–04:00"morning"— stations where local time at the broadcast city is currently 06:00–10:00"focus"— instrumental / ambient / classical / jazz / lo-fi stations"upbeat"— pop / rock / dance / electronic / latin / hip-hop stations"relax"— chill / easy listening / ambient / acoustic / smooth jazz stations
3. get_station
Get the full profile of a station by its 12-hex ID or slug-id, including broadcast location, local time, stream codec/bitrate, Wikipedia background, RoamDial listener stats, live ICY track metadata, and similar stations.
- Parameters:
stationId(string, required): 12-character hex ID (e.g."961bf53d0601") or station slug ("bbc-radio-3-961bf53d0601").
4. get_now_playing
Query the live ICY StreamTitle metadata currently broadcasting on a station (with explicit observedAt timestamp and availability reason).
- Parameters:
stationId(string, required): 12-character hex ID orslug-id.
Example Prompts to Try
- "Find me a late-night jazz radio station broadcasting live right now where it's past midnight local time, and tell me what song is playing."
- "Search for live radio stations in Tokyo or Kyoto and give me direct links to listen."
- "Spin the globe to a random morning radio show somewhere in the world."
- "What is currently playing on KEXP or BBC Radio 3?"
Additional AI & Discovery Endpoints
- 3D World Radio Map: https://roamdial.com
- RFC 9727 API Catalog: https://roamdial.com/.well-known/api-catalog
- OpenAPI 3.1 Specification (for Custom GPT Actions): https://roamdial.com/openapi.json
- LLMs Summary (
llms.txt): https://roamdial.com/llms.txt - LLMs Full Curated Catalog (
llms-full.txt): https://roamdial.com/llms-full.txt
License
RoamDial MCP questions
How do I add RoamDial MCP to Claude Code?
Run claude mcp add --transport http roamdial https://roamdial.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add RoamDial MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an API key to use RoamDial?
No, the server requires no authentication or API key for use.
How many radio stations are available?
The service provides access to over 35,000 verified live radio streams.
Can I search for stations by mood?
Yes, you can use the spin_globe tool to find stations based on moods like late_night, morning, focus, upbeat, or relax.