pl.minoshealthPublished by minoshealth.plOfficial publisherv1.1.0Updated Oct 30, 2026
Polish ICD-10, ICD-9 PL, ICD-11 PL codes and NFZ JGP hospital grouping from official sources.
Remote MCP server for Polish ICD-10, ICD-9 PL, ICD-11 PL codes and NFZ JGP hospital grouping, including grouping an anonymised hospital stay.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/pl.minoshealth%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"minos-health": {
"type": "http",
"url": "https://minoshealth.pl/mcp"
}
}
}Minos is an explainable settlement intelligence platform for Polish hospital care. It combines versioned medical terminology (Polish ICD-10 and ICD-9 PL) with the NFZ JGP hospital grouping system: the group definitions, point catalogs, and grouper algorithm that determine how Polish hospitals are paid.
In Dante's Inferno, Minos hears each case in full and assigns it to its circle. That is what a DRG grouper does, and this one shows its reasoning.
The repository and command use the short name minos. Minos is the
provisional public brand pending trademark counsel review; a registry
pre-screen was performed on 2026-08-06 (see
decisions).
icd10-pl and icd9-pl with deterministic, fast search
and full source provenance.The public validation site serves terminology/JGP search, dated group and code
pages, the stepped encounter builder at minoshealth.pl/gruper,
and a public MCP server for agents at https://minoshealth.pl/mcp
(documentation), listed in the official
MCP Registry as pl.minoshealth/mcp.
The latest recorded verified validation deployment is b0dee0d (activated
2026-10-19T11:42:10Z, bundle 5cea0d5d unchanged) with the patched NGINX 1.31.7
edge base (#197). 2b6e26b activated blue/green API colours earlier that day
(#192): no Uptime Kuma down beat, with an accepted ~24-second edge window. Both
needed one retry after a rolled-back startup exit (#198). fda0788 (#191) passed
all 102 site audit checks. f9a0a72 added MODTAR
generation 103, the 2026-10-13 knowledge horizon (#184) and faster API startup
(#189); 736ba9f added source filters,
sharing and bounded startup readiness, and #171/#172 (088f190) initial source
HTML and durable RSK/BAW citations. The schema-10 bundle
and release-pinned concept JSON remain available. Reviewed MODTAR binding,
governing-act settlement-product exclusions, pinned JGP comparisons and NFZ
publication metadata are also live.
Deployment evidence
records the recovery, API, browser, privacy and exact-digest checks, including
the owner-approved one-off startup wait after guarded recovery. This is a dated
acceptance record, not a new production inspection.
Startup warm-up reliability (#157), guarded recovery diagnostics (#162), NFZ
publication metadata (#92) and concept JSON (#23) are delivered and closed.
The no-JS source-catalog and durable RSK/BAW citation slice from
PR #171 passed production
recovery and public/browser acceptance; source filters, sorting and shareable
views followed at 736ba9f (#185), and broader #80 remains open. Bounded startup
readiness (#181) passed its first production activation. Actions usage is measured
in #174; full CI runs on every push to main again since #272.
The initial golden suite has 9 synthetic and 5 pinned-source derived cases. Practitioner builder acceptance (#158), real ward agreement (#38), and full signed-release/capacity acceptance remain open; open work is tracked in GitHub issues.
Drug products, substitutions, reimbursement contracts in PLN, clinical recommendations, and international ICD variants are outside these releases. They may become separately namespaced modules after source and licensing validation. The data model is designed so additional markets (WHO classifications, other DRG systems) arrive as new namespaced terminology systems, grouping schemes, and tariff schedules rather than schema changes.
Minos is one Python 3.14 distribution with strict internal package boundaries:
minos.domain: synchronous domain types, normalization, ranking, and errors;minos.store: read-only persistence and indexed search through SQLite/FTS5;minos.ingest: hardened source parsing and reproducible artifact builds;minos.cli: data build/diff, offline lookup and grouping commands;minos.http: bounded FastAPI endpoints and privacy-safe telemetry;minos.grouper: versioned grouping engine evaluating
encounter facts against rules-as-data.The validation deployment uses immutable linux/amd64 API, edge, and watcher
images. Docker Compose runs the complete stack locally and on a dedicated
Mikr.us 3.0 host; Cloudflare Tunnel is its only public ingress. Validation mounts
a separately checksum-verified read-only SQLite bundle into the API; the edge
image contains the static web artifact. The full signed product-release contract
remains #41/#27. Offline CLI distributions bundle the Python runtime and use the
same generated database.
The watcher container runs APScheduler and a separate mutable control SQLite
database. It stores exact raw bytes and revisioned control-database recovery
images in a private Cloudflare R2 bucket (#200). GitHub-hosted Actions build and test the images
but do not run production schedules. Collectors in issues #6-#8 emit change
records. Reviewed updates use the guarded validation-deploy tool. Unattended
selection, activation and detailed incident delivery resumed in #141 on
2026-10-20 and are not yet enabled; #21 is closed as superseded, not delivered.
Watcher failure pushes name a fixed failure category, such as source_drift.
A host processor judges each new RSK ICD-10 or CZS ICD-9 file against the live
bundle every six hours and reports the verdict to a separate Kuma monitor; it
activates nothing yet.
Offline minos data diff compares explicitly pinned terminology, catalog and
conditions releases in verified bundle directories, with bounded Markdown/JSON
reports. See the CLI contract and
validation evidence.
The same Mikr.us host also runs self-hosted Uptime Kuma 2.5.9 at
status.minoshealth.pl. Its public page is limited to coarse service state;
detailed watcher state remains private through minos watcher status, with
issue #54 reserved for a future private detailed admin portal. This replaces a
paid external monitoring SaaS, not the need for monitoring. Because Kuma shares
the host, it cannot detect or notify for a total Mikr.us host, network, or power
outage. This limitation is accepted for now.
uv run python -m scripts.check_monitoring reads the same monitors and public
/readyz without credentials, and also reports a Kuma that stopped checking.
The initial service remains anonymous. The accepted later client direction is
one installable responsive PWA that can synchronize a verified immutable
SQLite reference snapshot for offline use. Future individual calculations are
authorized and metered online; premium offline calculation is licensed
separately to an organization or hospital. Accounts, payments, usage storage,
and exact commercial terms are not part of v0.0.1.
See the v0.0.1 documentation for accepted decisions and the implementation plan.
Install the pinned Python runtime and all development tools from a clean checkout:
Ruff, BasedPyright, mypy, and pytest are pinned in uv.lock. Terminal and
Neovim integration is documented in CONTRIBUTING.md.
Security, correctness, and measured performance are co-equal release
requirements. Evidence-based tradeoffs and representative benchmarks are
required, while developer convenience follows those requirements. Critical
paths receive targeted mutation and integration testing.
Offline reference commands and their bounded JSON/exit-code contract are in offline-search.md. Local full-source and standalone evidence is in the search validation. The website exposes reference search and grouping under the public-validation exception; source redistribution and signed product promotion retain their separate review gates.
The deployed validation Compose stack serves the API and web edge through Cloudflare Tunnel alongside the watchers and Uptime Kuma. The watcher foundation includes an executable UTC scheduler, fenced SQLite control transactions, local and R2 archives, revisioned recovery images, signed trusted-recovery inventories, a read-only watcher status command, preflight commands, a hardened watcher image, bounded local Docker logs, and local Compose. The RSK collector is registered in the runtime, but a fresh control volume must be initialized explicitly before the watcher starts.
Local runtime commands are:
Use minos watcher status [SOURCE_ID] --json to inspect one configured source.
The status path opens control SQLite read-only. These host-local status and log
commands do not detect a complete Mikr.us host, network, or power outage from
outside its fault domain.
Uptime Kuma setup and the two-stage public-route bootstrap are documented in the Ansible runbook. The operator created its admin account and 2FA, configured a private status page and paused watcher push monitor, tested a Telegram alert from Kuma, and stored a stopped integrity-checked off-host backup in 1Password on 2026-09-23. An isolated Docker restore of that backup passed against the same pinned image without network or host ports. Two operational gates remain open: the complete empty-host recovery drill (#49) and launch-capacity load acceptance (#42). Load objectives and the measurements so far are in the API load record.
The site reaches the host only through the Cloudflare Tunnel. SSH, the one management path, runs over a Tailscale tailnet with no public listener since 2026-10-23 (#227); the cutover is in the Ansible runbook.
Object storage is one EU-jurisdiction Cloudflare R2 bucket whose lock rules refuse overwrites and deletes; the AWS stacks and their acceptance harness were retired in #200. Mikr.us activation and restore drills remain explicit operator approval gates.
All sources are public. Details, endpoints, and polling procedures live in data sources; the legal analysis lives in data and licensing.
Source snapshots and generated databases are artifacts, not repository
materials, and must not be committed to Git. The repository therefore holds no
datasets and no deployment credentials: the test suite runs on synthetic
fixtures (uv run pytest), and running the site locally
(scripts/run_local_site.py) needs a reference bundle you build from the public
sources with the offline commands. Every generated dataset carries
source identity, timestamps, checksums, transformation version, attribution,
and required notices.
Minos is a reference and settlement-analysis tool, not medical advice, diagnosis, treatment, or a substitute for professional judgement.
The compliance boundary is explicit: Minos supports complete and correct coding of what was actually performed and documented, and prevention of avoidable claim rejections. It must not recommend coding beyond documentation. Grouping results are expressed in points and product codes; contractual PLN amounts depend on payer contracts and are out of scope.
The public service is anonymous. Logs must not contain raw medical search
queries, encounter payloads, patient data, prescriptions, credentials, or
other personal data. Grouping (from v0.0.2) is stateless: encounter inputs
are evaluated and discarded, never stored.
Repository software, infrastructure, tests, and documentation are licensed
under either Apache-2.0 or MIT, at your option. Dataset artifacts remain under
their source terms. NFZ normative acts and their appendices are treated as
copyright-exempt official materials under Art. 4 of Polish copyright law
(formal legal opinion pending); the RSK Polish ICD-10 resource identifies
CC BY-NC-SA 3.0 IGO. See NOTICE.md and
data and licensing.
Minos is in active public validation. No version tags or GitHub Releases have been published; exact-digest validation deployments are tracked separately from the full signed product-release gates in #41/#27. See CHANGELOG.md for unreleased changes, SPEC.md for the implementation baseline and GitHub issues for open work.
See CONTRIBUTING.md before opening an issue or pull request.
Source: README.md at commit 3b7639c
Service and releases
Get the releases Minos serves: ICD-10 PL, ICD-9 PL and ICD-11 PL versions, validity and licences, JGP grouping availability and knowledge horizon, and the disclaimer. Call it first to learn which service dates are covered; use get_source_status to see what publishers released since.
Takes no parameters.
Search codes
Search ICD-10 PL diagnoses, ICD-9 PL procedures, JGP groups and, when asked, pre-released ICD-11 PL by code or Polish words (diacritics optional). Each hit has its code, title, path and JGP group count; JGP groups are always searched in today's catalog. Open a hit with get_code or get_jgp_group; walk a hierarchy with browse_codes.
limitqueryrequiredsystemsservice_dateCode details
Get one ICD-10 PL, ICD-9 PL or ICD-11 PL code as its page shows it: title, hierarchy, children, notes, attributes, ICD-9 rank, WHO map rows and, for ICD-10 and ICD-9, the JGP groups whose attachment 9 lists name it on service_date. Find the code with search_codes first; open a listed group with get_jgp_group.
coderequiredsystemrequiredservice_dateBrowse a classification
List one level of ICD-10 PL, ICD-9 PL or ICD-11 PL: the chapters when parent and node are omitted, else the children of parent or of a node id from an earlier listing (ICD-11 blocks have a node id, no code). Levels stop at 400 entries with truncated=true. Use search_codes for words, get_code for one code's details.
nodeparentsystemrequiredWHO ICD-10 and ICD-11 map
Read the WHO ICD-10/ICD-11 mapping rows for one code, verbatim: to_icd11 for a Polish ICD-10 code, to_icd10 for an ICD-11 code. WHO states no match type, its ICD-10 side is the 2019 edition, not Polish 2008, and ICD-11 is not in force in Poland: treat a row as a lead and confirm the target with get_code.
coderequireddirectionrequiredJGP group
Get one JGP group from the catalog in force on service_date: name, product code, base points per column, scopes, the act and release, its grouping conditions with the directional lists they name, and NFZ monthly settlement statistics (settled points, not catalog). Pass a list's id and catalog to get_jgp_list; use compare_jgp_group for changes between dates.
coderequiredservice_dateJGP list
List the codes of one directional diagnosis or procedure list from JGP attachment 9, one page at a time. Take list_id from conditions.lists[].id and catalog from group.catalog of a get_jgp_group answer, with the same service_date. For the groups that name a given code, use get_code instead.
pagecataloglist_idrequiredservice_dateBrowse the JGP catalog
Browse the JGP catalog in force on service_date: without catalog and section, the sections of catalogs 1a and 1ae with group counts; with both, that section's groups and base points. Find a group by words with search_codes; open one with get_jgp_group.
catalogsectionservice_dateCompare a JGP group between dates
Compare one JGP group between the catalogs in force on two service dates: act, release, name, base points, scopes and condition list names on each side, plus the fields that changed. Use get_jgp_group for the full conditions on one date.
coderequiredafter_daterequiredbefore_daterequiredHospital stay dictionaries
List the values a group_case stay needs: ward specialty codes (part VIII of a department code; hospital wards 4000-4951, or every section with wards="all") and discharge modes, each with its legal act, plus hospitalization types and product reporting values. Call it before building the case for group_case.
wardsGroup a hospital stay
Group one anonymised hospital stay with the Minos Gruper (JGP SZP, supported rule subset): candidate groups with reasons, ranking, base and final points, preparation and limitations. Build case from get_case_dictionaries and codes confirmed with get_code. Send clinical facts only, never names, PESEL or addresses; nothing is stored. Reference, not an NFZ decision.
caserequireddetailservice_datereporting_monthdeclared_modifiersSource status
Show what a watched publisher lists now, as Minos last observed it: RSK resources and files, BAW NFZ orders and attachments, or NFZ dictionaries and notices, with versions and dates. Reads Minos's last snapshot and never calls the publisher. Compare with get_service_info to see whether Minos serves the newest release.
sourcerequired90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a license in the repository or the registry entry.
uv sync --all-groupsuv run minos --versiondocker compose build watcherdocker compose --profile bootstrap run --rm --no-deps watcher-bootstrap-rskdocker compose --profile preflight run --rm --no-deps watcher-preflightdocker compose up --detach watcherdocker compose exec --no-TTY watcher /app/.venv/bin/minos watcher status --jsondocker compose logs --since 24h --tail 500 --timestamps watcher