lautfm-mcp

An MCP server that provides access to the laut.fm Radioadmin API.

Requirements

• Node.js 18 or later
• A valid laut.fm Radioadmin API token

Setup

1. Install dependencies

npm install

2. Build

npm run build

3. Configure your MCP client

Add the server to your MCP client configuration (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "lautfm": {
      "command": "node",
      "args": ["/absolute/path/to/lautfm-mcp/dist/index.js"],
      "env": {
        "LAUTFM_TOKEN": "your-radioadmin-api-token-here"
      }
    }
  }
}

Generate a token by calling https://radioadmin.laut.fm/login?callback_url=LautfmMCP

Environment Variables

Authentication & Origin

Every request to the Radioadmin API is sent with:

• Authorization: Bearer <LAUTFM_TOKEN>
• Origin: LautfmMCP

Available Tools

General

Station

Users

Playlists

Schedule

Tracks

Live

Automation Algorithms

Excluded Endpoints

The following API endpoints are not exposed as MCP tools because they involve binary data transfer which is not suitable for the MCP text protocol:

• POST /stations/{station_id}/tracks — MP3 file upload
• PUT /stations/{station_id}/images/{image_type} — Image upload (logo, website, background)
• GET /stations/{station_id}/tracks/{track_id}/prelisten — Returns audio/mpeg binary stream

Additionally, all App-tagged endpoints (which use Firebase JWT authentication) are excluded as they serve a different use case.

Development

# Watch mode (recompiles on change)
npm run dev

# Build once
npm run build

# Run directly (requires LAUTFM_TOKEN to be set)
LAUTFM_TOKEN=your-token node dist/index.js

Project Structure

src/
├── index.ts          # MCP server entry point
├── client.ts         # HTTP client with auth + Origin header
└── tools/
    ├── general.ts    # General tools (server status)
    ├── stations.ts   # Station tools
    ├── users.ts      # User management tools
    ├── playlists.ts  # Playlist tools
    ├── schedule.ts   # Schedule tools
    ├── tracks.ts     # Track tools
    ├── live.ts       # Live streaming tools
    └── automation.ts # Automation algorithm tools