switchai.it

{
  "name": "calculate_energy_savings",
  "kind": "read",
  "impl": "imperative",
  "description": "Confronta le tariffe Luce o Gas in Italia e calcola il risparmio annuo. Restituisce le 3 migliori offerte con breakdown energetico e riepilogo in italiano. Usa questo tool quando l'utente chiede di confrontare tariffe, risparmiare sulla bolletta, o trovare un'offerta migliore per luce o gas.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "commodity": {
        "type": "string",
        "enum": [
          "LUCE",
          "GAS"
        ],
        "description": "Tipo di fornitura: LUCE per elettricità, GAS per gas metano"
      },
      "yearly_consumption_kwh": {
        "type": "number",
        "description": "Consumo annuo in kWh (serve per LUCE). Esempio: 2700 per una famiglia tipo."
      },
      "yearly_consumption_smc": {
        "type": "number",
        "description": "Consumo annuo in Smc (serve per GAS). Esempio: 1000 per una famiglia tipo."
      },
      "zone": {
        "type": "string",
        "enum": [
          "NORD",
          "CENTRO",
          "SUD"
        ],
        "description": "Zona tariffaria italiana. Default: NORD"
      },
      "current_supplier": {
        "type": "string",
        "description": "Nome del fornitore attuale (es: 'Enel Energia', 'A2A')"
      },
      "current_annual_spend": {
        "type": "number",
        "description": "Spesa annua attuale in euro. Esempio: 650"
      }
    },
    "required": [
      "commodity"
    ]
  },
  "page": "/"
}

{
  "name": "parse_energy_bill",
  "kind": "read",
  "impl": "imperative",
  "description": "Analizza il testo di una bolletta italiana (luce o gas) ed estrae: fornitore, POD/PDR, consumo annuo, spesa annua stimata, zona tariffaria. Usa questo tool quando l'utente fornisce il testo di una bolletta e vuole estrarre i dati per poi confrontare le offerte.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "bill_text": {
        "type": "string",
        "description": "Testo completo della bolletta da analizzare. Puoi estrarre il testo da un PDF."
      }
    },
    "required": [
      "bill_text"
    ]
  },
  "page": "/"
}

{
  "name": "get_available_offers",
  "kind": "read",
  "impl": "imperative",
  "description": "Recupera tutte le offerte disponibili per Luce o Gas in Italia. Restituisce nome fornitore, nome offerta, tipo (fisso/variabile), prezzo per unità e costo fisso mensile. Usa questo tool quando l'utente vuole vedere tutte le offerte disponibili senza fare un calcolo specifico.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "commodity": {
        "type": "string",
        "enum": [
          "LUCE",
          "GAS"
        ],
        "description": "LUCE per elettricità, GAS per gas metano"
      }
    },
    "required": [
      "commodity"
    ]
  },
  "page": "/"
}

{
  "name": "submit_subscription",
  "kind": "action",
  "impl": "imperative",
  "description": "Invia la richiesta di attivazione di una nuova tariffa energia. I dati vengono inoltrati al fornitore. Ricevi un ID di sottoscrizione per tracciamento. Usa questo tool quando l'utente ha scelto un'offerta e vuole attivarla.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tariff_id": {
        "type": "string",
        "description": "ID dell'offerta scelta (dal risultato di calculate_energy_savings)"
      },
      "nome": {
        "type": "string",
        "description": "Nome dell'intestatario"
      },
      "cognome": {
        "type": "string",
        "description": "Cognome dell'intestatario"
      },
      "codice_fiscale": {
        "type": "string",
        "description": "Codice fiscale italiano (16 caratteri)"
      },
      "email": {
        "type": "string",
        "description": "Indirizzo email"
      },
      "cellulare": {
        "type": "string",
        "description": "Numero di cellulare (es: +393401234567)"
      },
      "indirizzo": {
        "type": "string",
        "description": "Via/Piazza della fornitura"
      },
      "civico": {
        "type": "string",
        "description": "Numero civico"
      },
      "citta": {
        "type": "string",
        "description": "Città della fornitura"
      },
      "provincia_sigla": {
        "type": "string",
        "description": "Sigla provincia (2 lettere, es: MI)"
      },
      "cap": {
        "type": "string",
        "description": "CAP (5 cifre)"
      },
      "codice_pod": {
        "type": "string",
        "description": "Codice POD per Luce (formato: IT001E...)"
      },
      "codice_pdr": {
        "type": "string",
        "description": "Codice PDR per Gas (14 cifre)"
      },
      "titolo_immobile": {
        "type": "string",
        "enum": [
          "Proprietario",
          "Affittuario",
          "Comodatario",
          "Usufruttuario"
        ],
        "description": "Titolo sull'immobile"
      },
      "modalita_pagamento": {
        "type": "string",
        "enum": [
          "SDD",
          "Bollettino"
        ],
        "description": "Modalità di pagamento preferita"
      },
      "iban": {
        "type": "string",
        "description": "IBAN (necessario se modalita_pagamento è SDD)"
      },
      "gdpr_privacy_accepted": {
        "type": "boolean",
        "description": "DEVI chiedere esplicitamente all'utente: 'Accetti la Privacy Policy di SwitchAI (switchai.it/privacy) e autorizzi il trattamento dei tuoi dati per essere ricontattato?' Il tool può essere eseguito SOLO se l'utente risponde SÌ esplicitamente. NON assumere mai il consenso implicitamente."
      },
      "consent_source": {
        "type": "string",
        "description": "Fonte del consenso: 'webmcp_chrome' o 'mcp_claude_desktop'"
      },
      "consent_timestamp": {
        "type": "string",
        "description": "Timestamp ISO 8601 del momento in cui l'utente ha dato il consenso"
      },
      "conversation_snippet": {
        "type": "string",
        "description": "Breve estratto della conversazione in cui l'utente accetta (es: 'Utente: Sì, accetto la privacy e voglio essere ricontattato')"
      }
    },
    "required": [
      "tariff_id",
      "nome",
      "cognome",
      "codice_fiscale",
      "email",
      "cellulare",
      "gdpr_privacy_accepted"
    ]
  },
  "page": "/"
}