Switchai

io.github.US1929Published by GitHub account US1929v1.0.2Updated Oct 24, 2026

Compare Italian energy tariffs with AI. Analyzes bills, finds best offers, live market indices.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Compares Italian electricity and gas tariffs for AI agents: parses bills, ranks live ARERA offers, and estimates yearly savings.

What you can do
  • Parse an Italian energy bill text into consumption, spend and zone
  • Compare tariffs and calculate savings, returning the top 3 offers with cost breakdown and a recommendation
  • List the full electricity and gas offer catalogue
  • Read current PUN and PSV wholesale market indices
When to use it
Useful when a user in Italy wants to know whether they are overpaying for electricity or gas, wants the best current offers for their consumption and zone, or wants a bill read and interpreted. It is a comparison and advisory tool, not a switching service.
Requirements
Runs as a local Node.js process (npm package) that calls the SwitchAI HTTP API; the README's example sets SWITCHAI_API_URL. Anonymous use is limited to a filtered subset of offers with rate limits; full offer lists and higher daily call limits need a registered account and self-service API key. Network access required.
Before you install
Results are advisory and activation happens on supplier sites through affiliate links, so recommendations may carry commercial interest. Anonymous access is rate-limited and shows only a filtered subset of offers. No personal data is collected for activation, but bill text sent for parsing goes to the SwitchAI service.

Installation

In SourceWeft

  1. Open Switchai in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

SwitchAI — Energy comparison tools for AI agents (Italy)

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

[Glama 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.

text
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

bash
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)

json
{  "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

text
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

ChannelProtocolRequirement
WebMCPdocument.modelContext.registerTool()Chrome 146+
MCP Server@modelcontextprotocol/sdk (Node.js)Claude Desktop or any MCP client
REST APIJSON/HTTPSAny HTTP client

Tools

calculate_energy_savings

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

json
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.

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

get_available_offers

Full offer list: 3.196 electricity + 2.411 gas.

GET /api/tariffe/luceGET /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, zona2. calculate_energy_savings(commodity, consumi, zona, spesa) → offerte + affiliate_url3. 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

MethodEndpointDescription
GET/api/healthHealth check
GET/api/tariffe/luce3.196 electricity offers
GET/api/tariffe/gas2.411 gas offers
POST/api/analyzeFull analysis: parse + compare + honesty + attualization
POST/api/parse-bill-textBill parser
GET/api/market-indicesLive PUN and PSV
GET/api/fornitoriSuppliers list

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


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: [email protected]
Sito: https://www.switchai.it
Mercato: Italia · GDPR compliant


[smithery badge]

Source: README.md at commit db4ff74

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts