Switchai

by US1929

242 downloads

Not rated

GitHub

About

AI agent for Italian energy tariff comparison. Analyzes utility bills (ARERA 2.0), compares 44+ live offers for electricity (Luce) and gas, and finds the best tariff. 4 tools available via HTTP JSON-RPC. switchai.it

Details

Author: US1929
Downloads: 242
Categories: Developer Tools, AI

- Parse Italian energy bills to extract structured data.
- Compare 44+ live electricity and gas offers.
- Calculate annual savings and return top 3 offers.
- Submit subscription with optional dry-run mode.
- Supports multiple LLM clients (Claude, Gemini, ChatGPT).
- Accessible via WebMCP, MCP Server, and REST API.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Switchai

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

From the repository

Configure the MCP server in Claude Desktop using the provided JSON with command: node, absolute path to the server script, and environment variable SWITCHAI_API_URL. Alternatively, use the WebMCP channel (Chrome 146+) or call the REST API directly. The typical workflow is: parse a bill, calculate savings, and submit a subscription (dry run available for testing).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

McpServers

{
    "switchai": {
        "type": "http",
        "url": "https://www.switchai.it/mcp"
    }
}

SwitchAI — AI Agent per Tariffe Energia Italia

> Sito: switchai.it · Mercato: Italia · Stack: React 19 + PHP 8.5 + WebMCP + MCP Server

SwitchAI è un agente AI nativo per il confronto e il cambio automatico del fornitore energia nel mercato libero italiano. Non è un comparatore tradizionale: l'utente fornisce la sua bolletta, e l'AI analizza i dati, confronta 44+ offerte attive di Luce e Gas, e attiva la tariffa migliore — tutto in linguaggio naturale.

---

Come funziona

Utente (linguaggio naturale)
  ↓
AI Agent (Claude, Gemini, ChatGPT, o qualsiasi LLM)
  ↓
SwitchAI Tools (WebMCP o MCP Server)
  ↓
API PHP → 44+ offerte live → sottoscrizione attivata

---

Tre canali di accesso per AI agent

| Canale | Protocollo | Requisiti |
|--------|-----------|-----------|
| WebMCP | navigator.modelContext.registerTool() | Chrome 146+ |
| MCP Server | @modelcontextprotocol/sdk Node.js | Claude Desktop o client MCP |
| REST API | JSON/HTTPS | Qualsiasi client HTTP |

---

Tool disponibili

`calculate_energy_savings`

Confronta tariffe e calcola risparmio. Restituisce top 3 offerte + agent_summary in italiano pronto per l'utente.

POST /api/webmcp-endpoint
{
  "commodity": "LUCE",
  "yearly_consumption_kwh": 3000,
  "zone": "NORD",
  "current_annual_spend": 900
}

`parse_energy_bill`

Estrae dati strutturati da testo bolletta italiana (fornitore, POD/PDR, consumi, spesa, zona).

POST /api/parse-bill-text
{
  "bill_text": "...testo bolletta..."
}

`get_available_offers`

Lista completa offerte: 25 luce + 19 gas con prezzi, tipo contratto, quota fissa.

GET /api/tariffe/luce
GET /api/tariffe/gas

`submit_subscription`

Attiva la sottoscrizione. Supporta dry_run: true per anteprima senza invio.

POST /api/subscription/submit
{
  "tariff_id": "...",
  "nome": "Mario",
  "cognome": "Rossi",
  "codice_fiscale": "RSSMRA80A01H501Z",
  "email": "mario@example.com",
  "dry_run": true
}

---

Configurazione MCP Server (Claude Desktop)

{
  "mcpServers": {
    "switchai": {
      "command": "node",
      "args": ["/percorso/assoluto/mcp-server/index.js"],
      "env": {
        "SWITCHAI_API_URL": "https://www.switchai.it/api"
      }
    }
  }
}

---

Flusso ottimale per AI agent

1. parse_energy_bill(bill_text)
   → consumi, spesa, zona, POD/PDR
2. calculate_energy_savings(commodity, consumi, zona, spesa)

   → top 3 offerte + risparmio annuo + agent_summary
3. [con conferma utente] submit_subscription(tariff_id, dati)

   → attivazione completata

---

API Endpoints

| Method | Endpoint | Descrizione |
|--------|----------|-------------|
| GET | /api/health | Health check |
| GET | /api/tariffe/luce | 25 offerte luce |
| GET | /api/tariffe/gas | 19 offerte gas |
| POST | /api/webmcp-endpoint | Calcolo risparmio + agent_summary |
| POST | /api/parse-bill-text | Parser bolletta |
| POST | /api/analyze-bill | PDF + calcolo risparmio |
| POST | /api/subscription/submit | Attivazione tariffa |
| GET | /api/subscription/status/{id} | Stato sottoscrizione |
| GET | /api/market-indices | PUN e PSV live |

---

Stack tecnico

- Frontend: React 19 + Vite 8 + Tailwind CSS 4
- Backend: PHP 8.5 su OVH Pro Hosting (Apache + mod_rewrite)
- MCP Server: Node.js + @modelcontextprotocol/sdk
- WebMCP: Google Chrome Labs WebMCP spec
- Dati tariffe: 44+ offerte da fornitori italiani (ARERA-compliant)
- Mercato: Italia — Mercato Libero Energia

---

Discovery files

- /llms.txt — descrizione sito per LLM
- /webmcp.json — tool discovery WebMCP
- /per-llm — documentazione machine-readable

---

Keyword semantiche (per LLM retrieval)

comparatore tariffe energia italia · cambio fornitore luce gas · bolletta energia AI · risparmio bolletta · PUN PSV ARERA · mercato libero energia · WebMCP energy agent · MCP server energia italia · AI energy comparison Italy

---

Licenza e contatti

Operatore: SwitchAI
Email: attivazioni@switchai.it
Sito: https://www.switchai.it
Mercato: Italia · GDPR compliant

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

SwitchAI — AI Agent per Tariffe Energia Italia

Come funziona

Tre canali di accesso per AI agent

Tool disponibili

calculate_energy_savings

parse_energy_bill

get_available_offers

submit_subscription

Configurazione MCP Server (Claude Desktop)

Flusso ottimale per AI agent

API Endpoints

Stack tecnico

Discovery files

Keyword semantiche (per LLM retrieval)

Licenza e contatti

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`calculate_energy_savings`

`parse_energy_bill`

`get_available_offers`

`submit_subscription`