Swiss Health MCP Server

Instructions

Implementation Reference

• src/index.ts:269-356 (handler)

  The main handler function executing the tool logic: resolves insurer names to IDs using helper functions, queries the premiums table in Supabase for matching criteria, selects the cheapest model per insurer, sorts by price, and returns a formatted markdown table comparison with price difference and disclaimer.
  async function compareInsurers(params: { insurer_names: string[]; canton: string; year: number; age_band: string; franchise_chf: number; }): Promise<string> { const db = getSupabase(); const { insurer_names, canton, year, age_band, franchise_chf } = params; // Finde ALLE Versicherer-IDs für jeden Namen (z.B. Helsana hat 0312, 1322, 1479, 1568) const matchedInsurers: { searchName: string; ids: string[]; primaryId: string | undefined }[] = insurer_names.map(searchName => ({ searchName, ids: findAllInsurerIds(searchName), primaryId: findInsurerIdByName(searchName) })); // Sammle alle IDs und tracke welche zu welchem Namen gehören const allIds: string[] = []; const idToSearchName = new Map<string, string>(); for (const m of matchedInsurers) { for (const id of m.ids) { allIds.push(id); idToSearchName.set(id, m.searchName); } } const notFound = matchedInsurers.filter(m => m.ids.length === 0).map(m => m.searchName); if (allIds.length === 0) { return `⚠️ Keine der Versicherer gefunden: ${insurer_names.join(", ")}\n\nVerfügbare Versicherer: CSS, Helsana, Swica, Assura, Concordia, Sanitas, KPT, ÖKK, Visana, Groupe Mutuel, Sympany, Atupri, EGK, Aquilana, Galenos`; } // Hole Prämien für ALLE IDs const { data: premiums, error } = await db .from("premiums") .select("insurer_id, monthly_premium_chf, model_type") .eq("canton", canton.toUpperCase()) .eq("year", year) .eq("age_band", age_band) .eq("franchise_chf", franchise_chf) .in("insurer_id", allIds); if (error || !premiums || premiums.length === 0) { return `❌ Keine Prämien gefunden für: ${canton}, ${year}\n\nGesuchte IDs: ${allIds.join(", ")}`; } // Gruppiere nach SUCHNAME (nimm günstigsten Tarif pro Versicherer) const bestByName = new Map<string, { premium: number; model: string; id: string }>(); for (const p of premiums) { const searchName = idToSearchName.get(p.insurer_id) || p.insurer_id; const existing = bestByName.get(searchName); if (!existing || p.monthly_premium_chf < existing.premium) { bestByName.set(searchName, { premium: p.monthly_premium_chf, model: p.model_type, id: p.insurer_id }); } } // Formatiere Ergebnis let result = `📊 Versicherungsvergleich\n`; result += `📍 ${canton} | ${year} | ${age_band} | CHF ${franchise_chf} Franchise\n\n`; const sorted = [...bestByName.entries()] .sort((a, b) => a[1].premium - b[1].premium); sorted.forEach(([searchName, data], index) => { const displayName = getInsurerName(data.id); result += `${index + 1}. ${displayName}: CHF ${data.premium.toFixed(2)}/Monat (${data.model})\n`; }); if (notFound.length > 0) { result += `\n⚠️ Nicht gefunden: ${notFound.join(", ")}\n`; } if (sorted.length >= 2) { const diff = sorted[sorted.length - 1][1].premium - sorted[0][1].premium; result += `\n💰 Differenz günstigste/teuerste: CHF ${diff.toFixed(2)}/Monat\n`; } result += DISCLAIMER; return result; }
• src/index.ts:162-172 (schema)

  Input schema for validating tool parameters: requires array of insurer names, canton code, year, age band, and franchise amount.
  inputSchema: { type: "object" as const, properties: { insurer_names: { type: "array", items: { type: "string" }, description: "Liste von Versicherer-Namen (z.B. ['CSS', 'Helsana', 'Swica'])" }, canton: { type: "string", description: "Kanton (2-Buchstaben-Code)" }, year: { type: "number", description: "Jahr (2016-2026)" }, age_band: { type: "string", enum: ["child", "young_adult", "adult"], description: "Altersgruppe" }, franchise_chf: { type: "number", description: "Franchise in CHF" } }, required: ["insurer_names", "canton", "year", "age_band", "franchise_chf"] }
• src/index.ts:159-173 (registration)

  Tool registration in the TOOLS array used for ListToolsRequestSchema response, defining name, description, and inputSchema.
  { name: "compare_insurers", description: "Vergleicht mehrere Versicherer für ein bestimmtes Profil.", inputSchema: { type: "object" as const, properties: { insurer_names: { type: "array", items: { type: "string" }, description: "Liste von Versicherer-Namen (z.B. ['CSS', 'Helsana', 'Swica'])" }, canton: { type: "string", description: "Kanton (2-Buchstaben-Code)" }, year: { type: "number", description: "Jahr (2016-2026)" }, age_band: { type: "string", enum: ["child", "young_adult", "adult"], description: "Altersgruppe" }, franchise_chf: { type: "number", description: "Franchise in CHF" } }, required: ["insurer_names", "canton", "year", "age_band", "franchise_chf"] } },
• src/index.ts:498-500 (registration)

  Dispatch registration in the switch statement within CallToolRequestSchema handler, mapping tool name to the compareInsurers function call.
  case "compare_insurers": result = await compareInsurers(args as any); break;
• src/index.ts:98-109 (helper)

  Helper function to find all insurer IDs matching a search name (handles multiple IDs per insurer), crucially used in the handler for comprehensive comparison.
  function findAllInsurerIds(searchName: string): string[] { const search = searchName.toLowerCase().trim(); const ids: string[] = []; for (const [id, name] of Object.entries(INSURER_NAMES)) { if (name.toLowerCase().includes(search) || search.includes(name.toLowerCase())) { ids.push(id); } } return ids; }