Switchai MCP server

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, billattualization and an Italian agentsummary.

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

calculateenergysavings

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: consumoannuokwh, spesaannuaeur, zona, fornitore. Add bill_text for full auto-extraction of consumption, spend and zone.

parseenergybill

Extract structured data from an Italian bill text.

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

Shortened. The full README is on GitHub.