Minos Health dla agentów AI

Service and releases get_service_info

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.

No arguments.

Returns: notice, dataset_id, releases, grouping, tools, documentation; answers from the HTTP API may add fields.

Example call:

{
  "name": "get_service_info",
  "arguments": {}
}

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

Returns: notice, query, systems; answers from the HTTP API may add fields.

Example call:

{
  "name": "search_codes",
  "arguments": {
    "query": "zapalenie płuc",
    "systems": [
      "icd10-pl",
      "jgp"
    ]
  }
}

Code details get_code

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.

Returns: notice, system, code, release, title, path, children, children_truncated, notes, attributes, procedure_rank, who_map_rows, jgp_lists; answers from the HTTP API may add fields.

Example call:

{
  "name": "get_code",
  "arguments": {
    "system": "icd10-pl",
    "code": "J18.9",
    "service_date": "2026-10-22"
  }
}

Browse a classification browse_codes

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.

Returns: notice, system, release_id, parent, children, truncated; answers from the HTTP API may add fields.

Example call:

{
  "name": "browse_codes",
  "arguments": {
    "system": "icd11-pl",
    "parent": "11"
  }
}

WHO ICD-10 and ICD-11 map map_icd10_icd11

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.

Returns: notice, code, direction, map_release_id, rows; answers from the HTTP API may add fields.

Example call:

{
  "name": "map_icd10_icd11",
  "arguments": {
    "code": "I10",
    "direction": "to_icd11"
  }
}

JGP group get_jgp_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, the knowledge horizon and its grouping conditions with the directional lists they name. Pass a named list's id and catalog to get_jgp_list for its codes; use compare_jgp_group for changes between dates.

Returns: notice; answers from the HTTP API may add fields.

Example call:

{
  "name": "get_jgp_group",
  "arguments": {
    "code": "F72",
    "service_date": "2026-10-22"
  }
}

JGP list get_jgp_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.

Returns: notice; answers from the HTTP API may add fields.

Example call:

{
  "name": "get_jgp_list",
  "arguments": {
    "list_id": 1,
    "catalog": "1a",
    "page": 1
  }
}

Browse the JGP catalog browse_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.

Returns: notice; answers from the HTTP API may add fields.

Example call:

{
  "name": "browse_jgp_catalog",
  "arguments": {
    "catalog": "1a",
    "section": 1
  }
}

Compare a JGP group between dates compare_jgp_group

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.

Returns: notice, code, before, after, changed; answers from the HTTP API may add fields.

Example call:

{
  "name": "compare_jgp_group",
  "arguments": {
    "code": "A01",
    "before_date": "2026-05-15",
    "after_date": "2026-10-22"
  }
}

Hospital stay dictionaries get_case_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.

Returns: notice, specialties, discharge_modes, hospitalization_types, product_reporting; answers from the HTTP API may add fields.

Example call:

{
  "name": "get_case_dictionaries",
  "arguments": {}
}

Group a hospital stay group_case

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.

Stay fields (case):

• admitted_on (required): date (YYYY-MM-DD)
• discharged_on (required): date (YYYY-MM-DD)
• hospitalization_type (required): "hospitalization" | "planned" | "one_day"
• principal_diagnosis (required): object
• stays (required): array of object
• secondary_diagnoses: array of object
• procedures: array of object
• birth_date: date (YYYY-MM-DD) or null
• age_completed_years: integer or null
• discharge_mode: integer or null
• settlement_products: array of object
• product_reporting: "unknown" | "complete"

Returns: notice; answers from the HTTP API may add fields.

Example call:

{
  "name": "group_case",
  "arguments": {
    "case": {
      "admitted_on": "2026-09-28",
      "discharged_on": "2026-10-02",
      "hospitalization_type": "hospitalization",
      "age_completed_years": 51,
      "principal_diagnosis": {
        "code": "K40.9",
        "hospitalization_level": true
      },
      "stays": [
        {
          "identifier": "surgery",
          "department": "4500",
          "admitted_on": "2026-09-28",
          "discharged_on": "2026-10-02"
        }
      ],
      "procedures": [
        {
          "code": "53.03",
          "performed_on": "2026-10-01",
          "stay_id": "surgery"
        }
      ],
      "product_reporting": "complete"
    }
  }
}

Source status get_source_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.

Returns: notice, source, observed_at, items, truncated; answers from the HTTP API may add fields.

Example call:

{
  "name": "get_source_status",
  "arguments": {
    "source": "rsk"
  }
}

Error codes

Failures return isError: true and {"error": {"code": "…"}}, never input or exception text.