@gera-services/mcp-gera-clinic 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gera-services/mcp-gera-clinic",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for GeraClinic telemedicine platform — search doctors, check availability, and book medical appointments across 50+ countries",
   "mcpName": "io.github.geraservicesuk/mcp-gera-clinic",
   "main": "dist/server.js",

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.geraservicesuk/mcp-gera-clinic",
-  "description": "Search doctors, check availability, book medical appointments. 7 tools. 50+ countries.",
+  "description": "Telemedicine MCP server for GeraClinic. Search doctors by specialty and language, check real-time availability, book and reschedule video consultations, run symptom triage, request prescriptions, and manage patient records. Works in 50+ countries with support for Armenian, Georgian, Azerbaijani, Russian, Swahili, and English. 7 tools: search_doctors, get_doctor, check_availability, book_appointment, cancel_appointment, run_symptom_triage, list_specialties. Public read; booking requires OAuth.",
   "repository": {
     "url": "https://github.com/geraservicesuk/mcp-gera-clinic",
     "source": "github"

package/dist/index.js

@@ -1,28 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var index_exports = {};
-__export(index_exports, {
-  server: () => import_server.server
-});
-module.exports = __toCommonJS(index_exports);
-var import_server = require("./server.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  server
-});

package/dist/server.js

@@ -1,325 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var server_exports = {};
-__export(server_exports, {
-  server: () => server
-});
-module.exports = __toCommonJS(server_exports);
-var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
-var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
-var import_zod = require("zod");
-const API_BASE = process.env.GERACLINIC_API_URL || "https://api.geraclinic.com";
-async function apiCall(path, options = {}) {
-  const res = await fetch(`${API_BASE}${path}`, {
-    ...options,
-    headers: {
-      "Content-Type": "application/json",
-      "X-MCP-Client": "mcp-gera-clinic/1.0.0",
-      ...options.headers
-    }
-  });
-  if (!res.ok) {
-    throw new Error(`API error ${res.status}: ${await res.text()}`);
-  }
-  return res.json();
-}
-const server = new import_mcp.McpServer({
-  name: "gera-clinic",
-  version: "1.0.0"
-});
-server.tool(
-  "search_doctors",
-  "Search for doctors by specialty, location, and availability. Returns a list of verified doctors with their ratings, languages, consultation fees, and appointment types (video, in-person, chat).",
-  {
-    specialty: import_zod.z.string().optional().describe('Medical specialty (e.g., "cardiology", "dermatology", "general-practice")'),
-    country: import_zod.z.string().optional().describe('ISO 3166-1 alpha-2 country code (e.g., "GE", "UG", "GH")'),
-    language: import_zod.z.string().optional().describe('Preferred language (e.g., "en", "ka", "fr")'),
-    appointment_type: import_zod.z.enum(["VIDEO", "IN_PERSON", "CHAT"]).optional().describe("Type of consultation"),
-    min_rating: import_zod.z.number().min(0).max(5).optional().describe("Minimum doctor rating (0-5)"),
-    page: import_zod.z.number().int().positive().optional().describe("Page number for pagination"),
-    limit: import_zod.z.number().int().min(1).max(50).optional().describe("Results per page (max 50)")
-  },
-  async (params) => {
-    const query = new URLSearchParams();
-    if (params.specialty) query.set("specialty", params.specialty);
-    if (params.language) query.set("language", params.language);
-    if (params.appointment_type) query.set("appointment_type", params.appointment_type);
-    if (params.min_rating !== void 0) query.set("min_rating", String(params.min_rating));
-    if (params.page) query.set("page", String(params.page));
-    if (params.limit) query.set("limit", String(params.limit));
-    const headers = {};
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const result = await apiCall(`/doctors?${query}`, { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "get_doctor_profile",
-  "Get detailed profile for a specific doctor including bio, qualifications, languages, consultation fees, and supported appointment types.",
-  {
-    doctor_id: import_zod.z.string().uuid().describe("Doctor UUID"),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code")
-  },
-  async (params) => {
-    const headers = {};
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const result = await apiCall(`/doctors/${params.doctor_id}`, { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "get_available_slots",
-  "Get available appointment time slots for a specific doctor on a given date. Returns a list of open slots with start/end times.",
-  {
-    doctor_id: import_zod.z.string().uuid().describe("Doctor UUID"),
-    date: import_zod.z.string().describe("Date in ISO format YYYY-MM-DD"),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code")
-  },
-  async (params) => {
-    const headers = {};
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const result = await apiCall(`/doctors/${params.doctor_id}/slots?date=${params.date}`, { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "list_specialties",
-  "List all medical specialties available in a given country. Useful for discovering what types of doctors are available before searching.",
-  {
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code")
-  },
-  async (params) => {
-    const headers = {};
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const result = await apiCall("/doctors/specialties", { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "get_featured_doctors",
-  "Get top-rated, verified doctors. Useful for recommending the best available doctors to users.",
-  {
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code"),
-    limit: import_zod.z.number().int().min(1).max(20).optional().describe("Number of featured doctors to return")
-  },
-  async (params) => {
-    const headers = {};
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const query = params.limit ? `?limit=${params.limit}` : "";
-    const result = await apiCall(`/doctors/featured${query}`, { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "get_health_services",
-  "Get all health service types available in a specific country on GeraClinic. Returns services such as telemedicine video consultations, in-person appointments, pharmacy delivery, lab test booking, and home nursing.",
-  {
-    country: import_zod.z.string().describe('ISO 3166-1 alpha-2 country code (e.g., "GB", "US", "GE", "KE")')
-  },
-  async (params) => {
-    const headers = {
-      "X-Tenant-ID": params.country
-    };
-    const result = await apiCall("/health-services", { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "book_appointment",
-  "Book a medical appointment with a doctor. Requires authentication. Returns booking confirmation with payment URL if applicable.",
-  {
-    doctor_id: import_zod.z.string().uuid().describe("Doctor UUID"),
-    date: import_zod.z.string().describe("Appointment date in ISO format YYYY-MM-DD"),
-    start_time: import_zod.z.string().describe("Start time in HH:MM format"),
-    end_time: import_zod.z.string().describe("End time in HH:MM format"),
-    appointment_type: import_zod.z.enum(["VIDEO", "IN_PERSON", "CHAT"]).describe("Type of consultation"),
-    reason: import_zod.z.string().optional().describe("Reason for visit / symptoms"),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code"),
-    auth_token: import_zod.z.string().describe("User bearer token for authentication")
-  },
-  async (params) => {
-    const headers = {
-      Authorization: `Bearer ${params.auth_token}`
-    };
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const result = await apiCall("/appointments", {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        doctor_id: params.doctor_id,
-        date: params.date,
-        start_time: params.start_time,
-        end_time: params.end_time,
-        type: params.appointment_type,
-        reason: params.reason
-      })
-    });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "get_my_appointments",
-  "List upcoming and past appointments for the authenticated patient. Returns appointments with doctor info, date/time, status, and consultation type. Use this to check a patient's appointment history or upcoming schedule.",
-  {
-    status: import_zod.z.enum(["upcoming", "completed", "cancelled"]).optional().describe("Filter by appointment status. Omit to return all."),
-    from_date: import_zod.z.string().optional().describe("Filter appointments from this date (ISO format YYYY-MM-DD)"),
-    to_date: import_zod.z.string().optional().describe("Filter appointments up to this date (ISO format YYYY-MM-DD)"),
-    page: import_zod.z.number().int().positive().optional().describe("Page number for pagination"),
-    limit: import_zod.z.number().int().min(1).max(50).optional().describe("Results per page (max 50)"),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code"),
-    auth_token: import_zod.z.string().describe("User bearer token for authentication")
-  },
-  async (params) => {
-    const headers = {
-      Authorization: `Bearer ${params.auth_token}`
-    };
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const query = new URLSearchParams();
-    if (params.status) query.set("status", params.status);
-    if (params.from_date) query.set("from_date", params.from_date);
-    if (params.to_date) query.set("to_date", params.to_date);
-    if (params.page) query.set("page", String(params.page));
-    if (params.limit) query.set("limit", String(params.limit));
-    const result = await apiCall(`/appointments?${query}`, { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "cancel_appointment",
-  "Cancel an existing appointment. Requires authentication. Returns cancellation confirmation and refund details if applicable. Must be called at least 1 hour before the scheduled appointment time.",
-  {
-    appointment_id: import_zod.z.string().uuid().describe("Appointment UUID to cancel"),
-    reason: import_zod.z.string().optional().describe("Reason for cancellation (helps improve the platform)"),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code"),
-    auth_token: import_zod.z.string().describe("User bearer token for authentication")
-  },
-  async (params) => {
-    const headers = {
-      Authorization: `Bearer ${params.auth_token}`
-    };
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const result = await apiCall(`/appointments/${params.appointment_id}/cancel`, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ reason: params.reason })
-    });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "get_lab_results",
-  "Retrieve lab test results for the authenticated patient. Returns digitally signed diagnostic reports including blood work, imaging, and other diagnostic results. Results are returned as structured data with normal ranges and doctor notes.",
-  {
-    result_id: import_zod.z.string().uuid().optional().describe("Specific lab result UUID. Omit to list all results."),
-    from_date: import_zod.z.string().optional().describe("Filter results from this date (ISO format YYYY-MM-DD)"),
-    to_date: import_zod.z.string().optional().describe("Filter results up to this date (ISO format YYYY-MM-DD)"),
-    test_type: import_zod.z.string().optional().describe('Filter by test type (e.g., "blood-panel", "urine", "imaging", "ecg")'),
-    page: import_zod.z.number().int().positive().optional().describe("Page number for pagination (when listing all results)"),
-    limit: import_zod.z.number().int().min(1).max(50).optional().describe("Results per page (max 50)"),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code"),
-    auth_token: import_zod.z.string().describe("User bearer token for authentication")
-  },
-  async (params) => {
-    const headers = {
-      Authorization: `Bearer ${params.auth_token}`
-    };
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    if (params.result_id) {
-      const result2 = await apiCall(`/lab-results/${params.result_id}`, { headers });
-      return { content: [{ type: "text", text: JSON.stringify(result2, null, 2) }] };
-    }
-    const query = new URLSearchParams();
-    if (params.from_date) query.set("from_date", params.from_date);
-    if (params.to_date) query.set("to_date", params.to_date);
-    if (params.test_type) query.set("test_type", params.test_type);
-    if (params.page) query.set("page", String(params.page));
-    if (params.limit) query.set("limit", String(params.limit));
-    const result = await apiCall(`/lab-results?${query}`, { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "order_medication",
-  "Order medication from a pharmacy via GeraClinic. Can be linked to a doctor's prescription or ordered as OTC (over-the-counter). Requires authentication. Returns order confirmation with estimated delivery time and pharmacy details.",
-  {
-    prescription_id: import_zod.z.string().uuid().optional().describe("Prescription UUID from a GeraClinic doctor \u2014 required for prescription-only medications"),
-    items: import_zod.z.array(import_zod.z.object({
-      medication_name: import_zod.z.string().describe('Medication name (e.g., "Paracetamol 500mg", "Amoxicillin 250mg")'),
-      quantity: import_zod.z.number().int().positive().describe("Number of units/packs to order"),
-      notes: import_zod.z.string().optional().describe('Additional instructions (e.g., "brand preferred: X")')
-    })).min(1).describe("List of medications to order"),
-    delivery_address: import_zod.z.string().describe("Full delivery address for the medication"),
-    pharmacy_id: import_zod.z.string().uuid().optional().describe("Preferred pharmacy UUID. If omitted, the nearest available pharmacy is selected automatically."),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code"),
-    auth_token: import_zod.z.string().describe("User bearer token for authentication")
-  },
-  async (params) => {
-    const headers = {
-      Authorization: `Bearer ${params.auth_token}`
-    };
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const result = await apiCall("/pharmacy/orders", {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        prescription_id: params.prescription_id,
-        items: params.items,
-        delivery_address: params.delivery_address,
-        pharmacy_id: params.pharmacy_id
-      })
-    });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-server.tool(
-  "search_pharmacies",
-  "Find pharmacies near a location that deliver medications via GeraClinic. Returns pharmacies with their operating hours, delivery radius, and available payment methods.",
-  {
-    lat: import_zod.z.number().optional().describe("Latitude for proximity search"),
-    lng: import_zod.z.number().optional().describe("Longitude for proximity search"),
-    city: import_zod.z.string().optional().describe("City name to search within"),
-    country: import_zod.z.string().optional().describe("ISO 3166-1 alpha-2 country code"),
-    open_now: import_zod.z.boolean().optional().describe("Filter to only show pharmacies currently open"),
-    page: import_zod.z.number().int().positive().optional().describe("Page number"),
-    limit: import_zod.z.number().int().min(1).max(50).optional().describe("Results per page (max 50)")
-  },
-  async (params) => {
-    const headers = {};
-    if (params.country) headers["X-Tenant-ID"] = params.country;
-    const query = new URLSearchParams();
-    if (params.lat !== void 0) query.set("lat", String(params.lat));
-    if (params.lng !== void 0) query.set("lng", String(params.lng));
-    if (params.city) query.set("city", params.city);
-    if (params.open_now !== void 0) query.set("open_now", String(params.open_now));
-    if (params.page) query.set("page", String(params.page));
-    if (params.limit) query.set("limit", String(params.limit));
-    const result = await apiCall(`/pharmacies?${query}`, { headers });
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-async function main() {
-  const transport = new import_stdio.StdioServerTransport();
-  await server.connect(transport);
-  console.error("GeraClinic MCP server running on stdio");
-}
-main().catch(console.error);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  server
-});