swiss-energy-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SWISS_ENERGY_HOST | No | Host for HTTP transport. Bind 0.0.0.0 only inside a container. | 127.0.0.1 |
| SWISS_ENERGY_PORT | No | Port for HTTP transport | 8000 |
| SWISS_ENERGY_LOG_LEVEL | No | Log level: DEBUG / INFO / WARNING / ERROR | INFO |
| SWISS_ENERGY_TRANSPORT | No | Transport mode: stdio or http | stdio |
| SWISS_ENERGY_CORS_ORIGINS | No | Comma-separated allowed CORS origins (HTTP transport) | https://claude.ai |
| SWISS_ENERGY_HTTP_TIMEOUT | No | Upstream HTTP timeout in seconds | 20 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Swiss Energy MCP – energy data from the Swiss Federal Office of Energy (BFE) via the GeoAdmin REST API and opendata.swiss. All tools are read-only and auth-free. Pass coordinates as WGS84 (lat/lon); conversion to LV95 is internal. Every search tool returns an EnergyResponse envelope with structured results, a Markdown summary, explicit source/license, and a match_type ('exact' or 'none'). Use energy_location_profile to answer broad questions in a single call. Coordinate hints: Zürich lat=47.3769 lon=8.5417; Bern lat=46.9480 lon=7.4474; Geneva lat=46.2044 lon=6.1432.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| energy_find_power_plantsA | Sucht Elektrizitätsproduktionsanlagen aller Typen (Photovoltaik, Wasserkraft, Wind, Biomasse, Kernkraft) im Umkreis eines Standorts. <use_case>Standortanalysen, politische und journalistische Recherche, Schul- und Verwaltungsprojekte zur lokalen Stromproduktion.</use_case> <important_notes>Quelle: BFE-Layer ch.bfe.elektrizitaetsproduktionsanlagen. Optionaler category_filter grenzt auf einen Anlagentyp ein. Liefert max. 201 Treffer pro Aufruf.</important_notes> lat=46.948, lon=7.447, radius_m=20000, category_filter='Photovoltaik' |
| energy_find_wind_turbinesA | Sucht Windenergieanlagen im Umkreis eines Standorts inkl. Betreiber, Hersteller, Modell, Nabenhöhe und Leistung. <use_case>Recherche zu Windkraft-Standorten, regionale Energieplanung.</use_case> <important_notes>Quelle: ch.bfe.windenergieanlagen. Windkraft konzentriert sich auf Jura, Wallis und Mittelland — für landesweite Suchen radius_m bis 50000 m wählen oder die Koordinaten anpassen.</important_notes> lat=47.22, lon=7.05, radius_m=30000 |
| energy_find_hydro_plantsA | Sucht Wasserkraftwerke (Lauf-, Speicher-, Pumpspeicher) im Umkreis eines Standorts inkl. Leistung, Fallhöhe und erwarteter Jahresproduktion. <use_case>Analyse der regionalen Wasserkraft, Infrastruktur-Recherche.</use_case> <important_notes>Quelle: ch.bfe.statistik-wasserkraftanlagen.</important_notes> lat=47.05, lon=8.31, radius_m=30000 |
| energy_find_pv_installationsA | Sucht Photovoltaik-Grossanlagen im Umkreis eines Standorts inkl. Leistung (MWp), Jahres- und Winterproduktion sowie Projektstatus. <use_case>Recherche zu PV-Grossprojekten, Energieplanung.</use_case> <important_notes>Quelle: ch.bfe.photovoltaik-grossanlagen. Erfasst nur Grossanlagen — Einzel-PV erscheint in energy_find_power_plants.</important_notes> lat=46.2, lon=7.5, radius_m=40000 |
| energy_find_biogas_plantsA | Sucht Biogasanlagen im Umkreis eines Standorts. Biogasanlagen erzeugen Energie aus organischen Abfällen und Biomasse. <use_case>Recherche zu Biomasse-Energie, regionale Kreislaufwirtschaft.</use_case> <important_notes>Quelle: ch.bfe.biogasanlagen.</important_notes> lat=47.4, lon=8.5, radius_m=25000 |
| energy_solar_potentialA | Fragt die Solareignung von Dächern für einen Standort ab. <use_case>Entscheide über PV-Anlagen auf Schulhäusern und öffentlichen Gebäuden, Solarpotenzial-Analysen.</use_case> <important_notes>Quelle: ch.bfe.solarenergie-eignung-daecher (Rasterdaten). Kleine Radien liefern evtl. keine Treffer; der Radius wird intern auf mindestens 2000 m angehoben. Eignungsklassen: 1 (sehr gut) bis 5 (nicht geeignet).</important_notes> lat=47.37, lon=8.54, radius_m=3000 |
| energy_find_energy_citiesA | Sucht Gemeinden mit dem Label «Energiestadt» per Name oder Standort. <use_case>Vergleich der Energiepolitik von Gemeinden, kommunale Recherche.</use_case> <important_notes>Quelle: ch.bfe.energiestaedte. Entweder name ODER lat/lon angeben — nicht beides leer lassen.</important_notes> name='Zürich' | lat=47.35, lon=8.65, radius_m=50000 |
| energy_location_profileA | Erstellt ein vollständiges Energieprofil für einen Standort und aggregiert dafür fünf BFE-Layer (Produktionsanlagen, Wind, Wasser, PV-Gross, Energiestädte) in einem einzigen Aufruf. <use_case>Schneller Gesamtüberblick für Berichte der Stadtverwaltung, Standortentscheide und Demos — beantwortet die Anchor-Frage in einem Aufruf.</use_case> <important_notes>Aggregiert mehrere parallele API-Calls; typische Laufzeit unter 5 s. Quelle: GeoAdmin / BFE.</important_notes> lat=47.05, lon=8.31, radius_m=20000 |
| energy_search_bfe_datasetsA | Durchsucht den opendata.swiss-Katalog nach Datensätzen des Bundesamts für Energie (BFE). <use_case>Auffinden von BFE-Rohdaten und Statistiken, Datenrecherche jenseits der Geo-Layer.</use_case> <important_notes>Liefert Metadaten (Titel, Beschreibung, Formate, Link) — keine Rohdaten. Volltextsuche deckt nur Metadaten ab. Paginierung über offset.</important_notes> query='wasserkraft', limit=10, offset=0 |
| energy_check_statusA | Prüft die Verfügbarkeit der GeoAdmin- und opendata.swiss-APIs. <use_case>Diagnose bei unerwartetem Verhalten, Monitoring.</use_case> <important_notes>Führt zwei leichtgewichtige Test-Requests aus.</important_notes> |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| energy_site_assessment | Guided prompt for assessing the energy situation around a location. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| bfe-layer-catalogue | Static catalogue of the BFE GeoAdmin layers this server queries. |
TDQS
Scored across 10 tools
Several tools overlap: energy_find_power_plants covers all plant types, while the specific find tools (wind, hydro, PV, biogas) duplicate the same search for a single category. Although descriptions clarify the extra details each specific tool provides, an agent could select the wrong one for a given task. Other tools like energy_solar_potential and energy_check_status are clearly distinct.
The energy_find_* tools follow a consistent verb_noun pattern, but energy_solar_potential and energy_location_profile use noun phrases, and energy_search_bfe_datasets uses 'search' instead of 'find'. This mix of conventions is readable but not fully consistent.
With 10 tools, the server is well-scoped within the ideal 3-15 range. Each tool covers a distinct aspect of Swiss energy data queries, and none feel redundant or unnecessary.
The server provides comprehensive location-based energy data queries, including a convenient aggregation tool (energy_location_profile). Minor gaps exist: biogas is not explicitly included in the location profile, and there is no direct lookup by plant identifier. Overall, the core domain is well covered.