Switchai

SSE

by US1929

242 downloads Not rated yet

GitHub Website

About

AI agent for Italian energy tariff comparison. Analyzes utility bills (ARERA 2.0), compares 44+ live offers for electricity (Luce) and gas, and finds the best tariff. 4 tools available via HTTP JSON-RPC. switchai.it

Details

Transport: SSE

Explore

- Parse Italian energy bills to extract structured data.
- Compare 44+ live electricity and gas offers.
- Calculate annual savings and return top 3 offers.
- Submit subscription with optional dry-run mode.
- Supports multiple LLM clients (Claude, Gemini, ChatGPT).
- Accessible via WebMCP, MCP Server, and REST API.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Switchai

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

From the repository

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

---

`analyze_energy_bill`

Analyzes an Italian energy bill and compares tariffs in one call. Returns profile, top 3 offers with savings, risk assessment, and agent_summary in Italian ready for the user.

`get_available_offers`

Lists all available energy offers in the Italian free market. 25 electricity + 19 gas offers with pricing, contract type, fixed fees.

`get_market_indices`

Returns current PUN (Italian National Single Price for electricity) and PSV (Virtual Trading Point for gas), updated daily.

`get_subscription_form_schema`

Returns the complete JSON schema for the subscription form: required fields, valid enums, 4-step wizard structure.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "switchai": {
            "switchai": {
                "type": "http",
                "url": "https://www.switchai.it/mcp"
            }
        }
    }
}

McpServers

{
    "switchai": {
        "type": "http",
        "url": "https://www.switchai.it/mcp"
    }
}

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

analyze_energy_bill

get_available_offers

get_market_indices

get_subscription_form_schema

Claude Desktop / Cursor

McpServers

Come funziona

Tre canali di accesso per AI agent

Tool disponibili

calculate_energy_savings

parse_energy_bill

get_available_offers

submit_subscription

Configurazione MCP Server (Claude Desktop)

Flusso ottimale per AI agent

API Endpoints

Stack tecnico

Discovery files

Keyword semantiche (per LLM retrieval)

Licenza e contatti

More like this

Sentry

Github

Git

GitLab

`analyze_energy_bill`

`get_available_offers`

`get_market_indices`

`get_subscription_form_schema`

`calculate_energy_savings`

`parse_energy_bill`

`get_available_offers`

`submit_subscription`