Radio Browser

live Music

Search and discover internet radio stations worldwide by name, country, or genre from Radio Browser

4 tools
0ms auth
free tier 50 calls/day

Tools

search_stations required: query

Search for radio stations by name. Results are ordered by votes (popularity).

Parameters
Name Type Description
query req string Station name to search for.
limit opt number Maximum number of results to return. Defaults to 10.
Try it
get_top_stations

Get the most popular radio stations by vote count, optionally filtered by country.

Parameters
Name Type Description
count opt number Number of stations to return. Defaults to 10.
country opt string Filter by country name (e.g. "Germany", "United States"). Omit for global results.
Try it
list_countries

List countries that have radio stations, with station counts.

No parameters required.

Try it
list_tags

List the most common radio station genres and tags by station count.

Parameters
Name Type Description
limit opt number Maximum number of tags to return. Defaults to 20.
Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/radio/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/radio/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_stations","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_stations", {"query":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("search and discover internet radio stations worldwide by name, country, or genre from radio browser");

Related packs

Other Pipeworx packs in the same categories (Music):