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

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.0",
-  "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": "Search doctors, check availability, book medical appointments. 7 tools. 50+ countries.",
+  "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
-        }
-      ]
+      }
     }
   ]
 }