`search_stations`

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

Internet radio stations matching a name or tag search, from the Radio Browser directory.

Tool description as the model sees it

Search radio stations by name. Returns station name, URL, country, genres, and popularity vote count. Use when looking for a specific station or browsing by keyword.

Parameters

Name	Type	Required	Description
`query`	string	yes	Station name to search for.
`limit`	number	no	Maximum number of results to return. Defaults to 10.

Example call

Arguments

{
  "query": "BBC Radio 1"
}

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":"search_stations","arguments":{"query":"BBC Radio 1"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_stations', {
  "query": "BBC Radio 1"
});

More examples

{
  "query": "jazz",
  "limit": 5
}

Response shape

Always returns: count, stations

Field	Type	Description
`count`	number	Number of stations returned
`stations`	array	List of radio stations matching the query

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of stations returned"
    },
    "stations": {
      "type": "array",
      "description": "List of radio stations matching the query",
      "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.

search_stations