`get_top_stations`

Pack: radio · Endpoint: https://gateway.pipeworx.io/radio/mcp

The most-listened internet radio stations right now, from the Radio Browser directory.

Tool description as the model sees it

Get trending radio stations ranked by popularity, optionally filtered by country (e.g., ‘US’, ‘GB’, ‘DE’). Returns station URLs, genres, and vote counts.

Parameters

Name	Type	Required	Description
`count`	number	no	Number of stations to return. Defaults to 10.
`country`	string	no	Filter by country name (e.g. “Germany”, “United States”). Omit for global results.

Example call

Arguments

{
  "count": 10
}

curl

curl -X POST https://gateway.pipeworx.io/radio/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_top_stations","arguments":{"count":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_top_stations', {
  "count": 10
});

More examples

{
  "count": 5,
  "country": "Germany"
}

Response shape

Always returns: count, stations

Field	Type	Description
`count`	number	Number of stations returned
`stations`	array	List of top-ranked radio stations

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of stations returned"
    },
    "stations": {
      "type": "array",
      "description": "List of top-ranked radio stations",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Station name"
          },
          "url": {
            "type": "string",
            "description": "Station stream URL (resolved or fallback)"
          },
          "country": {
            "type": "string",
            "description": "Country where station broadcasts"
          },
          "language": {
            "type": "string",
            "description": "Language of broadcast"
          },
          "tags": {
            "type": "string",
            "description": "Genres/tags associated with station"
          },
          "votes": {
            "type": "number",
            "description": "Popularity vote count"
          },
          "codec": {
            "type": "string",
            "description": "Audio codec used"
          },
          "bitrate": {
            "type": "number",
            "description": "Bitrate in kbps"
          }
        },
        "required": [
          "name",
          "url",
          "country",
          "language",
          "tags",
          "votes",
          "codec",
          "bitrate"
        ]
      }
    }
  },
  "required": [
    "count",
    "stations"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "radio": {
      "url": "https://gateway.pipeworx.io/radio/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_top_stations