# GeraClinic MCP Server

> 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.) 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 (all offline, no authentication)

- 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.

## Data & Disclaimers

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 -y @gera-services/mcp-gera-clinic
```

Claude Desktop config (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "gera-clinic": {
      "command": "npx",
      "args": ["-y", "@gera-services/mcp-gera-clinic"]
    }
  }
}
```

## About GeraClinic

GeraClinic is a product of [Gera Systems](https://gera.services).

- Homepage: https://geraclinic.com
- MCP Package: https://www.npmjs.com/package/@gera-services/mcp-gera-clinic
- MCP Registry: io.github.geraservicesuk/mcp-gera-clinic