mcp-swiss

Instructions

Implementation Reference

• src/modules/energy.ts:365-405 (handler)

  The handler implementation for 'search_municipality_energy' which performs a GraphQL query to fetch municipality IDs.

  case "search_municipality_energy": {
    const nameQuery = args.name as string;
  
    if (!nameQuery?.trim()) {
      throw new Error("name is required");
    }
  
    const query = `
      query Municipalities($locale: String!, $query: String) {
        municipalities: searchMunicipalities(locale: $locale, query: $query) {
          id
          name
        }
      }
    `;
  
    const data = await gql<{ municipalities: MunicipalityResult[] }>(query, {
      locale: "de",
      query: nameQuery,
    });
  
    const municipalities = data.municipalities ?? [];
  
    if (!municipalities.length) {
      return JSON.stringify({
        results: [],
        message: `No municipalities found matching "${nameQuery}". Try a shorter or alternate spelling.`,
      }, null, 2);
    }
  
    return JSON.stringify({
      results: municipalities.map((m) => ({
        id: m.id,
        name: m.name,
        usage: `Use id "${m.id}" with get_electricity_tariff or compare_electricity_tariffs`,
      })),
      count: municipalities.length,
      note: "Use the 'id' field as the 'municipality' parameter in tariff queries.",
      source: "https://www.strompreis.elcom.admin.ch",
    }, null, 2);
  }

• src/modules/energy.ts:140-154 (schema)

  The registration and input schema definition for 'search_municipality_energy'.

  {
    name: "search_municipality_energy",
    description:
      "Search for Swiss municipality IDs needed for electricity tariff lookup. Returns BFS municipality numbers for use with get_electricity_tariff and compare_electricity_tariffs.",
    inputSchema: {
      type: "object",
      required: ["name"],
      properties: {
        name: {
          type: "string",
          description: "Municipality name to search (e.g. 'Zürich', 'Bern', 'Basel', 'Lausanne', 'Luzern').",
        },
      },
    },
  },