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