aria-mcp-tvguide-dk

A Model Context Protocol (MCP) server that exposes the Danish TV guide (EPG) to AI assistants. Built for ARIA and shareable with the community.

Fully keyless — no API key required.

What it does

Lets your AI assistant answer questions like:

• "Hvad går der i fjernsynet i aften?"

• "Hvad sender DR1 kl. 20?"

• "Hvornår sender TV 2 Klovn?"

• "Hvor kan jeg se VM-kampen i aften?"

Related MCP server: MCP Remote Control

Data Source

EPG data is provided by Allente Denmark via their internal EPG API (https://cs-vcb.allente.dk/epg/events). The data is best-effort for personal/hobby use. Check Allente's Terms of Service before any redistribution or commercial use.

Covers all major Danish channels: DR1, DR2, DR Ramasjang, TV 2, TV 2 News, TV 2 Charlie, TV 2 Sport, TV3, TV3+, Kanal 4, Kanal 5, 6'eren, CANAL9, dk4, Eurosport, Discovery, National Geographic, BBC Nordic, and more.

Install & Run

npx aria-mcp-tvguide-dk

Or install globally:

npm install -g aria-mcp-tvguide-dk
aria-mcp-tvguide-dk

Requires Node.js 20 or later.

Tools

list_channels

List available channels with id and name. Supports an optional name filter.

Parameters:

Returns: { count, channels[{ id, name }] }

whats_on

Return the programme airing on a channel now (or at a specified time).

Parameters:

Returns: A single Programme object:

{
  "channelId": "452",
  "channelName": "DR1",
  "title": "Fodbold: VM",
  "start": "2026-06-12T21:00:00+02:00",
  "stop": "2026-06-12T22:05:00+02:00",
  "durationMinutes": 65,
  "description": "Der er store VM-drømme i Canada...",
  "categories": ["sport"],
  "live": false
}

tonight

Return prime-time (19:00–23:00 Copenhagen) TV listings for today, grouped by channel.

Parameters:

Returns: { date, primetime, channels: { [channelName]: Programme[] } }

search_program

Find programmes by title across channels for a date.

Parameters:

Returns: { query, date, matchCount, programmes: Programme[] }

Environment Variables

When unset, the default is: DR1, DR2, TV 2, TV 2 News, TV3, TV3+, Kanal 4, Kanal 5, TV 2 Charlie, 6'eren.

ARIA MCP Config

Add to your ARIA credentials / MCP config:

{
  "command": "npx",
  "args": ["-y", "aria-mcp-tvguide-dk"],
  "env": {}
}

With a custom default channel set:

{
  "command": "npx",
  "args": ["-y", "aria-mcp-tvguide-dk"],
  "env": {
    "DEFAULT_CHANNELS": "DR1,TV 2,TV3,Kanal 5"
  }
}

Development

git clone https://github.com/kimhjort/aria-mcp-tvguide-dk
cd aria-mcp-tvguide-dk
npm install
npm run build
npm test

Attribution & Terms

EPG data is sourced from Allente Denmark (allente.dk). This server is a personal/hobby project. The Allente EPG API is not a documented public API — use it in good faith and at your own risk. Check Allente's terms before any redistribution or commercial use.

License

MIT — see LICENSE.