@cyanheads/medical-codes-mcp-server 0.1.0

package/changelog/template.md

@@ -0,0 +1,127 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+
+# Optional free-form notes for maintenance agents processing this release.
+# Not rendered in CHANGELOG — consumed by agents running `maintenance` on
+# downstream servers. Use for adoption instructions that don't fit the
+# human-facing sections: new files to create, fields to populate, one-time
+# migration steps. Omit the field entirely when there's nothing to say.
+# agent-notes: |
+#   <instructions for downstream maintenance agents>
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, CLAUDE.md/AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Server-specific configuration for medical-codes-mcp-server.
+ * Lazy-parsed from environment variables. Framework config (transport, logging,
+ * auth, storage) is owned by @cyanheads/mcp-ts-core and parsed separately.
+ *
+ * The server is offline and keyless — it reads a bundled SQLite + FTS5 database
+ * built at package-build time. The only runtime knobs are the DB path override
+ * and the result cap.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    dbPath: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
+    maxResults: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+/**
+ * Lazily parse and cache the server config. Maps schema paths to env var names
+ * so a validation error names the variable (`MEDCODE_MAX_RESULTS`) not the path.
+ */
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAgB3C,QAAA,MAAM,kBAAkB;;;iBAatB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}

package/dist/config/server-config.js

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Server-specific configuration for medical-codes-mcp-server.
+ * Lazy-parsed from environment variables. Framework config (transport, logging,
+ * auth, storage) is owned by @cyanheads/mcp-ts-core and parsed separately.
+ *
+ * The server is offline and keyless — it reads a bundled SQLite + FTS5 database
+ * built at package-build time. The only runtime knobs are the DB path override
+ * and the result cap.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+/**
+ * Treats an unset env var (`undefined`), a set-but-empty env var (`""`), and an
+ * unsubstituted MCPB placeholder (`${user_config.X}`) identically as absent —
+ * so an empty `MEDCODE_DB_PATH=` falls back to the bundled default rather than
+ * resolving to an empty path.
+ */
+const PLACEHOLDER_PATTERN = /^\$\{[^}]+\}$/;
+const emptyAsUndefined = (v) => {
+    if (v === '')
+        return;
+    if (typeof v === 'string' && PLACEHOLDER_PATTERN.test(v))
+        return;
+    return v;
+};
+const ServerConfigSchema = z.object({
+    dbPath: z
+        .preprocess(emptyAsUndefined, z.string().optional())
+        .describe('Absolute path override for the bundled SQLite database. Defaults to the packaged data/medical-codes.db resolved relative to the build output.'),
+    maxResults: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(50)
+        .describe('Cap on rows returned by search and browse tools (default 50, hard ceiling 200).'),
+});
+let _config;
+/**
+ * Lazily parse and cache the server config. Maps schema paths to env var names
+ * so a validation error names the variable (`MEDCODE_MAX_RESULTS`) not the path.
+ */
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        dbPath: 'MEDCODE_DB_PATH',
+        maxResults: 'MEDCODE_MAX_RESULTS',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAC5C,MAAM,gBAAgB,GAAG,CAAC,CAAU,EAAE,EAAE;IACtC,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO;IACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO;IACjE,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC;SACN,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;SACnD,QAAQ,CACP,+IAA+I,CAChJ;IACH,UAAU,EAAE,CAAC,CAAC,MAAM;SACjB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,iFAAiF,CAAC;CAC/F,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,MAAM,EAAE,iBAAiB;QACzB,UAAU,EAAE,qBAAqB;KAClC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview medical-codes-mcp-server MCP server entry point. Registers the
+ * six medcode_* tools and opens the bundled SQLite + FTS5 code index read-only
+ * in setup(). Offline, keyless, single-tenant — no runtime network I/O.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview medical-codes-mcp-server MCP server entry point. Registers the
+ * six medcode_* tools and opens the bundled SQLite + FTS5 code index read-only
+ * in setup(). Offline, keyless, single-tenant — no runtime network I/O.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { browseHierarchyTool } from './mcp-server/tools/definitions/browse-hierarchy.tool.js';
+import { checkCodeTool } from './mcp-server/tools/definitions/check-code.tool.js';
+import { getCodeTool } from './mcp-server/tools/definitions/get-code.tool.js';
+import { listSystemsTool } from './mcp-server/tools/definitions/list-systems.tool.js';
+import { mapCodesTool } from './mcp-server/tools/definitions/map-codes.tool.js';
+import { searchCodesTool } from './mcp-server/tools/definitions/search-codes.tool.js';
+import { initCodeIndexService } from './services/code-index/code-index-service.js';
+await createApp({
+    name: 'medical-codes-mcp-server',
+    title: 'medical-codes-mcp-server',
+    tools: [
+        getCodeTool,
+        searchCodesTool,
+        checkCodeTool,
+        mapCodesTool,
+        browseHierarchyTool,
+        listSystemsTool,
+    ],
+    instructions: 'Offline US healthcare code lookup and crosswalk over a bundled SQLite index — keyless, no rate limit, deterministic. Bundled systems: ICD-10-CM (diagnoses), ICD-10-PCS (inpatient procedures), HCPCS Level II (supplies/drugs/services); RxNorm (drug crosswalks) lands in a later release. Decode a code with medcode_get_code (the 80% entry point; accepts a batch and auto-detects the system per code). Go description → code with medcode_search_codes. Validate billability with medcode_check_code — a non-billable or terminated code is a successful result with a whyNot, not an error. Walk the hierarchy with medcode_browse_hierarchy (prefix for ICD-10-CM/HCPCS, axis-based for ICD-10-PCS). Crosswalk parents/children with medcode_map_codes. Confirm which release is active with medcode_list_systems. ICD-10-CM/PCS are the US clinical modifications, not the ICD-10/ICD-11 base.',
+    landing: {
+        requireAuth: false,
+        tagline: 'Offline US healthcare code lookup and crosswalk — ICD-10-CM, ICD-10-PCS, and HCPCS Level II, keyless and deterministic.',
+        repoRoot: 'https://github.com/cyanheads/medical-codes-mcp-server',
+        links: [
+            {
+                label: 'ICD-10-CM (CDC/NCHS)',
+                href: 'https://www.cdc.gov/nchs/icd/icd-10-cm/index.html',
+                external: true,
+            },
+            {
+                label: 'ICD-10-PCS & HCPCS (CMS)',
+                href: 'https://www.cms.gov/medicare/coding-billing/icd-10-codes',
+                external: true,
+            },
+            {
+                label: 'RxNorm (NLM)',
+                href: 'https://www.nlm.nih.gov/research/umls/rxnorm/',
+                external: true,
+            },
+        ],
+    },
+    async setup() {
+        await initCodeIndexService();
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yDAAyD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,mDAAmD,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAEnF,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,0BAA0B;IAChC,KAAK,EAAE,0BAA0B;IACjC,KAAK,EAAE;QACL,WAAW;QACX,eAAe;QACf,aAAa;QACb,YAAY;QACZ,mBAAmB;QACnB,eAAe;KAChB;IACD,YAAY,EACV,02BAA02B;IAC52B,OAAO,EAAE;QACP,WAAW,EAAE,KAAK;QAClB,OAAO,EACL,yHAAyH;QAC3H,QAAQ,EAAE,uDAAuD;QACjE,KAAK,EAAE;YACL;gBACE,KAAK,EAAE,sBAAsB;gBAC7B,IAAI,EAAE,mDAAmD;gBACzD,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,KAAK,EAAE,0BAA0B;gBACjC,IAAI,EAAE,0DAA0D;gBAChE,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,KAAK,EAAE,cAAc;gBACrB,IAAI,EAAE,+CAA+C;gBACrD,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD,KAAK,CAAC,KAAK;QACT,MAAM,oBAAoB,EAAE,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/_render.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Shared markdown rendering for a decoded code. Centralizes the
+ * one place that must touch every field of the decoded-code shape so format()
+ * parity holds identically across medcode_get_code, medcode_search_codes, and
+ * medcode_browse_hierarchy (the linter walks each field; rendering them in one
+ * helper keeps the three tools in sync).
+ * @module mcp-server/tools/definitions/_render
+ */
+/** The minimal decoded-code shape every render helper consumes. */
+export interface RenderableCode {
+    billable: boolean;
+    chapter: string | null;
+    code: string;
+    description: string | null;
+    header: boolean;
+    shortDescription: string | null;
+    system: string;
+}
+/**
+ * Render a decoded code as a single bullet line touching every field:
+ * code, system, billable, header, chapter, description, shortDescription.
+ */
+export declare function renderCodeLine(c: RenderableCode): string;
+/** Render a decoded code as a heading block touching every field. */
+export declare function renderCodeBlock(c: RenderableCode): string[];
+//# sourceMappingURL=_render.d.ts.map

package/dist/mcp-server/tools/definitions/_render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_render.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_render.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAQxD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,CAS3D"}

package/dist/mcp-server/tools/definitions/_render.js

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Shared markdown rendering for a decoded code. Centralizes the
+ * one place that must touch every field of the decoded-code shape so format()
+ * parity holds identically across medcode_get_code, medcode_search_codes, and
+ * medcode_browse_hierarchy (the linter walks each field; rendering them in one
+ * helper keeps the three tools in sync).
+ * @module mcp-server/tools/definitions/_render
+ */
+import { SYSTEM_LABELS } from '../../../services/code-index/types.js';
+/** Human label for a system id, falling back to the raw id. */
+function label(system) {
+    return SYSTEM_LABELS[system] ?? system;
+}
+/**
+ * Billability phrase referencing both fields by their key names. The key names
+ * ("billable", "header") must appear literally so the format-parity linter — which
+ * checks for the key name of permissive boolean fields — sees them rendered.
+ */
+function flags(c) {
+    return `billable: ${c.billable ? 'yes' : 'no'}, header: ${c.header ? 'yes' : 'no'}`;
+}
+/**
+ * Render a decoded code as a single bullet line touching every field:
+ * code, system, billable, header, chapter, description, shortDescription.
+ */
+export function renderCodeLine(c) {
+    const desc = c.description ?? c.shortDescription ?? '(no description)';
+    const short = c.shortDescription && c.shortDescription !== c.description
+        ? ` _(short: ${c.shortDescription})_`
+        : '';
+    const chapter = c.chapter ? ` · chapter ${c.chapter}` : '';
+    return `- **${c.code}** (${label(c.system)}; ${flags(c)}${chapter}): ${desc}${short}`;
+}
+/** Render a decoded code as a heading block touching every field. */
+export function renderCodeBlock(c) {
+    const lines = [
+        `## ${c.code} — ${label(c.system)}`,
+        `**${flags(c)}**${c.chapter ? ` · chapter ${c.chapter}` : ''}`,
+    ];
+    lines.push(c.description ?? c.shortDescription ?? '(no description)');
+    if (c.shortDescription && c.shortDescription !== c.description)
+        lines.push(`_Short:_ ${c.shortDescription}`);
+    return lines;
+}
+//# sourceMappingURL=_render.js.map

package/dist/mcp-server/tools/definitions/_render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_render.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_render.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAa/D,+DAA+D;AAC/D,SAAS,KAAK,CAAC,MAAc;IAC3B,OAAO,aAAa,CAAC,MAAoC,CAAC,IAAI,MAAM,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,SAAS,KAAK,CAAC,CAAiB;IAC9B,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAiB;IAC9C,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,gBAAgB,IAAI,kBAAkB,CAAC;IACvE,MAAM,KAAK,GACT,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,WAAW;QACxD,CAAC,CAAC,aAAa,CAAC,CAAC,gBAAgB,IAAI;QACrC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,OAAO,CAAC,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;AACxF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,CAAiB;IAC/C,MAAM,KAAK,GAAG;QACZ,MAAM,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QACnC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;KAC/D,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,gBAAgB,IAAI,kBAAkB,CAAC,CAAC;IACtE,IAAI,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,WAAW;QAC5D,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/mcp-server/tools/definitions/browse-hierarchy.tool.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview medcode_browse_hierarchy — walk a code system's hierarchy
+ * without a search term. Returns the children of a node, or the top-level
+ * entries when no node is given. ICD-10-CM/HCPCS browse the prefix hierarchy
+ * (chapter → category → code); ICD-10-PCS browses its axis structure (each of
+ * the 7 characters is an independent axis), returning valid next-position axis
+ * values rather than prefix children.
+ * @module mcp-server/tools/definitions/browse-hierarchy.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const browseHierarchyTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    system: z.ZodEnum<{
+        ICD10CM: "ICD10CM";
+        ICD10PCS: "ICD10PCS";
+        HCPCS: "HCPCS";
+        RXNORM: "RXNORM";
+    }>;
+    node: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        codes: "codes";
+        axes: "axes";
+    }>;
+    codes: z.ZodArray<z.ZodObject<{
+        system: z.ZodString;
+        code: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        shortDescription: z.ZodNullable<z.ZodString>;
+        billable: z.ZodBoolean;
+        header: z.ZodBoolean;
+        chapter: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    axes: z.ZodArray<z.ZodObject<{
+        position: z.ZodNumber;
+        value: z.ZodString;
+        meaning: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "unknown_node";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The node does not exist in the system.";
+    readonly recovery: "Omit `node` to list top-level entries, or verify the node code.";
+}], {
+    readonly truncated: z.ZodBoolean;
+    readonly shown: z.ZodNumber;
+    readonly cap: z.ZodNumber;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=browse-hierarchy.tool.d.ts.map

package/dist/mcp-server/tools/definitions/browse-hierarchy.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-hierarchy.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-hierarchy.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA6BjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwH9B,CAAC"}

package/dist/mcp-server/tools/definitions/browse-hierarchy.tool.js

@@ -0,0 +1,131 @@
+/**
+ * @fileoverview medcode_browse_hierarchy — walk a code system's hierarchy
+ * without a search term. Returns the children of a node, or the top-level
+ * entries when no node is given. ICD-10-CM/HCPCS browse the prefix hierarchy
+ * (chapter → category → code); ICD-10-PCS browses its axis structure (each of
+ * the 7 characters is an independent axis), returning valid next-position axis
+ * values rather than prefix children.
+ * @module mcp-server/tools/definitions/browse-hierarchy.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getServerConfig } from '../../../config/server-config.js';
+import { getCodeIndexService } from '../../../services/code-index/code-index-service.js';
+import { SYSTEM_IDS } from '../../../services/code-index/types.js';
+import { renderCodeLine } from './_render.js';
+const SOURCE_URL = 'https://github.com/cyanheads/medical-codes-mcp-server/blob/main/src/mcp-server/tools/definitions/browse-hierarchy.tool.ts';
+const CodeNodeSchema = z
+    .object({
+    system: z.string().describe('The system the node belongs to.'),
+    code: z.string().describe('The child code in display form.'),
+    description: z.string().nullable().describe('Official long description, or null.'),
+    shortDescription: z.string().nullable().describe('Official short description, or null.'),
+    billable: z.boolean().describe('True when the code is a billable leaf.'),
+    header: z.boolean().describe('True when the code is a non-billable category/header.'),
+    chapter: z.string().nullable().describe('Chapter/range bucket, or null.'),
+})
+    .describe('A child code in a prefix hierarchy (ICD-10-CM/HCPCS).');
+const AxisNodeSchema = z
+    .object({
+    position: z.number().describe('The 1-based character position in the ICD-10-PCS code.'),
+    value: z.string().describe('The single-character axis value valid at this position.'),
+    meaning: z.string().describe('What this axis value means at this position.'),
+})
+    .describe('A valid ICD-10-PCS axis value at a given character position.');
+export const browseHierarchyTool = tool('medcode_browse_hierarchy', {
+    title: 'medical-codes-mcp-server',
+    description: "Walk a US medical code system's hierarchy for discovery without a search term. With no `node`, returns the top-level entries (ICD-10-CM categories, HCPCS range buckets, or ICD-10-PCS first-axis values). With a `node`, returns its immediate children. ICD-10-CM and HCPCS use a prefix hierarchy (a shorter code is the parent of a longer one); ICD-10-PCS is axis-based — each of its 7 characters is an independent axis (section, body system, root operation, body part, approach, device, qualifier), so browsing returns the valid values for the next character position, not prefix children. Lets an agent orient in an unfamiliar system or enumerate a category's specific codes.",
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    sourceUrl: SOURCE_URL,
+    input: z.object({
+        system: z.enum(SYSTEM_IDS).describe('The code system to browse.'),
+        node: z
+            .string()
+            .optional()
+            .describe('A node to expand. For ICD-10-CM/HCPCS, a code whose children to list. For ICD-10-PCS, a partial code whose next-position axis values to list. Omit for the top level.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe('Max entries to return. Defaults to MEDCODE_MAX_RESULTS (50), ceiling 200.'),
+    }),
+    output: z.object({
+        kind: z
+            .enum(['codes', 'axes'])
+            .describe('"codes" for prefix-hierarchy children (ICD-10-CM/HCPCS); "axes" for ICD-10-PCS axis values.'),
+        codes: z
+            .array(CodeNodeSchema)
+            .describe('Child codes under the requested node or top level. Empty when kind is "axes".'),
+        axes: z
+            .array(AxisNodeSchema)
+            .describe('Valid next-position axis values for a partial PCS code. Empty when kind is "codes".'),
+    }),
+    enrichment: {
+        truncated: z.boolean().describe('True when the returned list was capped at the limit.'),
+        shown: z.number().describe('Number of entries returned (codes or axes).'),
+        cap: z.number().describe('The limit that was applied.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when a node has no children/axes — suggests the top level or a valid node.'),
+    },
+    errors: [
+        {
+            reason: 'unknown_node',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The node does not exist in the system.',
+            recovery: 'Omit `node` to list top-level entries, or verify the node code.',
+        },
+    ],
+    handler(input, ctx) {
+        const limit = input.limit ?? getServerConfig().maxResults;
+        const result = getCodeIndexService().browse(input.system, input.node, limit);
+        if (result.kind === 'unknown_node') {
+            throw ctx.fail('unknown_node', `Node "${input.node}" does not exist in ${input.system}.`, {
+                ...ctx.recoveryFor('unknown_node'),
+            });
+        }
+        if (result.kind === 'axes') {
+            ctx.enrich({ truncated: result.axes.length >= limit, shown: result.axes.length, cap: limit });
+            if (result.axes.length === 0) {
+                ctx.enrich.notice(input.node
+                    ? `ICD-10-PCS axis values for positions 2–7 are context-dependent (their meaning ` +
+                        `varies by the section, body system, and operation that precede them), so they ` +
+                        `are not enumerable from a flat partial code. Omit \`node\` to list the 17 ` +
+                        `sections, or decode a complete 7-character code with medcode_get_code for its ` +
+                        `full axis breakdown.`
+                    : `No ICD-10-PCS sections are bundled in this release.`);
+            }
+            ctx.log.info('Browsed PCS axes', { node: input.node ?? null, count: result.axes.length });
+            return { kind: 'axes', codes: [], axes: result.axes };
+        }
+        ctx.enrich({ truncated: result.codes.length >= limit, shown: result.codes.length, cap: limit });
+        if (result.codes.length === 0) {
+            ctx.enrich.notice(`No children under "${input.node ?? '(top level)'}" in ${input.system}. ` +
+                'Omit `node` for the top level, or browse a parent category.');
+        }
+        ctx.log.info('Browsed hierarchy', { node: input.node ?? null, count: result.codes.length });
+        return { kind: 'codes', codes: result.codes, axes: [] };
+    },
+    // Render both arrays unconditionally — one is always empty at runtime, but the
+    // format-parity linter synthesizes a single sample with both populated, so each
+    // branch's fields must be reachable in one pass (kind discrimination would hide
+    // half of them from the linter).
+    format: (result) => {
+        const lines = [`## Browse result (${result.kind})`, ''];
+        if (result.codes.length > 0 || result.kind === 'codes') {
+            lines.push(`### ${result.codes.length} child code(s)`);
+            for (const c of result.codes)
+                lines.push(renderCodeLine(c));
+        }
+        if (result.axes.length > 0 || result.kind === 'axes') {
+            lines.push('### ICD-10-PCS axis values', '', '| Position | Value | Meaning |', '|---:|:---|:---|');
+            for (const a of result.axes)
+                lines.push(`| ${a.position} | ${a.value} | ${a.meaning} |`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=browse-hierarchy.tool.js.map

package/dist/mcp-server/tools/definitions/browse-hierarchy.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-hierarchy.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-hierarchy.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/check-code.tool.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview medcode_check_code — validate whether a code exists, is current,
+ * and is billable in the active release. Returns a discriminated status with a
+ * why-not for non-billable or terminated codes. Validity vs. existence is split:
+ * a non-billable or terminated code is a SUCCESS result with a whyNot (the
+ * recovery detail a coder needs), not an error. Only a code absent from every
+ * detected system is an `unknown_code` failure.
+ * @module mcp-server/tools/definitions/check-code.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const checkCodeTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    code: z.ZodString;
+    system: z.ZodOptional<z.ZodEnum<{
+        ICD10CM: "ICD10CM";
+        ICD10PCS: "ICD10PCS";
+        HCPCS: "HCPCS";
+        RXNORM: "RXNORM";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    system: z.ZodString;
+    code: z.ZodString;
+    status: z.ZodEnum<{
+        valid_billable: "valid_billable";
+        valid_not_billable: "valid_not_billable";
+        valid_header: "valid_header";
+        terminated: "terminated";
+    }>;
+    billable: z.ZodBoolean;
+    whyNot: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "unknown_code";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The code does not exist in the named or detected system.";
+    readonly recovery: "Check the code, or search by description with medcode_search_codes.";
+}, {
+    readonly reason: "ambiguous_system";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The code is present in more than one bundled system and no `system` was given.";
+    readonly recovery: "Re-call with an explicit `system` to disambiguate.";
+}], undefined>;
+//# sourceMappingURL=check-code.tool.d.ts.map

package/dist/mcp-server/tools/definitions/check-code.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-code.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/check-code.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyFxB,CAAC"}