{
  "name": "icd10-mcp",
  "title": "HealthMesh · ICD-10-CM / ICD-10-PCS Codes MCP",
  "version": "0.1.2",
  "description": "ICD-10-CM diagnosis and ICD-10-PCS procedure codes from the official CMS/NCHS files (FY2027 effective 2026-10-01, plus FY2026 for earlier dates of service): text and prefix search, full code details with Tabular List instructional notes (includes, Excludes1/Excludes2, code first, use additional, code also, 7th characters), validity and billability checks with more specific suggestions, hierarchy, axis-by-axis ICD-10-PCS code building, and ICD-9 <-> ICD-10 General Equivalence Mappings (GEMs, final 2018 release).",
  "healthmesh_domain": "Codes & Terminology",
  "datasets": [
    "CODE-01",
    "CODE-02"
  ],
  "mcp_endpoint": "https://icd10.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/icd10-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "CMS ICD-10-CM/PCS code files, Tabular List XML, PCS Tables XML (FY2026-FY2027) + 2018 GEMs",
    "url": "https://www.cms.gov/medicare/coding-billing/icd-10-codes",
    "license": "U.S. Government work, public domain",
    "refresh": "bundled; rebuild for each Oct 1 (and Apr 1 PCS) release; GitHub Actions icd10-check weekly"
  },
  "tools": [
    {
      "name": "icd10_search_codes",
      "title": "Search ICD-10-CM / ICD-10-PCS codes",
      "description": "Searches ICD-10-CM diagnosis codes (default) or ICD-10-PCS procedure codes by text or by code prefix (e.g. 'low back pain', 'E11.6', '0SR'). Text search matches whole-word prefixes of the official long title and, for ICD-10-CM, Tabular List inclusion terms; a small lay-term expansion is applied (e.g. laparoscopic -> percutaneous endoscopic). Uses the release valid for date_of_service / fiscal_year (default: today's). Returns code, short and long description and billable flag, plus total vs returned."
    },
    {
      "name": "icd10_get_code",
      "title": "Get ICD-10-CM / PCS code details",
      "description": "Returns full details for one ICD-10-CM or ICD-10-PCS code: short/long title, billable flag, chapter, section, parent and child count; for ICD-10-CM the Tabular List notes (inclusion terms, includes, Excludes1, Excludes2, code first, use additional code, code also) including those inherited from the category, section and chapter, and 7th-character options; for ICD-10-PCS the meaning of each of the 7 axes and the root-operation definition. Code system is detected automatically (dots optional)."
    },
    {
      "name": "icd10_validate_code",
      "title": "Validate ICD-10 codes (valid / billable)",
      "description": "Checks 1-100 ICD-10-CM or ICD-10-PCS codes against the release in effect on date_of_service (or fiscal_year; default today): whether each exists, whether it is billable (valid for HIPAA claims), and for header or incomplete codes the more specific billable codes beneath it (first 10, with a total). Flags codes added or deleted between FY2026 and FY2027 and codes missing a required 7th character."
    },
    {
      "name": "icd10_get_hierarchy",
      "title": "ICD-10 code hierarchy (ancestors and children)",
      "description": "Returns the ancestors (chapter, section, category, subcategories) and descendants of an ICD-10-CM code to a given depth, or for ICD-10-PCS the axis path (section / body system / root operation ...) and the valid next characters with code counts. Capped at 300 descendant nodes (children_total is always exact)."
    },
    {
      "name": "icd10pcs_build_code",
      "title": "Build an ICD-10-PCS code axis by axis",
      "description": "Walks the ICD-10-PCS tables one character at a time (section, body system, root operation, body part, approach, device, qualifier). Given 0-6 known characters it returns the valid options for the next position with their meanings and how many valid codes each leads to; with 7 characters it returns the complete code. An optional description (e.g. 'laparoscopic cholecystectomy') marks matching options and lists candidate complete codes from a text search."
    },
    {
      "name": "icd10_map_gem",
      "title": "Map ICD-9-CM <-> ICD-10 (CMS GEMs)",
      "description": "Maps a code between ICD-9-CM and ICD-10-CM (diagnoses) or ICD-10-PCS (procedures) with the CMS General Equivalence Mappings (final 2018 release; CMS stopped updating GEMs after FY2018), forward (9to10) or backward (10to9). Each mapping carries the GEM flags: approximate, no_map, combination, scenario and choice_list. ICD-10 targets carry their current FY2027 title and whether they are still valid; ICD-9 titles are not bundled."
    },
    {
      "name": "icd10_describe_dataset",
      "title": "Describe this ICD-10 dataset",
      "description": "Describes the bundled ICD-10-CM/PCS releases (validity dates, code and billable counts), GEM version, search behaviour and refresh schedule."
    }
  ]
}