Sveriges.Radio

This MCP server exposes Sveriges Radio data through a set of tools and endpoints that you can query with your preferred MCP client. It provides live radio status, channel information, schedules, news, traffic, and extensive music-related data such as current songs, playlists, and episode details for SR programs. You’ll find tools grouped under four main use cases: live content, music and playlists, podcasts and programs, and traffic. Use the tools to fetch real-time “what’s on now” data, retrieve channel schedules, explore past playlists, search podcasts, and get upcoming broadcasts. The server follows the MCP 2025-03-26 spec and serves responses in JSON-RPC format over a public endpoint when hosted remotely.

To connect from Claude, Claude Code, Cursor, or other MCP clients, point them to the MCP endpoint (for remote hosting: https://sverigesradio-mcp.onrender.com/mcp). You can also run the server locally or via npx as described below. The client will discover a set of tools such as get_all_rightnow, get_channel_rightnow, list_channels, get_channel_schedule, list_news_programs, get_latest_news_episodes, get_traffic_messages, get_traffic_areas, get_playlist_rightnow, get_channel_playlist, get_program_playlist, get_episode_playlist, search_programs, get_program, list_program_categories, get_program_schedule, list_podfiles, get_podfile, list_episodes, search_episodes, get_episode, get_latest_episode, and get_program_broadcasts, depending on the data domain you’re querying.

Typical usage involves selecting a domain (live, music, podcasts, traffic), invoking a relevant tool with parameters (e.g., channel name, program, or area), and handling the JSON-RPC response returned by the MCP endpoint.

Prerequisites:

• Node.js and npm installed on your system
• Git to clone the repository (optional if using npm package)

Option A - Remote/NPM-based usage (no local installation):

• No local installation required if you use the hosted MCP endpoint. You can run the MCP client and point it to the remote server endpoint: https://sverigesradio-mcp.onrender.com/mcp

Option B - Local installation from source:

1. Install dependencies and build

git clone https://github.com/isakskogstad/Sveriges.Radio-MCP.git
cd Sveriges.Radio-MCP
npm install
npm run build

2. Run the server locally

npm start

3. Optional: run via npx (if you want to test without cloning)

npx sverigesradio-mcp

Option C - Install as npm package (remote usage):

1. Ensure Node.js is installed
2. Install and run the package

npx sverigesradio-mcp

Notes:
- If you clone and build locally, the start script will launch the MCP server locally on the default port (adjustable via environment if supported by the project).
- The remote hosted endpoint at https://sverigesradio-mcp.onrender.com/mcp is the recommended starting point for instant usage.

Tips and considerations:

• The MCP server uses the StreamableHTTP transport as per MCP 2025-03-26 spec when accessed by clients like Cursor or Claude Code. Endpoint: https://sverigesradio-mcp.onrender.com/mcp with JSON-RPC 2.0 format.
• No authentication is required for the public endpoint; ensure you respect usage limits and terms of service.
• If you run locally, you can use the provided app integrations to build dashboards for live radio, music playlists, podcasts, and traffic data.
• When using the npm package, you can connect to the server from multiple MCP clients by configuring the client with the endpoint URL of the running instance.
• Environment variables are not strictly required for the basic setup; you can expand coverage by setting API keys or configuring host/port if the project supports it in a custom deployment.