@cyanheads/medical-codes-mcp-server 0.1.0

package/dist/services/code-index/schema.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Shared SQLite schema and code-shape derivation for the bundled
+ * medical-codes index. Imported by BOTH the runtime service (read) and the
+ * build script (write) so the table layout, FTS configuration, and the
+ * parent/chapter/header derivation rules can never drift between the two.
+ * @module services/code-index/schema
+ */
+import type { SystemId } from './types.js';
+/**
+ * Full DDL for the bundled database. Run once by the build/fixture scripts.
+ * `codes_fts` is an external-content FTS5 index over `codes` — triggers keep it
+ * in sync on insert so the build script only writes `codes`.
+ */
+export declare const SCHEMA_SQL = "\nCREATE TABLE codes (\n  system      TEXT NOT NULL,\n  code        TEXT NOT NULL,\n  short_desc  TEXT,\n  long_desc   TEXT,\n  billable    INTEGER NOT NULL DEFAULT 0,\n  header      INTEGER NOT NULL DEFAULT 0,\n  chapter     TEXT,\n  parent      TEXT,\n  effective   TEXT,\n  terminated  TEXT,\n  PRIMARY KEY (system, code)\n) WITHOUT ROWID;\n\nCREATE INDEX idx_codes_parent ON codes (system, parent);\nCREATE INDEX idx_codes_chapter ON codes (system, chapter);\n\nCREATE VIRTUAL TABLE codes_fts USING fts5 (\n  system UNINDEXED,\n  code UNINDEXED,\n  short_desc,\n  long_desc,\n  tokenize = 'unicode61'\n);\n\nCREATE TABLE pcs_axes (\n  position INTEGER NOT NULL,\n  value    TEXT NOT NULL,\n  meaning  TEXT NOT NULL,\n  PRIMARY KEY (position, value)\n) WITHOUT ROWID;\n\nCREATE TABLE rxnorm_rel (\n  rxcui       TEXT NOT NULL,\n  rel         TEXT NOT NULL,\n  target      TEXT NOT NULL,\n  target_type TEXT NOT NULL\n);\n\nCREATE INDEX idx_rxnorm_rel_rxcui ON rxnorm_rel (rxcui, rel);\nCREATE INDEX idx_rxnorm_rel_target ON rxnorm_rel (target, rel);\n\nCREATE TABLE ndc_map (\n  ndc   TEXT NOT NULL,\n  rxcui TEXT NOT NULL\n);\n\nCREATE INDEX idx_ndc_map_ndc ON ndc_map (ndc);\nCREATE INDEX idx_ndc_map_rxcui ON ndc_map (rxcui);\n\nCREATE TABLE build_meta (\n  system          TEXT PRIMARY KEY,\n  release_id      TEXT NOT NULL,\n  effective_start TEXT,\n  effective_end   TEXT,\n  code_count      INTEGER NOT NULL DEFAULT 0,\n  source_url      TEXT,\n  built_at        TEXT NOT NULL\n) WITHOUT ROWID;\n";
+/**
+ * Insert a `codes` row and mirror it into the FTS index in one call. The build
+ * and fixture scripts use this so FTS population is centralized. `code` is the
+ * storage form (no dots).
+ */
+export declare const INSERT_CODE_SQL = "INSERT INTO codes (system, code, short_desc, long_desc, billable, header, chapter, parent, effective, terminated)\n   VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)";
+export declare const INSERT_FTS_SQL = "INSERT INTO codes_fts (system, code, short_desc, long_desc) VALUES (?, ?, ?, ?)";
+/**
+ * Re-insert a dot into an ICD-10-CM storage code for display: a dot after the
+ * 3-character category when there are subsequent characters (`A0101` → `A01.01`).
+ * Storage codes are dot-free; display codes carry the dot the way clinicians write
+ * them. ICD-10-PCS, HCPCS, and RXCUI have no dot — returned unchanged.
+ */
+export declare function displayCode(system: SystemId, storageCode: string): string;
+/**
+ * Normalize a user-supplied code to its storage form: uppercase, trimmed, and —
+ * for ICD-10-CM — with the dot stripped so `A01.01` and `A0101` both match the
+ * stored `A0101`.
+ */
+export declare function storageCode(rawCode: string): string;
+/**
+ * Derive the parent of an ICD-10-CM code: strip the last character. `A0101` →
+ * `A010` → `A01`. Returns null at the 3-character category root (a category has
+ * no parent code). Dots are already absent in storage form.
+ */
+export declare function icd10cmParent(code: string): string | null;
+/**
+ * Derive the parent of a HCPCS code: the single-letter range bucket it belongs
+ * to (e.g. `J0120` → `J`). The bucket itself (a 1-char "code") has no parent.
+ */
+export declare function hcpcsParent(code: string): string | null;
+/**
+ * ICD-10-CM chapter label from the first character + leading digits of the
+ * category. The 3-char category prefix (letter + 2 digits) is a coarse but
+ * stable chapter bucket the order file doesn't carry explicitly; using the
+ * category-letter range keeps `chapter` queryable without a separate lookup
+ * table. Returns the leading letter, which buckets codes into their A/B/C…
+ * alpha chapter — enough for browse grouping.
+ */
+export declare function icd10cmChapterLetter(code: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/services/code-index/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/services/code-index/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,UAAU,u+CA4DtB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,gKACa,CAAC;AAE1C,eAAO,MAAM,cAAc,oFAAoF,CAAC;AAEhH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/services/code-index/schema.js

@@ -0,0 +1,129 @@
+/**
+ * @fileoverview Shared SQLite schema and code-shape derivation for the bundled
+ * medical-codes index. Imported by BOTH the runtime service (read) and the
+ * build script (write) so the table layout, FTS configuration, and the
+ * parent/chapter/header derivation rules can never drift between the two.
+ * @module services/code-index/schema
+ */
+/**
+ * Full DDL for the bundled database. Run once by the build/fixture scripts.
+ * `codes_fts` is an external-content FTS5 index over `codes` — triggers keep it
+ * in sync on insert so the build script only writes `codes`.
+ */
+export const SCHEMA_SQL = `
+CREATE TABLE codes (
+  system      TEXT NOT NULL,
+  code        TEXT NOT NULL,
+  short_desc  TEXT,
+  long_desc   TEXT,
+  billable    INTEGER NOT NULL DEFAULT 0,
+  header      INTEGER NOT NULL DEFAULT 0,
+  chapter     TEXT,
+  parent      TEXT,
+  effective   TEXT,
+  terminated  TEXT,
+  PRIMARY KEY (system, code)
+) WITHOUT ROWID;
+
+CREATE INDEX idx_codes_parent ON codes (system, parent);
+CREATE INDEX idx_codes_chapter ON codes (system, chapter);
+
+CREATE VIRTUAL TABLE codes_fts USING fts5 (
+  system UNINDEXED,
+  code UNINDEXED,
+  short_desc,
+  long_desc,
+  tokenize = 'unicode61'
+);
+
+CREATE TABLE pcs_axes (
+  position INTEGER NOT NULL,
+  value    TEXT NOT NULL,
+  meaning  TEXT NOT NULL,
+  PRIMARY KEY (position, value)
+) WITHOUT ROWID;
+
+CREATE TABLE rxnorm_rel (
+  rxcui       TEXT NOT NULL,
+  rel         TEXT NOT NULL,
+  target      TEXT NOT NULL,
+  target_type TEXT NOT NULL
+);
+
+CREATE INDEX idx_rxnorm_rel_rxcui ON rxnorm_rel (rxcui, rel);
+CREATE INDEX idx_rxnorm_rel_target ON rxnorm_rel (target, rel);
+
+CREATE TABLE ndc_map (
+  ndc   TEXT NOT NULL,
+  rxcui TEXT NOT NULL
+);
+
+CREATE INDEX idx_ndc_map_ndc ON ndc_map (ndc);
+CREATE INDEX idx_ndc_map_rxcui ON ndc_map (rxcui);
+
+CREATE TABLE build_meta (
+  system          TEXT PRIMARY KEY,
+  release_id      TEXT NOT NULL,
+  effective_start TEXT,
+  effective_end   TEXT,
+  code_count      INTEGER NOT NULL DEFAULT 0,
+  source_url      TEXT,
+  built_at        TEXT NOT NULL
+) WITHOUT ROWID;
+`;
+/**
+ * Insert a `codes` row and mirror it into the FTS index in one call. The build
+ * and fixture scripts use this so FTS population is centralized. `code` is the
+ * storage form (no dots).
+ */
+export const INSERT_CODE_SQL = `INSERT INTO codes (system, code, short_desc, long_desc, billable, header, chapter, parent, effective, terminated)
+   VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`;
+export const INSERT_FTS_SQL = `INSERT INTO codes_fts (system, code, short_desc, long_desc) VALUES (?, ?, ?, ?)`;
+/**
+ * Re-insert a dot into an ICD-10-CM storage code for display: a dot after the
+ * 3-character category when there are subsequent characters (`A0101` → `A01.01`).
+ * Storage codes are dot-free; display codes carry the dot the way clinicians write
+ * them. ICD-10-PCS, HCPCS, and RXCUI have no dot — returned unchanged.
+ */
+export function displayCode(system, storageCode) {
+    if (system !== 'ICD10CM')
+        return storageCode;
+    if (storageCode.length <= 3)
+        return storageCode;
+    return `${storageCode.slice(0, 3)}.${storageCode.slice(3)}`;
+}
+/**
+ * Normalize a user-supplied code to its storage form: uppercase, trimmed, and —
+ * for ICD-10-CM — with the dot stripped so `A01.01` and `A0101` both match the
+ * stored `A0101`.
+ */
+export function storageCode(rawCode) {
+    return rawCode.trim().toUpperCase().replace(/\./g, '');
+}
+/**
+ * Derive the parent of an ICD-10-CM code: strip the last character. `A0101` →
+ * `A010` → `A01`. Returns null at the 3-character category root (a category has
+ * no parent code). Dots are already absent in storage form.
+ */
+export function icd10cmParent(code) {
+    return code.length > 3 ? code.slice(0, -1) : null;
+}
+/**
+ * Derive the parent of a HCPCS code: the single-letter range bucket it belongs
+ * to (e.g. `J0120` → `J`). The bucket itself (a 1-char "code") has no parent.
+ */
+export function hcpcsParent(code) {
+    return code.length > 1 ? code.charAt(0) : null;
+}
+/**
+ * ICD-10-CM chapter label from the first character + leading digits of the
+ * category. The 3-char category prefix (letter + 2 digits) is a coarse but
+ * stable chapter bucket the order file doesn't carry explicitly; using the
+ * category-letter range keeps `chapter` queryable without a separate lookup
+ * table. Returns the leading letter, which buckets codes into their A/B/C…
+ * alpha chapter — enough for browse grouping.
+ */
+export function icd10cmChapterLetter(code) {
+    return code.charAt(0).toUpperCase();
+}
+//# sourceMappingURL=schema.js.map

package/dist/services/code-index/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/services/code-index/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;yCACU,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,iFAAiF,CAAC;AAEhH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAgB,EAAE,WAAmB;IAC/D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC7C,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAChD,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACtC,CAAC"}

package/dist/services/code-index/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Domain types for the code-index service — the bundled medical
+ * code systems, the row shapes the SQLite tables hold, and the query results
+ * the tools consume.
+ * @module services/code-index/types
+ */
+/** The four bundled US healthcare code systems. */
+export type SystemId = 'ICD10CM' | 'ICD10PCS' | 'HCPCS' | 'RXNORM';
+/** All system ids, in canonical display order. */
+export declare const SYSTEM_IDS: readonly SystemId[];
+/** Human-facing label for each system, surfaced in tool output and notices. */
+export declare const SYSTEM_LABELS: Record<SystemId, string>;
+/**
+ * A single code row from the `codes` table. The spine of the index — one row
+ * per code across all systems. `billable`/`header` are 0/1 integers in SQLite;
+ * the service maps them to booleans at the boundary.
+ */
+export interface CodeRow {
+    /** 1 = billable leaf code. 0 = not billable (header/category or completeness-only). */
+    billable: number;
+    /** Chapter label (ICD-10-CM/PCS) or range bucket (HCPCS). NULL when not applicable. */
+    chapter: string | null;
+    /** Storage form of the code — no dots, as it appears in the source order file. */
+    code: string;
+    /** Effective date (YYYYMMDD) when known. NULL otherwise. */
+    effective: string | null;
+    /** 1 = non-billable header/category row (ICD-10-CM). 0 otherwise. */
+    header: number;
+    longDesc: string | null;
+    /** Parent code (CM/HCPCS). NULL for ICD-10-PCS (axis-based, not prefix-based). */
+    parent: string | null;
+    shortDesc: string | null;
+    system: SystemId;
+    /** Termination date (YYYYMMDD) when the code is retired. NULL = active. */
+    terminated: string | null;
+}
+/** A provenance row from `build_meta` — one per bundled system. */
+export interface BuildMetaRow {
+    builtAt: string;
+    codeCount: number;
+    effectiveEnd: string | null;
+    effectiveStart: string | null;
+    releaseId: string;
+    sourceUrl: string | null;
+    system: SystemId;
+}
+/** An ICD-10-PCS axis-value row from `pcs_axes`. */
+export interface PcsAxisRow {
+    /** What that value means at that position. */
+    meaning: string;
+    /** Character position 1-7 in the PCS code. */
+    position: number;
+    /** The single-character axis value. */
+    value: string;
+}
+/** An RXCUI relationship edge from `rxnorm_rel`. */
+export interface RxNormRelRow {
+    /** Relationship/attribute label, e.g. 'has_ingredient', 'tradename_of', 'NDC'. */
+    rel: string;
+    rxcui: string;
+    target: string;
+    /** Concept type of the target, e.g. 'IN', 'BN', 'SCD', 'NDC'. */
+    targetType: string;
+}
+/** Discriminated validity status for `medcode_check_code`. */
+export type CheckStatus = 'valid_billable' | 'valid_not_billable' | 'valid_header' | 'terminated' | 'unknown';
+/** Crosswalk directions for `medcode_map_codes`. Drug directions land with RxNorm (phase 2). */
+export type MapDirection = 'parents' | 'children' | 'name_to_rxcui' | 'ndc_to_rxcui' | 'rxcui_to_ndc' | 'rxcui_to_ingredients' | 'rxcui_to_brands';
+/** Map directions that require the RxNorm tables (absent in v1). */
+export declare const DRUG_DIRECTIONS: readonly MapDirection[];
+//# sourceMappingURL=types.d.ts.map

package/dist/services/code-index/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/code-index/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnE,kDAAkD;AAClD,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAAwD,CAAC;AAEnG,+EAA+E;AAC/E,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAKlD,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kFAAkF;IAClF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GACnB,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,YAAY,GACZ,SAAS,CAAC;AAEd,gGAAgG;AAChG,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,UAAU,GACV,eAAe,GACf,cAAc,GACd,cAAc,GACd,sBAAsB,GACtB,iBAAiB,CAAC;AAEtB,oEAAoE;AACpE,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAMzC,CAAC"}

package/dist/services/code-index/types.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Domain types for the code-index service — the bundled medical
+ * code systems, the row shapes the SQLite tables hold, and the query results
+ * the tools consume.
+ * @module services/code-index/types
+ */
+/** All system ids, in canonical display order. */
+export const SYSTEM_IDS = ['ICD10CM', 'ICD10PCS', 'HCPCS', 'RXNORM'];
+/** Human-facing label for each system, surfaced in tool output and notices. */
+export const SYSTEM_LABELS = {
+    ICD10CM: 'ICD-10-CM',
+    ICD10PCS: 'ICD-10-PCS',
+    HCPCS: 'HCPCS Level II',
+    RXNORM: 'RxNorm',
+};
+/** Map directions that require the RxNorm tables (absent in v1). */
+export const DRUG_DIRECTIONS = [
+    'name_to_rxcui',
+    'ndc_to_rxcui',
+    'rxcui_to_ndc',
+    'rxcui_to_ingredients',
+    'rxcui_to_brands',
+];
+//# sourceMappingURL=types.js.map

package/dist/services/code-index/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/code-index/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAEnG,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAA6B;IACrD,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;IACtB,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,QAAQ;CACjB,CAAC;AA4EF,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,eAAe;IACf,cAAc;IACd,cAAc;IACd,sBAAsB;IACtB,iBAAiB;CACT,CAAC"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@cyanheads/medical-codes-mcp-server",
+  "version": "0.1.0",
+  "description": "Decode, search, validate, and crosswalk US medical codes — ICD-10-CM, ICD-10-PCS, HCPCS Level II — over a bundled offline index via MCP. STDIO or Streamable HTTP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "medical-codes-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "data/medical-codes.db",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write .",
+    "format:unsafe": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/medical-codes-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/medical-codes-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "release:github": "bun run scripts/release-github.ts",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "icd-10-cm",
+    "icd-10-pcs",
+    "hcpcs",
+    "medical-codes",
+    "medical-coding",
+    "healthcare"
+  ],
+  "mcpName": "io.github.cyanheads/medical-codes-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/medical-codes-mcp-server.git"
+  },
+  "homepage": "https://github.com/cyanheads/medical-codes-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/cyanheads/medical-codes-mcp-server/issues"
+  },
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/medical-codes-mcp-server#readme)",
+  "license": "Apache-2.0",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "packageManager": "bun@1.3.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.10.6",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "^12.10.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "25.9.3",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}

package/server.json

@@ -0,0 +1,125 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/medical-codes-mcp-server",
+  "description": "Offline US medical code lookup and crosswalk — ICD-10-CM, ICD-10-PCS, HCPCS Level II. Keyless.",
+  "repository": {
+    "url": "https://github.com/cyanheads/medical-codes-mcp-server",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/medical-codes-mcp-server",
+      "runtimeHint": "node",
+      "version": "0.1.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:stdio"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        },
+        {
+          "name": "MEDCODE_DB_PATH",
+          "description": "Absolute path override for the bundled SQLite index. Defaults to the packaged data/medical-codes.db.",
+          "format": "string",
+          "isRequired": false
+        },
+        {
+          "name": "MEDCODE_MAX_RESULTS",
+          "description": "Cap on rows returned by search and browse tools (default 50, hard ceiling 200).",
+          "format": "string",
+          "isRequired": false,
+          "default": "50"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/medical-codes-mcp-server",
+      "runtimeHint": "node",
+      "version": "0.1.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:http"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        },
+        {
+          "name": "MEDCODE_DB_PATH",
+          "description": "Absolute path override for the bundled SQLite index. Defaults to the packaged data/medical-codes.db.",
+          "format": "string",
+          "isRequired": false
+        },
+        {
+          "name": "MEDCODE_MAX_RESULTS",
+          "description": "Cap on rows returned by search and browse tools (default 50, hard ceiling 200).",
+          "format": "string",
+          "isRequired": false,
+          "default": "50"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}