
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.
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.
Installation
In SourceWeft
- Open Switchai in the dashboard and add it to a workspace.
- 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
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.
Quickstart (60 seconds)
1. Via REST API — no install
Returns top3 offers with full cost breakdown, honesty recommendation, bill_attualization and an Italian agent_summary.
2. Via MCP Server (Claude Desktop)
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
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.
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.
get_available_offers
Full offer list: 3.196 electricity + 2.411 gas.
get_market_indices
Current PUN (electricity) and PSV (gas) wholesale indices.
Optimal agent flow
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: [email protected]
Sito: https://www.switchai.it
Mercato: Italia · GDPR compliant
Source: README.md at commit db4ff74
Tools
0Version history
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