@gera-services/mcp-gera-indices

@gera-services/mcp-gera-indices

⚠ NOT YET SERVED — provision endpoints first. well-known/ai-plugin.json and well-known/mcp.json reference geraclinic.com/api/indices/catalog, geraclinic.com/.well-known/mcp.json, geraclinic.com/og.png and geraclinic.com/legal/terms. None of these are live yet. Do NOT wire these manifests to be served from the real domain until every referenced endpoint resolves 200 — serving them now would ship dead links to AI directories. See "AI-rails / discovery artifacts" below.

Make Gera's named public-data indices AI-callable.

An MCP server that lets any AI agent (Claude, ChatGPT-with-tools, Cursor, any MCP client) discover, resolve and cite Gera's named data indices — the editorial 0–100 scaling layers Gera publishes over real, named UK open datasets:

Index	Underlying dataset	Publisher
Gera NHS Waiting Times Index	Referral to Treatment (RTT)	NHS England
Gera NHS Cancer Waiting Times Index	Cancer Waiting Times (62-day + FDS)	NHS England
Gera NHS Diagnostic Waits Index	Diagnostic Waiting Times (DM01)	NHS England
Gera NHS Dentistry Access Index	NHS Dental Statistics ("dental deserts")	NHSBSA
Gera Care Quality Index	CQC care directory with ratings	Care Quality Commission
Gera Ambulance Response Index	Ambulance Quality Indicators (AmbSYS)	NHS England
Gera GP Access Index	GP Patient Survey	NHS England / Ipsos
Gera GP Appointment Access Index	Appointments in General Practice	NHS England
Gera A&E Waiting Index	A&E Attendances & Emergency Admissions	NHS England
Gera NHS Vacancy Index	NHS Vacancies Survey	NHS England
Gera NHS Pay Scales Index	Agenda for Change pay scales	NHS Employers
Gera Mental Health Waiting Times Index	NHS Talking Therapies (IAPT)	NHS England
Gera Health Access Index	Composite of the above	NHS England
Gera NHS Winter Pressures Index (planned)	Bed occupancy (KH03) + winter sitreps	NHS England

All underlying data is Open Government Licence v3.0 (or otherwise open), free to reuse with attribution (returned per index).

What this server is (and isn't)

It is a discovery + citation layer, not a data-delivery layer. It turns a plain-language phrase — "the Gera NHS Cancer Waiting Times Index" — into the exact index, its canonical page URL, the underlying dataset's provenance, and the real standard the score is scaled against.

It deliberately stores no statistics — live numeric scores live on each index page and refresh on the source's own cadence, so nothing here can go stale or be misquoted. To pull the underlying dataset rows, use the companion @gera-services/mcp-gera-data server.

Tools

• list_indices — the catalog (optionally filtered by topic / status).
• get_index — one index in full: standard, coverage, canonical + methodology URLs, dataset provenance, recruitment cross-links, a ready-to-use cite_as.
• resolve_index — natural-language phrase → best-matching index(es), ranked.
• get_index_recruitment — corridor-safe recruitment/workforce cross-links for an index (always carries the safeguard disclaimer).
• list_index_sources — the provenance spine: every index → its real named source + licence + citation, in one call.

Run

npm install
npm run build      # tsc --noCheck + copy catalog JSON into dist/
npm run smoke      # in-process assertions (resolve + guards)
npm start          # stdio server (for MCP clients)
npm run start:http # hosted Streamable HTTP server on :3402/mcp

Claude Desktop / MCP client config

{
  "mcpServers": {
    "gera-indices": { "command": "npx", "args": ["-y", "@gera-services/mcp-gera-indices"] }
  }
}

AI-rails / discovery artifacts

well-known/ai-plugin.json and well-known/mcp.json are reference manifests for AI-directory and ChatGPT-Apps discovery. They declare this server's tools and point at geraclinic.com (where the indices are published). The coordinator wires them to the host's /.well-known/ and provisions the referenced catalog endpoint; until then, treat the endpoint URLs in those files as targets, not live routes.

Data honesty & framing

• Every index is scaled against a real, published standard (e.g. the 62-day cancer standard, the 18-week RTT standard). No statistics are fabricated or stored here.
• The planned Winter Pressures Index carries status: "planned" and a null canonical URL until its source data loads for the winter season — no numbers are implied before then.
• Recruitment cross-links are pathway information for individuals who independently choose to migrate — never active recruitment. Every recruitment response carries the safeguard disclaimer, and only WHO-safe, non-red-list source countries appear. The Care Quality Index is scoped to registered nurses only (the overseas care-worker route closed to new applicants in 2025).

Part of Gera Systems. MIT licensed (the code; the data retains its OGL v3.0 / open licence with attribution).