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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @gera-services/mcp-gera-clinic
+ *
+ * MCP server for GeraClinic — find CQC-registered UK care/health providers,
+ * read area care statistics, and run non-diagnostic health calculators, all
+ * offline. Re-exports the server and start function for programmatic use.
+ *
+ * @packageDocumentation
+ */
+export { server, main } from './server.js';

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @gera-services/mcp-gera-clinic
+ *
+ * MCP server for GeraClinic — find CQC-registered UK care/health providers,
+ * read area care statistics, and run non-diagnostic health calculators, all
+ * offline. Re-exports the server and start function for programmatic use.
+ *
+ * @packageDocumentation
+ */
+export { server, main } from './server.js';

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+/**
+ * GeraClinic MCP Server (stdio)
+ *
+ * Exposes GeraClinic's real UK healthcare-provider directory (Care Quality
+ * Commission registered locations) and its non-diagnostic health calculators to
+ * AI agents over the Model Context Protocol. Everything is computed locally from
+ * a bundled snapshot of real CQC data and pure reference math — no backend, no
+ * network, no auth required — so an agent (Claude, ChatGPT with tools, any MCP
+ * client) can find a care provider, read area care statistics, and run a health
+ * calculator entirely offline.
+ *
+ * Product: GeraClinic — https://geraclinic.com (a Gera Systems product)
+ * Data: Care Quality Commission www.cqc.org.uk, Open Government Licence v3.0.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const server: McpServer;
+export declare function main(): Promise<void>;

package/dist/server.js

@@ -0,0 +1,257 @@
+/**
+ * GeraClinic MCP Server (stdio)
+ *
+ * Exposes GeraClinic's real UK healthcare-provider directory (Care Quality
+ * Commission registered locations) and its non-diagnostic health calculators to
+ * AI agents over the Model Context Protocol. Everything is computed locally from
+ * a bundled snapshot of real CQC data and pure reference math — no backend, no
+ * network, no auth required — so an agent (Claude, ChatGPT with tools, any MCP
+ * client) can find a care provider, read area care statistics, and run a health
+ * calculator entirely offline.
+ *
+ * Product: GeraClinic — https://geraclinic.com (a Gera Systems product)
+ * Data: Care Quality Commission www.cqc.org.uk, Open Government Licence v3.0.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { CQC_META, CQC_AUTHORITIES, CQC_ATTRIBUTION, SERVICE_TYPES, ALL_PROVIDERS, searchProviders, findArea, } from './cqc.js';
+import { CALCULATORS, bmi, bmrTdee, idealWeightKg, bloodPressureCategory, heartRateZones, a1c, waterIntakeLitres, waistToHeight, } from './calculators.js';
+export const server = new McpServer({
+    name: 'gera-clinic',
+    version: '1.0.0',
+});
+function asText(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    };
+}
+const CQC_DISCLAIMER = 'Directory of CQC-registered locations. CQC ratings are categorical (Outstanding/Good/Requires improvement/Inadequate), never numeric. Verify details on cqc.org.uk before relying on them. Source: Care Quality Commission, Open Government Licence v3.0.';
+// ── Tool 1: find_care_provider ───────────────────────────────────────────────
+// Search the real CQC dataset by name / postcode / service type / area.
+server.registerTool('find_care_provider', {
+    title: 'Find a CQC-registered care or health provider',
+    description: "Search GeraClinic's directory of real Care Quality Commission (CQC) registered UK providers — GP surgeries, dentists, hospitals, clinics, care/nursing homes, hospices, urgent-care centres and more. Filter by name, postcode (full or outward, e.g. 'TN12'), service type (e.g. 'Dentist', 'Doctors/GPs', 'Hospital'), and/or local authority (e.g. 'kent'). Returns provider name, address, postcode, phone, website, service types and last-inspected date. All filters are AND-combined; omit any. Offline — real CQC records only.",
+    inputSchema: {
+        query: z.string().optional().describe('Provider or organisation name substring.'),
+        postcode: z
+            .string()
+            .optional()
+            .describe('Full postcode or outward code, e.g. "TN12 6AX" or "TN12".'),
+        serviceType: z
+            .string()
+            .optional()
+            .describe('Service type, e.g. "Dentist", "Doctors/GPs", "Hospital", "Nursing homes".'),
+        authority: z
+            .string()
+            .optional()
+            .describe('Local authority slug or name, e.g. "kent", "Essex".'),
+        limit: z.number().int().min(1).max(50).optional().describe('Max results (default 10).'),
+    },
+}, async ({ query, postcode, serviceType, authority, limit }) => {
+    const results = searchProviders({
+        query,
+        postcode,
+        serviceType,
+        authority,
+        limit: limit ?? 10,
+    });
+    return asText({
+        query: {
+            query: query ?? null,
+            postcode: postcode ?? null,
+            serviceType: serviceType ?? null,
+            authority: authority ?? null,
+        },
+        count: results.length,
+        providers: results.map((r) => ({
+            cqc_location_id: r.provider.cqcLocationId,
+            name: r.provider.name,
+            provider_name: r.provider.providerName,
+            address: r.provider.address,
+            postcode: r.provider.postcode,
+            phone: r.provider.phone,
+            website: r.provider.website,
+            service_types: r.provider.serviceTypes,
+            last_inspected: r.provider.lastInspected,
+            cqc_profile_url: `https://www.cqc.org.uk/location/${r.provider.cqcLocationId}`,
+            authority: r.authorityName,
+            region: r.region,
+        })),
+        disclaimer: CQC_DISCLAIMER,
+    });
+});
+// ── Tool 2: get_cqc_area_stats ───────────────────────────────────────────────
+// Aggregated, real CQC statistics for an authority or locality.
+server.registerTool('get_cqc_area_stats', {
+    title: 'Get CQC care statistics for a UK area',
+    description: "Return GeraClinic's aggregated Care Quality Commission statistics for a UK local authority or locality (e.g. 'kent', 'essex'). Includes total registered providers, how many publish a phone number / website, the breakdown by service type (GPs, dentists, care homes, hospitals, etc.) with counts and percentages, the most common service type, and the latest inspection date in the area. Use list_care_authorities first to discover valid area names. Real CQC data, offline.",
+    inputSchema: {
+        area: z
+            .string()
+            .describe('Authority or locality slug/name, e.g. "kent", "essex", "surrey".'),
+    },
+}, async ({ area }) => {
+    const found = findArea(area);
+    if (!found) {
+        return asText({
+            error: `No CQC area found for "${area}". Call list_care_authorities to see valid areas.`,
+        });
+    }
+    const a = found.area;
+    return asText({
+        area: 'name' in a ? a.name : a.slug,
+        kind: found.kind,
+        authority: found.authorityName,
+        region: 'region' in a ? a.region : null,
+        stats: {
+            total_providers: a.stats.total,
+            with_phone: a.stats.withPhone,
+            with_phone_pct: a.stats.withPhonePct,
+            with_website: a.stats.withWebsite,
+            top_service_type: a.stats.topServiceType,
+            latest_inspection: a.stats.latestCheck,
+            service_type_breakdown: a.stats.serviceTypes.map((s) => ({
+                type: s.type,
+                count: s.count,
+                pct: s.pct,
+            })),
+        },
+        disclaimer: CQC_DISCLAIMER,
+    });
+});
+// ── Tool 3: list_care_authorities ────────────────────────────────────────────
+// Discover the areas available, optionally filtered by region.
+server.registerTool('list_care_authorities', {
+    title: 'List UK areas covered by the CQC directory',
+    description: "List the UK local authorities GeraClinic's CQC directory covers, with the number of registered providers and the top service type in each. Optionally filter by region (e.g. 'London', 'South East', 'North West'). Use this to find a valid `area` value for get_cqc_area_stats or an `authority` for find_care_provider.",
+    inputSchema: {
+        region: z.string().optional().describe('Filter by region, e.g. "London", "South East".'),
+    },
+}, async ({ region }) => {
+    const rNorm = region ? region.toLowerCase().trim() : null;
+    const authorities = CQC_AUTHORITIES.filter((a) => !rNorm || (a.region ?? '').toLowerCase() === rNorm).map((a) => ({
+        slug: a.slug,
+        name: a.name,
+        region: a.region,
+        total_providers: a.stats.total,
+        top_service_type: a.stats.topServiceType,
+        localities: a.localities.length,
+    }));
+    return asText({
+        dataset: {
+            total_providers_indexed: CQC_META.totalProviders,
+            total_localities: CQC_META.totalLocalities,
+            generated_at: CQC_META.generatedAt,
+            attribution: CQC_ATTRIBUTION,
+            attribution_url: CQC_META.attributionUrl,
+        },
+        region_filter: region ?? null,
+        count: authorities.length,
+        service_types_available: SERVICE_TYPES,
+        authorities,
+    });
+});
+// ── Tool 4: list_health_calculators ──────────────────────────────────────────
+server.registerTool('list_health_calculators', {
+    title: 'List GeraClinic health calculators',
+    description: 'List the health calculators available via run_health_calculator — BMI, BMR/TDEE calories, ideal weight, blood-pressure category, heart-rate zones, A1C↔glucose, water intake, and waist-to-height ratio — each with its id, required inputs, and the public reference standard it uses. All are objective and non-diagnostic.',
+    inputSchema: {},
+}, async () => asText({
+    count: CALCULATORS.length,
+    calculators: CALCULATORS,
+    note: 'Objective reference math only — educational, not a diagnosis or prescription.',
+}));
+// ── Tool 5: run_health_calculator ────────────────────────────────────────────
+server.registerTool('run_health_calculator', {
+    title: 'Run a GeraClinic health calculator',
+    description: "Run one of GeraClinic's non-diagnostic health calculators and return the result. Pick `calculator` (see list_health_calculators) and pass the metric inputs it needs (heights in cm, weights in kg). Examples: bmi {weightKg, heightCm}; bmr_tdee {weightKg, heightCm, ageYears, sex, activity}; ideal_weight {heightCm, sex}; blood_pressure {systolic, diastolic}; heart_rate_zones {ageYears}; a1c {a1cPercent} or {avgGlucoseMgDl}; water_intake {weightKg, activityMinutes?}; waist_to_height {waistCm, heightCm}. Results are educational reference values, not medical advice.",
+    inputSchema: {
+        calculator: z
+            .enum([
+            'bmi',
+            'bmr_tdee',
+            'ideal_weight',
+            'blood_pressure',
+            'heart_rate_zones',
+            'a1c',
+            'water_intake',
+            'waist_to_height',
+        ])
+            .describe('Which calculator to run.'),
+        weightKg: z.number().positive().optional(),
+        heightCm: z.number().positive().optional(),
+        ageYears: z.number().int().positive().optional(),
+        sex: z.enum(['male', 'female']).optional(),
+        activity: z.enum(['sedentary', 'light', 'moderate', 'active', 'very_active']).optional(),
+        systolic: z.number().positive().optional(),
+        diastolic: z.number().positive().optional(),
+        a1cPercent: z.number().positive().optional(),
+        avgGlucoseMgDl: z.number().positive().optional(),
+        activityMinutes: z.number().min(0).optional(),
+        waistCm: z.number().positive().optional(),
+    },
+}, async (args) => {
+    const need = (cond, msg) => {
+        if (!cond)
+            throw new Error(msg);
+    };
+    let result;
+    switch (args.calculator) {
+        case 'bmi':
+            need(args.weightKg != null && args.heightCm != null, 'bmi requires weightKg and heightCm');
+            result = bmi(args.weightKg, args.heightCm);
+            break;
+        case 'bmr_tdee':
+            need(args.weightKg != null &&
+                args.heightCm != null &&
+                args.ageYears != null &&
+                args.sex != null &&
+                args.activity != null, 'bmr_tdee requires weightKg, heightCm, ageYears, sex, activity');
+            result = bmrTdee(args.weightKg, args.heightCm, args.ageYears, args.sex, args.activity);
+            break;
+        case 'ideal_weight':
+            need(args.heightCm != null && args.sex != null, 'ideal_weight requires heightCm and sex');
+            result = idealWeightKg(args.heightCm, args.sex);
+            break;
+        case 'blood_pressure':
+            need(args.systolic != null && args.diastolic != null, 'blood_pressure requires systolic and diastolic');
+            result = bloodPressureCategory(args.systolic, args.diastolic);
+            break;
+        case 'heart_rate_zones':
+            need(args.ageYears != null, 'heart_rate_zones requires ageYears');
+            result = heartRateZones(args.ageYears);
+            break;
+        case 'a1c':
+            need(args.a1cPercent != null || args.avgGlucoseMgDl != null, 'a1c requires a1cPercent or avgGlucoseMgDl');
+            result = a1c(args.a1cPercent, args.avgGlucoseMgDl);
+            break;
+        case 'water_intake':
+            need(args.weightKg != null, 'water_intake requires weightKg');
+            result = waterIntakeLitres(args.weightKg, args.activityMinutes ?? 0);
+            break;
+        case 'waist_to_height':
+            need(args.waistCm != null && args.heightCm != null, 'waist_to_height requires waistCm and heightCm');
+            result = waistToHeight(args.waistCm, args.heightCm);
+            break;
+    }
+    return asText({
+        calculator: args.calculator,
+        result,
+        disclaimer: 'Educational reference value only — not a medical diagnosis, treatment, or prescription. Consult a clinician for personal advice.',
+    });
+});
+// ── Start ────────────────────────────────────────────────────────────────────
+export async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stderr only — stdout is the MCP transport.
+    console.error(`GeraClinic MCP server running on stdio (gera-clinic v1.0.0) — ${ALL_PROVIDERS.length} CQC providers indexed`);
+}
+const isMain = typeof process !== 'undefined' && process.argv[1] && /server\.js$/.test(process.argv[1]);
+if (isMain) {
+    main().catch((err) => {
+        console.error('Fatal:', err);
+        process.exit(1);
+    });
+}

package/llms.txt

@@ -1,34 +1,27 @@
 # GeraClinic MCP Server
 
-> AI-accessible telemedicine and healthcare API by Gera Services. Enables AI agents to search doctors, check availability, and book medical appointments across 50+ countries.
+> Offline MCP server by Gera Systems. Lets AI agents find CQC-registered UK care/health providers, read area care statistics, and run non-diagnostic health calculators — no backend, no network, no auth. Real Care Quality Commission data under the Open Government Licence v3.0.
 
 ## What This MCP Server Does
 
-The `@gera-services/mcp-gera-clinic` MCP server connects AI assistants (Claude, ChatGPT, Gemini, etc.) directly to [GeraClinic](https://geraclinic.com) — a worldwide telemedicine platform. Using this server, an AI agent can help a user find a doctor, check when they are available, and book a video, in-person, or chat consultation — without the user ever leaving their AI interface.
+The `@gera-services/mcp-gera-clinic` MCP server connects AI assistants (Claude, ChatGPT, Gemini, etc.) to [GeraClinic](https://geraclinic.com)'s real UK healthcare-provider directory and its published health-calculator math. Everything is computed locally from a bundled snapshot of real Care Quality Commission (CQC) data and pure reference formulas, so an agent can find a provider, read area care statistics, and run a health calculator entirely offline.
 
-## Available Tools
+## Available Tools (all offline, no authentication)
 
-### Read-Only (no authentication required)
+- find_care_provider: Search real CQC-registered UK providers (GP surgeries, dentists, hospitals, clinics, care/nursing homes, hospices, urgent care) by name, postcode (full or outward), service type, and/or local authority. Returns address, phone, website, service types, last-inspected date, and the CQC profile URL.
+- get_cqc_area_stats: Aggregated CQC statistics for a UK local authority or locality — total registered providers, phone/website coverage, service-type breakdown with counts and percentages, top service type, and latest inspection date.
+- list_care_authorities: List the UK areas the directory covers (optionally filtered by region) with provider counts and the available service types — used to discover valid area/authority values.
+- list_health_calculators: List the available health calculators with their inputs and the public reference standard each uses.
+- run_health_calculator: Run a calculator — BMI (WHO), BMR/TDEE (Mifflin-St Jeor), ideal weight (Devine/Robinson/Miller/Hamwi), blood-pressure category (ACC/AHA), heart-rate zones, A1C↔glucose (ADAG), water intake, or waist-to-height ratio. Objective, non-diagnostic reference values.
 
-- [search_doctors](https://geraclinic.com/find-doctor): Search verified doctors by specialty, country, language, appointment type (video/in-person/chat), and minimum rating. Supports pagination.
-- [get_doctor_profile](https://geraclinic.com/doctors): Get a full doctor profile — bio, qualifications, languages spoken, consultation fees, and supported appointment types.
-- [get_available_slots](https://geraclinic.com/book): Get open appointment time slots for a specific doctor on a given date.
-- [list_specialties](https://geraclinic.com/specialties): List all medical specialties available in a country (general practice, cardiology, dermatology, etc.).
-- [get_featured_doctors](https://geraclinic.com/featured): Get top-rated and verified doctors for a country.
-- [get_health_services](https://geraclinic.com/services): Get all health service types available in a country — telemedicine, pharmacy, lab tests, home nursing.
+## Data & Disclaimers
 
-### Authenticated (bearer token required)
-
-- [book_appointment](https://geraclinic.com/book): Book a medical consultation. Returns confirmation with payment URL if applicable.
-
-## Multi-Country Support
-
-Pass any ISO 3166-1 alpha-2 country code (e.g., `GB`, `US`, `AM`, `GE`, `UG`, `KE`, `NG`) via the `country` parameter. Each country may have different specialties, pricing, and appointment types available.
+Provider data: Care Quality Commission www.cqc.org.uk, licensed under the Open Government Licence v3.0. CQC ratings are categorical (Outstanding / Good / Requires improvement / Inadequate), never numeric. Health calculators are educational reference math, not a diagnosis or prescription.
 
 ## Installation & Integration
 
 ```bash
-npx @gera-services/mcp-gera-clinic
+npx -y @gera-services/mcp-gera-clinic
 ```
 
 Claude Desktop config (`claude_desktop_config.json`):
@@ -37,8 +30,7 @@ Claude Desktop config (`claude_desktop_config.json`):
   "mcpServers": {
     "gera-clinic": {
       "command": "npx",
-      "args": ["@gera-services/mcp-gera-clinic"],
-      "env": { "GERACLINIC_API_URL": "https://api.geraclinic.com" }
+      "args": ["-y", "@gera-services/mcp-gera-clinic"]
     }
   }
 }
@@ -46,9 +38,8 @@ Claude Desktop config (`claude_desktop_config.json`):
 
 ## About GeraClinic
 
-GeraClinic is a product of [Gera Services](https://gera.services). It provides telemedicine services across 50+ countries, connecting patients with verified doctors for video, in-person, and chat consultations. Specialties include general practice, cardiology, dermatology, pediatrics, mental health, and more.
+GeraClinic is a product of [Gera Systems](https://gera.services).
 
 - Homepage: https://geraclinic.com
-- API Docs: https://api.geraclinic.com/api/docs
 - MCP Package: https://www.npmjs.com/package/@gera-services/mcp-gera-clinic
 - MCP Registry: io.github.geraservicesuk/mcp-gera-clinic

package/package.json

@@ -1,58 +1,57 @@
 {
   "name": "@gera-services/mcp-gera-clinic",
-  "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",
+  "version": "1.0.0",
+  "description": "GeraClinic MCP server — find CQC-registered UK care/health providers, read area care statistics, and run non-diagnostic health calculators. Deterministic, offline, no auth. A Gera Systems product.",
+  "license": "MIT",
+  "type": "module",
   "main": "dist/server.js",
   "types": "dist/server.d.ts",
+  "mcpName": "io.github.geraservicesuk/mcp-gera-clinic",
   "bin": {
     "mcp-gera-clinic": "bin/cli.js"
   },
   "files": [
     "dist",
     "bin",
+    "server.json",
     "README.md",
     "LICENSE",
-    "server.json",
     "llms.txt"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "node build.mjs",
+    "build": "tsc --noCheck && mkdir -p dist/data && cp src/data/cqc-cluster.json dist/data/cqc-cluster.json",
     "type-check": "tsc --noEmit",
-    "dev": "tsc --watch --noCheck",
-    "start": "node dist/server.js",
-    "prepublishOnly": "npm run build"
+    "start": "node bin/cli.js",
+    "smoke": "node scripts/smoke.mjs"
   },
   "keywords": [
     "mcp",
     "model-context-protocol",
-    "ai",
     "healthcare",
-    "telemedicine",
+    "cqc",
+    "care-quality-commission",
+    "uk-health",
     "doctor-search",
-    "appointment-booking",
+    "health-calculators",
     "gera-clinic",
     "gera"
   ],
   "author": {
-    "name": "Gera Services",
+    "name": "Gera Systems",
     "email": "engineering@gera.services",
     "url": "https://gera.services"
   },
-  "license": "MIT",
+  "homepage": "https://geraclinic.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/geraservicesuk/mcp-gera-clinic"
+    "url": "https://github.com/geraservicesuk/globetura.git",
+    "directory": "packages/mcp-gera-clinic"
   },
-  "homepage": "https://geraclinic.com",
   "bugs": {
-    "url": "https://github.com/geraservicesuk/mcp-gera-clinic/issues"
-  },
-  "engines": {
-    "node": ">=18.0.0"
+    "url": "https://github.com/geraservicesuk/globetura/issues"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
@@ -60,7 +59,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.12.0",
-    "esbuild": "^0.28.0",
     "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=20"
   }
 }

package/server.json

@@ -1,27 +1,22 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.geraservicesuk/mcp-gera-clinic",
-  "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.",
+  "description": "Find CQC-registered UK care/health providers and run non-diagnostic health calculators (BMI, etc).",
+  "version": "1.0.0",
   "repository": {
-    "url": "https://github.com/geraservicesuk/mcp-gera-clinic",
-    "source": "github"
+    "url": "https://github.com/geraservicesuk/globetura",
+    "source": "github",
+    "subfolder": "packages/mcp-gera-clinic"
   },
-  "version": "0.1.0",
+  "websiteUrl": "https://geraclinic.com",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@gera-services/mcp-gera-clinic",
-      "version": "0.1.0",
+      "version": "1.0.0",
       "transport": {
         "type": "stdio"
-      },
-      "environmentVariables": [
-        {
-          "name": "GERACLINIC_API_URL",
-          "description": "Base URL for the GeraClinic API (defaults to https://api.geraclinic.com)",
-          "required": false
-        }
-      ]
+      }
     }
   ]
 }