MCP App Store
by KeenEthics
ILEVIA icon

ILEVIA MCP Server for ChatGPT

By Ilevia srl

Overview

Control your ILEVIA home-automation system from ChatGPT: lights, shutters, thermostats and scenarios; live and historical energy data (photovoltaic production, consumption, grid import/export); schedules; irrigation; Sony TVs and Sonos speakers. The app operates exclusively on the user's own plant, linked once via QR code or serial+key at login.

How to connect

  1. ChatGPT: Open the ILEVIA listing in the ChatGPT app directory and choose Connect. ChatGPT listing ILEVIA exposes 47 tools here.

Tools

AppleTv_button

ChatGPT
Preme un tasto del telecomando dell'Apple TV. Tasti disponibili: up, down, left, right, select, menu, home, guide, pageUp, pageDown, screensaver, volumeUp, volumeDown. Per navigare i menu usare sequenze di tasti (home + frecce + select).

AppleTv_list_apps

ChatGPT
Elenca le app installate sull'Apple TV, con nome visualizzato e bundle id. Il bundle id è il valore da passare ad AppleTv_launch_app.

AppleTv_media

ChatGPT
Controlla la riproduzione: 'play', 'pause', 'stop', 'next', 'prev'. Nota: l'Apple TV non espone un vero comando di stop tramite questo protocollo (Companion), quindi 'stop' viene tradotto in una pausa.

AppleTv_set

ChatGPT
Imposta l'Apple TV: 'power' true/false invia Wake/Sleep (non è un vero accensione/spegnimento come su una TV — Companion non offre altro), 'volume' è assoluto 0-100. Passare solo i parametri da cambiare.

AppleTv_status

ChatGPT
Stato dell'Apple TV: associata (paired), connessa, app in primo piano, e l'elenco delle app installate (config.apps, con i bundle id da usare in AppleTv_launch_app). Senza id usa l'unica Apple TV del progetto.

AppleTv_unpair

ChatGPT
Rimuove l'associazione con un'Apple TV: Ilevia elimina le credenziali salvate LOCALMENTE e smette di controllarla. ATTENZIONE: non esiste nessuna revoca nota lato Apple TV — il dispositivo continuerà comunque a mostrare Ilevia tra i dispositivi associati finché non viene rimossa manualmente sull'Apple TV stessa (Impostazioni → Utenti e account) o l'Apple TV non viene ripristinata. Riferire sempre questa avvertenza all'utente.

SamsungTv_button

ChatGPT
Presses a Samsung TV remote-control key. Available keys: up, down, left, right, select, back, home, menu, exit, info, guide, tools, red, green, yellow, blue, num0-num9, channelUp, channelDown, volumeUp, volumeDown, mute, source, hdmi, play, pause, stop, fastForward, rewind, record. To navigate menus, use sequences of keys (home + arrows + select).

SamsungTv_launch_app

ChatGPT
Launches an app on the Samsung TV given its id (e.g. Netflix '3201907018807', YouTube '111299001912'). Use SamsungTv_list_apps to discover the available ids.

SamsungTv_list_apps

ChatGPT
Lists the Samsung TV's apps, with display name and Samsung id. The id is the value to pass to SamsungTv_launch_app. On 2020+ models the list may come from an internal catalog.

SamsungTv_media

ChatGPT
Controls playback: 'play', 'pause', 'stop', 'next', 'prev'. Note: the Samsung protocol emulates remote-control key presses, so there is no state confirmation; 'next'/'prev' are translated into fast-forward/rewind.

SamsungTv_set

ChatGPT
Controls the Samsung TV: 'power' true turns it on via Wake-on-LAN (needs the MAC and 'Power On with Mobile' enabled on the TV), false turns it off (POWER key, sent only if the TV is currently on); 'volume' is absolute 0-100 and is only available if the TV exposes UPnP control, otherwise use SamsungTv_button volumeUp/volumeDown. Pass only the parameters you want to change.

SamsungTv_status

ChatGPT
Samsung TV status: paired, power (awake/asleep/shutting-down/unreachable, plus artmode on Frame TVs -- 'shutting-down' means it was just told to power off and has not actually left the network yet, so it will not respond to a power-on), foreground app, volume if available, and the list of apps (config.apps, with the ids to use in SamsungTv_launch_app). Without an id, uses the project's only Samsung TV.

SamsungTv_unpair

ChatGPT
Removes the pairing with a Samsung TV: Ilevia deletes the LOCALLY saved token and stops controlling it. WARNING: the TV will keep listing Ilevia under 'Device Connection Manager' until it's removed manually on the TV.

access_history_query

ChatGPT
Storico degli accessi rilevati dai dealer di controllo accessi (lettori badge/PIN, es. Dahua o BX-KNX): chi ha provato ad accedere, quando (UTC), se autorizzato o negato, con quale card/PIN e su quale device/porta. Risultati dal più recente. Usa list_components(type="access_control_dealer") per trovare gli id dei dealer se vuoi filtrare per uno specifico impianto/varco; senza filtro dealerId interroga tutti i dealer del progetto. Per sapere CHI ha accesso configurato adesso (non lo storico) usa invece get_component sul dealer.

energy_overview

ChatGPT
Panoramica energetica dell'impianto ADESSO: potenza ed energia di consumo, produzione (fotovoltaico), export, più l'elenco dei carichi monitorati (clima, luce, cucina...) con i rispettivi valori correnti. Legge il componente 'energy_overview' del progetto e risolve tutti i componenti che referenzia. NB: i contatori di energia sono totalizzatori cumulativi; per lo storico (oggi, ieri, un mese) usa energy_query.

energy_query

ChatGPT
Interroga l'ARCHIVIO STORICO dei dati di energia con una query Flux (InfluxDB, bucket 'ProjectsData'). USALO SEMPRE, direttamente, quando l'utente chiede consumi/produzione/import/export su un periodo (oggi, ieri, settimana, mese): è l'unico modo per rispondere e non richiede alcuna abilitazione aggiuntiva. La risposta grezza dell'archivio (JSON o CSV annotato InfluxDB) è nel campo 'raw'. SCHEMA: il bucket è multi-impianto, filtra SEMPRE per il tag device_id. Serie complessive dell'impianto: _measurement 'energy_production', 'energy_in' (import da rete), 'energy_export', 'power_production', 'power_consumption', con device_id = '<projectId>_<energyOverviewId>' (projectId da server_info, energyOverviewId = id del componente energy_overview). Serie per singolo carico: _measurement '<componentId>_energy' e '<componentId>_power' (gli id dei loads di energy_overview). I contatori di energia sono totalizzatori cumulativi in Wh: il valore su un periodo si calcola con spread() sul range. Esempio, produzione di oggi: from(bucket: "ProjectsData") |> range(start: today()) |> filter(fn: (r) => r._measurement == "energy_production" and r.device_id == "<projectId>_<energyOverviewId>") |> spread(). NB: range(start: today()) è mezzanotte UTC; per la mezzanotte locale italiana usa un timestamp esplicito (es. 2026-07-22T22:00:00Z in estate). Per lo schema completo: import "influxdata/influxdb/schema" + schema.measurements(bucket: "ProjectsData"). Aggrega sempre (spread, aggregateWindow, sum): risposte oltre 60KB vengono troncate.

get_component

ChatGPT
Dettaglio completo di un componente dato il suo id: valore corrente e precedente, tipo, behaviour, parametri di configurazione.

irrigation_configure

ChatGPT
Modifica la configurazione dell'irrigazione: numero di ripetizioni del ciclo, percentuale di durata (100 = durate nominali, 50 = tempi dimezzati), e/o l'elenco delle zone. Passare solo i parametri da cambiare. La modifica delle zone SOSTITUISCE l'intero elenco: leggere prima irrigation_status e ripassare tutte le zone con le modifiche.

irrigation_control

ChatGPT
Avvia, ferma o mette in pausa il ciclo di irrigazione. 'play' esegue il ciclo delle zone abilitate nell'ordine configurato (rispetta l'interruttore di abilitazione: se l'irrigazione è disabilitata il play non parte); 'stop' ferma tutto e chiude le zone; 'pause' sospende mantenendo la posizione nel ciclo.

irrigation_set_output

ChatGPT
Comando MANUALE delle uscite dell'irrigazione, fuori dal ciclo automatico: pompa principale, valvola di scarico, o una singola zona/attuatore (componentId dall'elenco actuators/zone di irrigation_status). Usare con criterio: durante un ciclo in corso conviene passare da irrigation_control.

irrigation_status

ChatGPT
Stato completo dell'irrigazione: in esecuzione o ferma (workingState: idle/running/paused), zona attiva corrente, stato pompa, allarmi/sensori di blocco attivi, e configurazione (elenco zone con durate, ripetizioni del ciclo, percentuale di durata, sensori). Senza id usa l'unico impianto di irrigazione del progetto.

list_component_types

ChatGPT
Elenca i tipi di componente presenti nell'impianto con il conteggio per tipo (campo 'types'). Utile per capire cosa c'è prima di usare list_components con filtro.

list_components

ChatGPT
Elenca i componenti dell'impianto (luci, tapparelle, termostati, sensori...). Ogni voce ha id, nome, tipo, gateway e valore corrente. Filtra per tipo e/o per sottostringa del nome (case-insensitive) per non scaricare tutto.

schedule_delete_event

ChatGPT
Elimina un evento di schedulazione dato il suo id (campo 'id' di schedule_list, es. 'event-01KM...'). Rimuove sia il job pianificato sia la persistenza.

schedule_delete_program

ChatGPT
Elimina un programma (calendario) dato il suo id (es. 'program-01KM...'). NB: gli eventi che gli appartenevano NON vengono eliminati: restano orfani e non compaiono più nelle prossime attivazioni — eliminarli con schedule_delete_event o riassegnarli con schedule_write_event.

schedule_execute_event

ChatGPT
Esegue SUBITO le azioni di un evento di schedulazione, senza aspettare il suo orario (l'evento e il suo programma devono essere attivi). Utile per testare un evento appena creato.

schedule_list

ChatGPT
Elenca le schedulazioni: programmi (calendari, con stato attivo/disattivo) ed eventi (orario, tipo di ricorrenza, azioni sui componenti). Gli eventi appartengono a un programma tramite programId; un programma disattivo blocca tutti i suoi eventi.

schedule_next

ChatGPT
Prossime attivazioni pianificate (data/ora locale + eventId), in ordine cronologico. Utile per rispondere a 'cosa succede stasera/domani?'. NB: elenca solo eventi appartenenti a un programma attivo.

schedule_write_event

ChatGPT
Crea o aggiorna un evento di schedulazione: a un orario dato esegue una sequenza di azioni sui componenti (come farebbe l'utente dall'app). Esempi: 'accendi la lavanderia alle 18:30 tutti i giorni' → type=DAY, startTime=18:30:00, actions=[{"componentId":"<id>","value":true}]. Le azioni vengono eseguite in ordine; inserisci {"timerMs":5000} tra due azioni per una pausa. Consigliato associare un programId (schedule_list per vederli, schedule_write_program per crearne) altrimenti l'evento non compare tra le prossime attivazioni. Per aggiornare un evento passa il suo id e TUTTI i campi (sovrascrittura completa).

schedule_write_program

ChatGPT
Crea o aggiorna un programma (calendario) di schedulazione. Un programma raggruppa più eventi e può essere attivato/disattivato in blocco. Per aggiornare passa l'id esistente (il JSON viene sovrascritto: ripassa tutti i campi che vuoi mantenere).

server_info

ChatGPT
Informazioni sul server domotico locale: versione, progetto e conteggio componenti. Chiamalo per primo per capire con che impianto stai parlando.

set_component_value

ChatGPT
Invia un comando (WRITE) a un componente, come farebbe l'app dell'utente. Esempi di 'value' per tipo: switch/lock/scenario: true o false; slider/dimmer (percentuale) e thermostat (setpoint): un numero, es. 21.5; shutter: {"position": 50}; rgb-light: un colore secondo i parametri del componente. In dubbio, leggi prima il valore corrente con get_component e replica il formato.

sonos_favorites

ChatGPT
Elenca i preferiti Sonos (favoriteId, nome, descrizione) dell'household. Usa il favoriteId con sonos_play_favorite per avviarli.

sonos_mute

ChatGPT
Muta o riattiva l'audio del SONOS.

sonos_play_favorite

ChatGPT
Avvia un preferito Sonos dato il suo favoriteId (dall'elenco di sonos_favorites).

sonos_play_playlist

ChatGPT
Avvia una playlist Sonos dato il suo playlistId (dall'elenco di sonos_playlists).

sonos_playback

ChatGPT
Controlla la riproduzione del SONOS: 'play', 'pause', 'toggle' (play/pausa), 'next' (traccia successiva).

sonos_playlists

ChatGPT
Elenca le playlist Sonos (playlistId, nome, numero tracce) dell'household. Usa il playlistId con sonos_play_playlist.

sonos_status

ChatGPT
Stato del SONOS letto al volo: registrazione, volume (0-100), mute, stato riproduzione, traccia corrente, e gruppo/zona. Senza id usa l'unico SONOS del progetto.

sonos_volume

ChatGPT
Imposta il volume assoluto del SONOS (0-100).

tv_app

ChatGPT
Avvia un'app sulla TV (es. Netflix, YouTube) dato il suo uri applicativo Bravia. Se l'uri non è noto, spesso è più pratico navigare con tv_button (home + frecce + confirm).

tv_button

ChatGPT
Preme un tasto del telecomando della TV (IRCC). Tasti disponibili: up, down, left, right, confirm, back, home, options, display, input, red, green, yellow, blue, num0..num9, volumeUp, volumeDown, mute, channelUp, channelDown, play, pause, stop, next, prev, fastForward, rewind, subTitle, audio, wide, jump, syncMenu, actionMenu, androidMenu, help, tvPower, powerOff, sleep, sleepTimer, pictureMode, hdmi1, hdmi2, hdmi3, hdmi4. Per navigare i menu usare sequenze di tasti (up/down/left/right + confirm).

tv_channel

ChatGPT
Cambia canale TV: un numero di canale (es. '5') oppure 'up'/'down' per canale successivo/precedente.

tv_set

ChatGPT
Imposta la TV: accensione/spegnimento, volume assoluto, mute, ingresso video. Passare solo i parametri da cambiare. Per l'ingresso accetta sia l'uri esatto (dal campo sources di tv_status, es. 'extInput:hdmi?port=2') sia la scorciatoia 'hdmi1'..'hdmi4'.

tv_status

ChatGPT
Stato della TV: accesa/spenta, volume, mute, ingresso video attivo, e l'elenco degli ingressi disponibili (sources, con gli uri da usare in tv_set). Senza id usa l'unica TV del progetto.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/ilevia"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/ilevia)