XMLTV

Provides an MCP server to access Tunarr XMLTV feed data with channels, schedules, and programme details.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "icyrainz-xmltv-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/xmltv-mcp/dist/index.js"
      ],
      "env": {
        "XMLTV_URL": "http://tunarr.lan/api/xmltv.xml"
      }
    }
  }
}

You can run an MCP server that exposes access to Tunarr XMLTV feed data. This server lets you list channels, see what’s currently playing, view schedules, search programmes, and get detailed programme information through simple MCP client interactions.

How to use

Connect to the XMLTV MCP server from your MCP client to perform common tasks. You can list all channels to understand what is available, check what is playing now across channels, request upcoming schedules for a specific channel, search programmes by title or description, and fetch detailed information for a specific programme by channel and start time. These capabilities enable you to build rich, TV-focused experiences without pulling data manually from Tunarr.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Step 1: Install dependencies.

npm install

Step 2: Build the MCP server.

npm run build

Step 3: Run or wire into your MCP client configuration. The server is intended to be executed by your MCP client as a stdio server. Use the following runtime command and ensure the environment variable XMLTV_URL is set to your Tunarr XMLTV feed URL.

node /absolute/path/to/xmltv-mcp/dist/index.js

Configuration and usage notes

Configure your MCP client to start the XMLTV MCP server using the example CLI configuration. The document shows how to wire the server in a client’s configuration so that the client launches the server and passes the required environment variable.

{
  "mcpServers": {
    "xmltv": {
      "command": "node",
      "args": ["/absolute/path/to/xmltv-mcp/dist/index.js"],
      "env": {
        "XMLTV_URL": "http://tunarr.lan/api/xmltv.xml"
      }
    }
  }
}

Additional setup details

Configure the environment variable that points to your XMLTV feed. If you are testing, you can use the sample URL shown here, but replace it with your actual Tunarr XMLTV feed endpoint when you deploy.

export XMLTV_URL="http://your-tunarr-instance/api/xmltv.xml"

Available tools

get_channels

Lists all available TV channels.

get_now_playing

Shows what is currently playing on all channels.

get_schedule

Gets upcoming programmes for a specific channel.

search_programmes

Searches programmes by title or description.

get_programme_details

Provides detailed information about a specific programme.