Switchai

SwitchAI — Energy comparison tools for AI agents (Italy)

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

SwitchAI is an energy comparison engine for the Italian market, designed to be called by AI agents. An agent gives it a bill (or consumption + spend), and SwitchAI compares 5.600+ live ARERA offers (electricity & gas), returns the best tariffs with direct activation links, and includes an honesty system so the agent never recommends a switch that doesn't pay off.

SwitchAI is not a chatbot: it is the infrastructure AI agents call. Access it via MCP Server, WebMCP, or the REST API.

AI Agent (Claude, Gemini, ChatGPT)

↓ MCP / WebMCP / OpenAPI ↓ SwitchAI engine ↓ Italian energy market ↓ Offers (ARERA) · PUN · PSV · bill parsing · savings calculation ↓ Top 3 offers + activation links (supplier site)

---

Quickstart (60 seconds)

1. Via REST API — no install

curl -s -X POST https://www.switchai.it/api/analyze \

-H 'Content-Type: application/json' \ -d '{ "commodity": "LUCE", "yearly_consumption_kwh": 3200, "zone": "NORD", "current_annual_spend": 1100 }'

Returns top3 offers with full cost breakdown, honesty recommendation, bill_attualization and an Italian agent_summary.

2. Via MCP Server (Claude Desktop)

{

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

3. Via WebMCP (Chrome 146+)

Visiting switchai.it registers 4 tools via document.modelContext.registerTool() — discoverable by any WebMCP-compatible agent.

More examples (agent conversations, HTTP equivalents, rules): mcp-server/EXAMPLES.md.

---

Working example

User:    "Questa è la mia bolletta Enel, pago ~1.100€/anno e consumo 3.200 kWh.

Sto pagando troppo?"

Agent: parse_energy_bill(bill_text) → { commodity: "LUCE", consumo_annuo: 3200, spesa_annua: 1100, zona: "NORD" }

Agent: calculate_energy_savings({ commodity:"LUCE", yearly_consumption_kwh:3200, zone:"NORD", current_annual_spend:1100 }) → top3 + honesty:{ recommendation:"switch", savings_eur:240, savings_pct:22 }

Agent: "Sì, risulti sopra la media del mercato. Con 3.200 kWh in zona NORD puoi risparmiare ~240€/anno (22%). Le migliori 3 offerte: E.ON LuceClick (0,1146 €/kWh), Edison Web Luce (0,122 €/kWh), A2A Full Luce (0,139 €/kWh). Clicca per attivare sul sito del fornitore."

The activation always happens on the supplier's website via affiliate_url. SwitchAI never claims "activation completed" and collects no personal data for activation.

---

Three access channels for AI agents

---

Tools

calculate_energy_savings

Compare Italian tariffs and calculate savings. Returns top 3 offers + Italian agent_summary.

POST /api/analyze

{ "commodity": "LUCE", "yearly_consumption_kwh": 3000, "zone": "NORD", "current_annual_spend": 900 }

Italian aliases are also accepted: `consumo_annuo_kwh`, `spesa_annua_eur`, `zona`, `fornitore`. Add `bill_text` for full auto-extraction of consumption, spend and zone.

parse_energy_bill

Extract structured data from an Italian bill text.

POST /api/parse-bill-text

{ "bill_text": "...testo bolletta..." }

get_available_offers

Full offer list: 3.196 electricity + 2.411 gas.

GET /api/tariffe/luce

GET /api/tariffe/gas

get_market_indices

Current PUN (electricity) and PSV (gas) wholesale indices.

GET /api/market-indices

---

Optimal agent flow

1. parse_energy_bill(bill_text) → consumi, spesa, zona

1. calculate_energy_savings(commodity, consumi, zona, spesa) → offerte + affiliate_url
2. Utente clicca il link → attivazione sul sito del fornitore

Honesty system: switch (savings >50€/yr and >5%) / evaluate (30-50€ or 3-5%) / stay (<30€ or <3%).

---

API Endpoints

---

Data & tiers

• 5.600+ offers (3.196 luce + 2.411 gas), synced nightly from the official ARERA Portale Offerte (CC BY 4.0).
• Anonymous: ~270 filtered offers (NORD zone), no registration, rate-limited.
• Free (registered): full 5.600+ offers, 10 calls/day, self-service API keys.
• API Pro: full 5.600+ offers, 1.000 calls/day, self-service API keys (free beta).

---

Stack

• Frontend: React 19 + Vite 8 + Tailwind CSS 4
• Backend: PHP 8.5 on OVH Pro Hosting (Apache + mod_rewrite)
• MCP Server: Node.js + @modelcontextprotocol/sdk
• WebMCP: Chrome WebMCP spec (W3C WebML CG)
• Data: ARERA Portale Offerte, sync giornaliero notturno

---

Discovery files

• /llms.txt — LLM site description
• /webmcp.json — WebMCP tool discovery
• /per-llm — machine-readable documentation
• /per-llm-examples — 15 agent conversation patterns
• /openapi.json — OpenAPI 3.0 spec

---

Keywords (for 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 · energy comparison API Italy · MCP energy tariffs Italy

---

License & contacts

Email: info@switchai.it Sito: https://www.switchai.it Mercato: Italia · GDPR compliant

---