{
  "name": "hcpcs-mcp",
  "title": "HealthMesh · HCPCS Level II Codes MCP",
  "version": "0.1.2",
  "description": "CMS Healthcare Common Procedure Coding System (HCPCS) Level II alphanumeric codes from the October 2026 quarterly update: search by text or code prefix, full code records (long/short description, pricing indicators, coverage, BETOS, type of service, ASC group, action and dates), and the quarterly add/change/discontinue list. CPT Level I and ADA CDT dental codes are not included.",
  "healthmesh_domain": "Codes & Terminology",
  "datasets": [
    "CODE-03"
  ],
  "mcp_endpoint": "https://hcpcs.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/hcpcs-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "CMS HCPCS Level II alphanumeric quarterly update (October 2026 ANWEB + Transaction Report)",
    "url": "https://www.cms.gov/medicare/coding-billing/healthcare-common-procedure-system/quarterly-update",
    "license": "U.S. Government work (public domain); CMS Level II descriptors only — no AMA CPT or ADA CDT text",
    "refresh": "bundled; rebuild when CMS posts a new quarterly alphanumeric ZIP; weekly GitHub Actions check"
  },
  "tools": [
    {
      "name": "hcpcs_search",
      "title": "Search HCPCS Level II codes",
      "description": "Searches CMS HCPCS Level II codes. Matching: (1) exact code or code-prefix when the query looks like a HCPCS code (e.g. 'E0', 'J9271'); otherwise (2) case-insensitive AND of whitespace-separated tokens against short+long description (so 'insulin pump' matches descriptions containing both words, including 'External ambulatory infusion pump, insulin'). Rank: exact code > prefix > exact short > short starts-with phrase > short contains phrase > long contains phrase > token-AND only; ties broken by code. Optionally filter active_only (default true) and BETOS. Page with limit (default 25, max 100) and offset."
    },
    {
      "name": "hcpcs_get_code",
      "title": "Get a HCPCS Level II code record",
      "description": "Returns the full CMS HCPCS Level II record for a 5-character code: long and short description, pricing indicator(s) with meanings, multiple-pricing indicator, coverage code (with meaning), BETOS group, type of service with meanings, ASC payment group, action code and add/effective/termination dates, plus any cross-reference, CIM/MCM/statute citations."
    },
    {
      "name": "hcpcs_list_changes",
      "title": "List HCPCS codes added, changed, or discontinued in a quarter",
      "description": "Lists HCPCS Level II codes that were added (A), had a long-description change (C), payment change (P), administrative field change (F), coverage+description change (B), or were discontinued (D) in a quarterly CMS alphanumeric release. Each row includes action_effective_date, term_dt and active (as of today). Default action filter is all non-No-Change rows. Page with limit (default 50, max 200) and offset."
    },
    {
      "name": "hcpcs_describe_dataset",
      "title": "Describe the bundled HCPCS Level II dataset",
      "description": "Returns coverage, counts, release metadata, action/coverage/pricing/TOS code keys, and scope notes for this server."
    }
  ]
}