Internet Radio
Search internet radio stations and get direct stream URLs from the Radio Browser directory
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.4
- Listing updated
- today
Similar MCP servers
About Internet Radio
Internet Radio is an open-source MCP server for tv and radio guides. It runs locally on your machine and is started by your AI client.
Station data comes from Radio Browser, a community-maintained, public-domain directory the README says holds over 50,000 stations with working streams. The server was built by 72FM, a web radio player on the same directory, so every result carries a listen_url that plays the station in the browser on 72FM, alongside the station's own stream_url. Stations belong to their broadcasters, and because anyone can edit the directory a stream may sometimes be offline.
Five read-only tools cover the ground: search_stations by name, genre tag, country code or language, ordered by votes or clicks; get_station by id; top_stations by votes, clicks or trending; list_countries with station counts; and list_genres. A find_radio prompt turns a mood or place into a search. Stations whose streams failed the directory's last automated check are left out.
Because directory fields are editable by anyone, the README describes treating every field as untrusted: text is flattened to one line, invisible Unicode is stripped, URLs must be plain http or https, and replies are capped at 5 MB. It says this reduces but cannot eliminate prompt-injection risk. No API key or account is needed, and it runs over stdio from npm or a container image.
Install
Run in a terminal
claude mcp add internet-radio-mcp -- npx -y internet-radio-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"internet-radio-mcp": {
"command": "npx",
"args": [
"-y",
"internet-radio-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"internet-radio-mcp": {
"command": "npx",
"args": [
"-y",
"internet-radio-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"internet-radio-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"internet-radio-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"internet-radio-mcp": {
"command": "npx",
"args": [
"-y",
"internet-radio-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"internet-radio-mcp": {
"command": "npx",
"args": [
"-y",
"internet-radio-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- search_stations
- Searches stations by name, genre, country or language.
- get_station
- Returns one station by id.
- top_stations
- Lists most voted, most played or trending stations.
- list_countries
- Lists countries with station counts.
- list_genres
- Lists top genre tags by station count.
What it does
- Station search
- Filter by name, genre tag, country code or language and order by votes or plays.
- Direct stream URLs
- Each result includes the station's stream URL and a browser listen link.
- Top and trending lists
- Rank stations by votes, clicks or trending, optionally by country or genre.
- Country and genre lists
- List countries with station counts and the most common genre tags.
- find_radio prompt
- Turns a mood, place or activity into a station search.
- Sanitised output
- Directory text and URLs are cleaned before reaching the assistant.
- No account needed
- Read-only, runs via npx or Docker with no key.
Good for
- Find jazz stations in a given country
- Get the stream URL for a named broadcaster
- See what is trending on internet radio
- Discover which genres to search before picking lofi stations
- Compare countries by number of stations
Pricing
Open source
Free and open source; no API key
Internet Radio FAQ
Do I need an API key?
No. There is no key or account, and all tools are read-only.
Where does the station data come from?
Radio Browser, a public-domain community directory with over 50,000 stations with working streams.
Can a stream be offline?
Occasionally. Anyone can edit the directory, though streams that failed the last automated check are excluded.
How do I run it?
npx -y internet-radio-mcp with Node.js 20 or newer, or the ghcr.io container image.
Is the data safe to pass to a model?
The server sanitises fields, but the README says it reduces injection risk rather than removing it.
Is Internet Radio free?
Yes. Internet Radio is open source, so you can use and self-host it for free.
How do I add Internet Radio to Claude Code?
Run this command in your terminal: claude mcp add internet-radio-mcp -- npx -y internet-radio-mcp
What are the best alternatives to Internet Radio?
The closest alternatives to Internet Radio are Dostuff, Sf Recpark, Edmtrain, Skiddle and Nyc Parks.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
