@cyanheads/medical-codes-mcp-server 0.1.0

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

@@ -0,0 +1,91 @@
+/**
+ * @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 { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCodeIndexService } from '../../../services/code-index/code-index-service.js';
+import { SYSTEM_IDS, SYSTEM_LABELS } from '../../../services/code-index/types.js';
+const SOURCE_URL = 'https://github.com/cyanheads/medical-codes-mcp-server/blob/main/src/mcp-server/tools/definitions/check-code.tool.ts';
+export const checkCodeTool = tool('medcode_check_code', {
+    title: 'medical-codes-mcp-server',
+    description: 'Validate whether a US medical code exists, is current, and is billable in the active bundled release. Returns a discriminated status — valid_billable, valid_not_billable, valid_header, or terminated — with a `whyNot` explaining non-billable and terminated cases (e.g. "valid ICD-10-CM category but not billable — submit a more specific child code"). This is the detail a coder needs before submitting a claim. Auto-detects the system from the code\'s shape; pass an explicit `system` to disambiguate. A non-billable or terminated code is a successful result with a whyNot, not an error — only a code that exists in no bundled system raises unknown_code.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    sourceUrl: SOURCE_URL,
+    input: z.object({
+        code: z.string().min(1).describe('The code to validate, with or without dots.'),
+        system: z
+            .enum(SYSTEM_IDS)
+            .optional()
+            .describe("Force the lookup into this system. Omit to auto-detect from the code's shape."),
+    }),
+    output: z.object({
+        system: z.string().describe('The system the code was resolved in, echoed for chaining.'),
+        code: z.string().describe('The code in display form (ICD-10-CM carries the dot).'),
+        status: z
+            .enum(['valid_billable', 'valid_not_billable', 'valid_header', 'terminated'])
+            .describe('Validity status. valid_billable = submit as-is; valid_header/valid_not_billable = needs a more specific code; terminated = retired.'),
+        billable: z.boolean().describe('True only when status is valid_billable.'),
+        whyNot: z
+            .string()
+            .nullable()
+            .describe('Explanation for non-billable/terminated statuses, or null when valid_billable.'),
+    }),
+    errors: [
+        {
+            reason: 'unknown_code',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The code does not exist in the named or detected system.',
+            recovery: 'Check the code, or search by description with medcode_search_codes.',
+        },
+        {
+            reason: 'ambiguous_system',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The code is present in more than one bundled system and no `system` was given.',
+            recovery: 'Re-call with an explicit `system` to disambiguate.',
+        },
+    ],
+    handler(input, ctx) {
+        const outcome = getCodeIndexService().checkCode(input.code, input.system);
+        if (outcome.kind === 'ambiguous') {
+            throw ctx.fail('ambiguous_system', `"${input.code.trim()}" exists in multiple systems: ${outcome.systems.join(', ')}.`, { candidateSystems: outcome.systems, ...ctx.recoveryFor('ambiguous_system') });
+        }
+        const r = outcome.result;
+        if (r.status === 'unknown') {
+            throw ctx.fail('unknown_code', r.whyNot ?? `Unknown code "${input.code.trim()}".`, {
+                ...ctx.recoveryFor('unknown_code'),
+            });
+        }
+        ctx.log.info('Checked code', { code: r.code, system: r.system, status: r.status });
+        return {
+            system: r.system,
+            code: r.code,
+            status: r.status,
+            billable: r.status === 'valid_billable',
+            whyNot: r.whyNot ?? null,
+        };
+    },
+    format: (result) => {
+        const label = SYSTEM_LABELS[result.system] ?? result.system;
+        const verdict = {
+            valid_billable: '✅ Valid and billable',
+            valid_not_billable: '⚠️ Valid but not billable',
+            valid_header: '⚠️ Valid category/header — not billable',
+            terminated: '⛔ Terminated',
+        };
+        const lines = [
+            `## ${result.code} — ${label}`,
+            `**Status:** ${verdict[result.status]}`,
+            `**Billable:** ${result.billable ? 'Yes' : 'No'}`,
+        ];
+        if (result.whyNot)
+            lines.push('', result.whyNot);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=check-code.tool.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview medcode_get_code — decode one or more codes to their official
+ * descriptions across ICD-10-CM, ICD-10-PCS, HCPCS Level II, and (phase 2)
+ * RxNorm. The 80% entry point: resolve a code seen in a claim, EHR field, or
+ * another health server's output into its meaning. Auto-detects the system from
+ * each code's shape; an explicit `system` disambiguates. Array-in /
+ * partial-success-out — one bad code never fails the rest.
+ * @module mcp-server/tools/definitions/get-code.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getCodeTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    codes: z.ZodArray<z.ZodString>;
+    system: z.ZodOptional<z.ZodEnum<{
+        ICD10CM: "ICD10CM";
+        ICD10PCS: "ICD10PCS";
+        HCPCS: "HCPCS";
+        RXNORM: "RXNORM";
+    }>>;
+    includeHierarchy: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    found: 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>;
+        parent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        children: z.ZodOptional<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>>>;
+    }, z.core.$strip>>;
+    notFound: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        reason: z.ZodString;
+        candidateSystems: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_codes_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "None of the requested codes exist in any bundled system.";
+    readonly recovery: "Verify code formatting, or call medcode_search_codes with a description to find the right code.";
+}], undefined>;
+//# sourceMappingURL=get-code.tool.d.ts.map

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

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

package/dist/mcp-server/tools/definitions/get-code.tool.js

@@ -0,0 +1,165 @@
+/**
+ * @fileoverview medcode_get_code — decode one or more codes to their official
+ * descriptions across ICD-10-CM, ICD-10-PCS, HCPCS Level II, and (phase 2)
+ * RxNorm. The 80% entry point: resolve a code seen in a claim, EHR field, or
+ * another health server's output into its meaning. Auto-detects the system from
+ * each code's shape; an explicit `system` disambiguates. Array-in /
+ * partial-success-out — one bad code never fails the rest.
+ * @module mcp-server/tools/definitions/get-code.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { CodeIndexService, getCodeIndexService } from '../../../services/code-index/code-index-service.js';
+import { SYSTEM_IDS } from '../../../services/code-index/types.js';
+import { renderCodeBlock, renderCodeLine } from './_render.js';
+const SOURCE_URL = 'https://github.com/cyanheads/medical-codes-mcp-server/blob/main/src/mcp-server/tools/definitions/get-code.tool.ts';
+const DecodedCodeSchema = z
+    .object({
+    system: z
+        .string()
+        .describe('The system that answered, echoed for chaining: "ICD10CM", "ICD10PCS", "HCPCS", or "RXNORM".'),
+    code: z
+        .string()
+        .describe('The resolved code in display form (ICD-10-CM codes carry the dot, e.g. "E11.9").'),
+    description: z
+        .string()
+        .nullable()
+        .describe('Official long description (falls back to the short description when no long form exists).'),
+    shortDescription: z
+        .string()
+        .nullable()
+        .describe('Official short/abbreviated description, or null when none is on record.'),
+    billable: z
+        .boolean()
+        .describe('True when the code is a billable leaf. False for headers/categories and non-billable codes.'),
+    header: z
+        .boolean()
+        .describe('True when the code is a non-billable category/header (ICD-10-CM) rather than a leaf code.'),
+    chapter: z
+        .string()
+        .nullable()
+        .describe('Chapter/range bucket the code belongs to, or null when not applicable.'),
+})
+    .describe('A decoded code with its official descriptions and derived flags.');
+/** A found code, optionally carrying its hierarchy when includeHierarchy is set. */
+const FoundCodeSchema = DecodedCodeSchema.extend({
+    parent: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Immediate parent code (present only when includeHierarchy is true). Null at a root.'),
+    children: z
+        .array(DecodedCodeSchema)
+        .optional()
+        .describe('Immediate child codes (present only when includeHierarchy is true).'),
+}).describe('A decoded code, optionally with its parent and immediate children.');
+/** A code that did not resolve, with a per-code reason. */
+const NotFoundCodeSchema = z
+    .object({
+    code: z.string().describe('The input code that could not be resolved.'),
+    reason: z
+        .string()
+        .describe('Why it could not be resolved (unknown shape, not in the bundled release, or ambiguous).'),
+    candidateSystems: z
+        .array(z.string())
+        .optional()
+        .describe('When ambiguous, the systems whose shape/content the code matched — re-call with one as `system`.'),
+})
+    .describe('An input code that did not resolve, with the reason it failed.');
+export const getCodeTool = tool('medcode_get_code', {
+    title: 'medical-codes-mcp-server',
+    description: "Decode one or more US medical codes to their official descriptions across ICD-10-CM (diagnoses), ICD-10-PCS (inpatient procedures), HCPCS Level II (supplies/drugs/services), and — when bundled — RxNorm (drugs). Auto-detects the system from each code's shape; pass an explicit `system` only when a value is genuinely ambiguous. Accepts 1–50 codes and returns partial success: resolved codes in `found`, unresolved in `notFound` with a per-code reason, so one bad code never fails the batch. Set `includeHierarchy` to attach each code's parent and immediate children. The resolved `system` is echoed on every result for chaining into medcode_map_codes or a billability check.",
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    sourceUrl: SOURCE_URL,
+    input: z.object({
+        codes: z
+            .array(z.string().min(1).describe('A single code to decode, with or without dots.'))
+            .min(1)
+            .max(50)
+            .describe('Codes to decode (1–50). Mixed systems are fine — each is detected independently.'),
+        system: z
+            .enum(SYSTEM_IDS)
+            .optional()
+            .describe('Force every code to be looked up in this system. Omit to auto-detect per code.'),
+        includeHierarchy: z
+            .boolean()
+            .default(false)
+            .describe("When true, attach each found code's parent and immediate children."),
+    }),
+    output: z.object({
+        found: z.array(FoundCodeSchema).describe('Successfully decoded codes, in request order.'),
+        notFound: z
+            .array(NotFoundCodeSchema)
+            .describe('Codes that did not resolve, with per-code reasons.'),
+    }),
+    errors: [
+        {
+            reason: 'no_codes_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'None of the requested codes exist in any bundled system.',
+            recovery: 'Verify code formatting, or call medcode_search_codes with a description to find the right code.',
+        },
+    ],
+    handler(input, ctx) {
+        const svc = getCodeIndexService();
+        const found = [];
+        const notFound = [];
+        for (const raw of input.codes) {
+            const result = svc.getByCode(raw, input.system);
+            if (result.kind === 'not_found') {
+                const shapes = svc.detectSystem(raw);
+                notFound.push({
+                    code: raw,
+                    reason: shapes.length === 0
+                        ? `"${raw}" does not match the shape of any bundled code system.`
+                        : `"${raw}" is not present in the bundled release (matched shape: ${shapes.join(', ')}).`,
+                });
+            }
+            else if (result.kind === 'ambiguous') {
+                notFound.push({
+                    code: raw,
+                    reason: `"${raw}" matches multiple systems — re-call with an explicit \`system\` to disambiguate.`,
+                    candidateSystems: result.systems,
+                });
+            }
+            else if (input.includeHierarchy) {
+                found.push(svc.getByCodeWithHierarchy(result.row));
+            }
+            else {
+                found.push(CodeIndexService.project(result.row));
+            }
+        }
+        ctx.log.info('Decoded codes', {
+            requested: input.codes.length,
+            found: found.length,
+            notFound: notFound.length,
+        });
+        if (found.length === 0) {
+            throw ctx.fail('no_codes_found', `None of the ${input.codes.length} requested code(s) resolved in any bundled system.`, { ...ctx.recoveryFor('no_codes_found') });
+        }
+        return { found, notFound };
+    },
+    format: (result) => {
+        const lines = [];
+        for (const c of result.found) {
+            lines.push(...renderCodeBlock(c));
+            if (c.parent !== undefined)
+                lines.push(`**Parent:** ${c.parent ?? '(none — root)'}`);
+            if (c.children && c.children.length > 0) {
+                lines.push(`**Children (${c.children.length}):**`);
+                for (const k of c.children)
+                    lines.push(renderCodeLine(k));
+            }
+            lines.push('');
+        }
+        if (result.notFound.length > 0) {
+            lines.push(`### Not found (${result.notFound.length})`);
+            for (const n of result.notFound) {
+                const cands = n.candidateSystems?.length ? ` [${n.candidateSystems.join(', ')}]` : '';
+                lines.push(`- **${n.code}**: ${n.reason}${cands}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n').trim() }];
+    },
+});
+//# sourceMappingURL=get-code.tool.js.map

package/dist/mcp-server/tools/definitions/get-code.tool.js.map

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

package/dist/mcp-server/tools/definitions/list-systems.tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview medcode_list_systems — list the bundled code systems with their
+ * release identifiers, effective dates, and code counts. Cheap orientation /
+ * provenance call so a caller can confirm which ICD-10 fiscal year, HCPCS
+ * release, and RxNorm month are active before acting on results.
+ * @module mcp-server/tools/definitions/list-systems.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const listSystemsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    systems: z.ZodArray<z.ZodObject<{
+        system: z.ZodString;
+        label: z.ZodString;
+        releaseId: z.ZodString;
+        effectiveStart: z.ZodNullable<z.ZodString>;
+        effectiveEnd: z.ZodNullable<z.ZodString>;
+        codeCount: z.ZodNumber;
+        sourceUrl: z.ZodNullable<z.ZodString>;
+        builtAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=list-systems.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-systems.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-systems.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-systems.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAQjD,eAAO,MAAM,eAAe;;;;;;;;;;;wCA+E1B,CAAC"}

package/dist/mcp-server/tools/definitions/list-systems.tool.js

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview medcode_list_systems — list the bundled code systems with their
+ * release identifiers, effective dates, and code counts. Cheap orientation /
+ * provenance call so a caller can confirm which ICD-10 fiscal year, HCPCS
+ * release, and RxNorm month are active before acting on results.
+ * @module mcp-server/tools/definitions/list-systems.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getCodeIndexService } from '../../../services/code-index/code-index-service.js';
+import { SYSTEM_LABELS } from '../../../services/code-index/types.js';
+const SOURCE_URL = 'https://github.com/cyanheads/medical-codes-mcp-server/blob/main/src/mcp-server/tools/definitions/list-systems.tool.ts';
+export const listSystemsTool = tool('medcode_list_systems', {
+    title: 'medical-codes-mcp-server',
+    description: 'List the bundled US medical code systems with their release identifiers, effective dates, and code counts. Confirms which ICD-10-CM fiscal year, ICD-10-PCS fiscal year, HCPCS Level II release, and (when bundled) RxNorm month are active before acting on any decode, search, or crosswalk result. The corpus is offline and built at package-build time — this call reports exactly which release is baked into the running server. ICD-10-CM/PCS are the US clinical modifications, not the ICD-10/ICD-11 base.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    sourceUrl: SOURCE_URL,
+    input: z.object({}),
+    output: z.object({
+        systems: z
+            .array(z
+            .object({
+            system: z
+                .string()
+                .describe('System identifier, e.g. "ICD10CM", "ICD10PCS", "HCPCS", "RXNORM".'),
+            label: z.string().describe('Human-readable system name, e.g. "ICD-10-CM".'),
+            releaseId: z
+                .string()
+                .describe('Release/version identifier baked into this build, e.g. "ICD-10-CM FY2026".'),
+            effectiveStart: z
+                .string()
+                .nullable()
+                .describe('First date this release is effective (YYYY-MM-DD), or null if not recorded.'),
+            effectiveEnd: z
+                .string()
+                .nullable()
+                .describe('Last date this release is effective (YYYY-MM-DD), or null if open-ended.'),
+            codeCount: z.number().describe('Number of code rows bundled for this system.'),
+            sourceUrl: z
+                .string()
+                .nullable()
+                .describe('Canonical .gov source the release was built from, or null.'),
+            builtAt: z.string().describe('ISO 8601 timestamp when this system was last baked.'),
+        })
+            .describe('Provenance for one bundled code system.'))
+            .describe('One entry per bundled code system, in canonical order.'),
+    }),
+    handler(_input, ctx) {
+        const systems = getCodeIndexService()
+            .listSystems()
+            .map((s) => ({
+            system: s.system,
+            label: SYSTEM_LABELS[s.system] ?? s.system,
+            releaseId: s.releaseId,
+            effectiveStart: s.effectiveStart,
+            effectiveEnd: s.effectiveEnd,
+            codeCount: s.codeCount,
+            sourceUrl: s.sourceUrl,
+            builtAt: s.builtAt,
+        }));
+        ctx.log.info('Listed bundled code systems', { count: systems.length });
+        return { systems };
+    },
+    format: (result) => {
+        const lines = ['## Bundled code systems', ''];
+        lines.push('| System | Release | Effective | Codes |');
+        lines.push('|:---|:---|:---|---:|');
+        for (const s of result.systems) {
+            const effective = s.effectiveStart && s.effectiveEnd
+                ? `${s.effectiveStart} → ${s.effectiveEnd}`
+                : (s.effectiveStart ?? s.effectiveEnd ?? '—');
+            lines.push(`| ${s.label} (${s.system}) | ${s.releaseId} | ${effective} | ${s.codeCount} |`);
+        }
+        lines.push('');
+        for (const s of result.systems) {
+            if (s.sourceUrl)
+                lines.push(`- **${s.label}** source: ${s.sourceUrl} (built ${s.builtAt})`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-systems.tool.js.map

package/dist/mcp-server/tools/definitions/list-systems.tool.js.map

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

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

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview medcode_map_codes — crosswalk a code or drug across systems and
+ * within a hierarchy. v1 ships the hierarchy directions (code → parents/children);
+ * the drug directions (drug name → RXCUI, NDC ↔ RXCUI, RXCUI → ingredients/brands)
+ * land with RxNorm in phase 2 and raise `direction_unavailable` until then. The
+ * relational bridge between the bundled systems and a composition point with the
+ * openfda server (NDC/labels).
+ * @module mcp-server/tools/definitions/map-codes.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const mapCodesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    from: z.ZodString;
+    direction: z.ZodEnum<{
+        parents: "parents";
+        children: "children";
+        name_to_rxcui: "name_to_rxcui";
+        ndc_to_rxcui: "ndc_to_rxcui";
+        rxcui_to_ndc: "rxcui_to_ndc";
+        rxcui_to_ingredients: "rxcui_to_ingredients";
+        rxcui_to_brands: "rxcui_to_brands";
+    }>;
+    system: z.ZodOptional<z.ZodEnum<{
+        ICD10CM: "ICD10CM";
+        ICD10PCS: "ICD10PCS";
+        HCPCS: "HCPCS";
+        RXNORM: "RXNORM";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    from: z.ZodString;
+    direction: z.ZodString;
+    resolvedSystem: z.ZodNullable<z.ZodString>;
+    hits: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        system: z.ZodNullable<z.ZodString>;
+        value: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_mapping";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The source resolved but has no edge in the requested direction.";
+    readonly recovery: "Confirm the direction is supported for this system, or decode the code with medcode_get_code first.";
+}, {
+    readonly reason: "direction_unavailable";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "A drug-crosswalk direction was requested before RxNorm (phase 2) is bundled.";
+    readonly recovery: "Use a hierarchy direction (parents/children); drug crosswalks land with RxNorm.";
+}, {
+    readonly reason: "ambiguous_system";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The source code is present in more than one system and no `system` was given.";
+    readonly recovery: "Re-call with an explicit `system` to disambiguate.";
+}], undefined>;
+//# sourceMappingURL=map-codes.tool.d.ts.map

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

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

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

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview medcode_map_codes — crosswalk a code or drug across systems and
+ * within a hierarchy. v1 ships the hierarchy directions (code → parents/children);
+ * the drug directions (drug name → RXCUI, NDC ↔ RXCUI, RXCUI → ingredients/brands)
+ * land with RxNorm in phase 2 and raise `direction_unavailable` until then. The
+ * relational bridge between the bundled systems and a composition point with the
+ * openfda server (NDC/labels).
+ * @module mcp-server/tools/definitions/map-codes.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { CodeIndexService, getCodeIndexService } from '../../../services/code-index/code-index-service.js';
+import { SYSTEM_IDS } from '../../../services/code-index/types.js';
+const SOURCE_URL = 'https://github.com/cyanheads/medical-codes-mcp-server/blob/main/src/mcp-server/tools/definitions/map-codes.tool.ts';
+const DIRECTIONS = [
+    'parents',
+    'children',
+    'name_to_rxcui',
+    'ndc_to_rxcui',
+    'rxcui_to_ndc',
+    'rxcui_to_ingredients',
+    'rxcui_to_brands',
+];
+export const mapCodesTool = tool('medcode_map_codes', {
+    title: 'medical-codes-mcp-server',
+    description: "Crosswalk a US medical code or drug across systems and within a hierarchy. Hierarchy directions (available now): `parents` and `children` walk a code's prefix hierarchy (ICD-10-CM/HCPCS; ICD-10-PCS codes have no prefix parent). Drug directions (RxNorm): `name_to_rxcui`, `ndc_to_rxcui`, `rxcui_to_ndc`, `rxcui_to_ingredients`, `rxcui_to_brands` — these return an error until RxNorm is bundled in a later release. Every result carries `source` provenance (which system or edge answered) so a chained call (e.g. into openfda with a resolved NDC) uses the right identifier.",
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    sourceUrl: SOURCE_URL,
+    input: z.object({
+        from: z
+            .string()
+            .min(1)
+            .describe('The source value: a code (for parents/children), a drug name, an NDC, or an RXCUI.'),
+        direction: z
+            .enum(DIRECTIONS)
+            .describe('What to map to. parents/children walk the code hierarchy; the rxcui/ndc/name directions are RxNorm drug crosswalks (phase 2).'),
+        system: z
+            .enum(SYSTEM_IDS)
+            .optional()
+            .describe('For parents/children, force the source code into this system. Omit to auto-detect.'),
+    }),
+    output: z.object({
+        from: z.string().describe('The source value, echoed back.'),
+        direction: z.string().describe('The mapping direction that was applied.'),
+        resolvedSystem: z
+            .string()
+            .nullable()
+            .describe('The system the source resolved in, or null when not system-scoped.'),
+        hits: z
+            .array(z
+            .object({
+            source: z
+                .string()
+                .describe('Which system or relationship edge produced this hit (e.g. "ICD10CM", "has_ingredient", "NDC").'),
+            system: z
+                .string()
+                .nullable()
+                .describe('The code system of the target value, or null when the target is not a system code (e.g. an NDC).'),
+            value: z.string().describe('The mapped target value (a code, RXCUI, or NDC).'),
+            description: z
+                .string()
+                .optional()
+                .describe('Description of the target when available.'),
+        })
+            .describe('One crosswalk result tagged with the edge that produced it.'))
+            .describe('Crosswalk results, each tagged with the edge that produced it.'),
+    }),
+    errors: [
+        {
+            reason: 'no_mapping',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The source resolved but has no edge in the requested direction.',
+            recovery: 'Confirm the direction is supported for this system, or decode the code with medcode_get_code first.',
+        },
+        {
+            reason: 'direction_unavailable',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'A drug-crosswalk direction was requested before RxNorm (phase 2) is bundled.',
+            recovery: 'Use a hierarchy direction (parents/children); drug crosswalks land with RxNorm.',
+        },
+        {
+            reason: 'ambiguous_system',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The source code is present in more than one system and no `system` was given.',
+            recovery: 'Re-call with an explicit `system` to disambiguate.',
+        },
+    ],
+    handler(input, ctx) {
+        const svc = getCodeIndexService();
+        if (CodeIndexService.isDrugDirection(input.direction) && !svc.hasRxNorm()) {
+            throw ctx.fail('direction_unavailable', `The "${input.direction}" crosswalk needs RxNorm, which is not bundled in this release.`, { ...ctx.recoveryFor('direction_unavailable') });
+        }
+        const result = svc.mapCode(input.from, input.direction, input.system);
+        if (result.kind === 'ambiguous') {
+            throw ctx.fail('ambiguous_system', `"${input.from.trim()}" exists in multiple systems: ${result.systems.join(', ')}.`, { candidateSystems: result.systems, ...ctx.recoveryFor('ambiguous_system') });
+        }
+        if (result.kind === 'source_not_found') {
+            throw ctx.fail('no_mapping', `No "${input.direction}" mapping found for "${input.from.trim()}".`, { ...ctx.recoveryFor('no_mapping') });
+        }
+        if (result.hits.length === 0) {
+            throw ctx.fail('no_mapping', `"${input.from.trim()}" resolved but has no ${input.direction} (e.g. a top-level code has no parent).`, { ...ctx.recoveryFor('no_mapping') });
+        }
+        ctx.log.info('Mapped code', {
+            from: input.from,
+            direction: input.direction,
+            hits: result.hits.length,
+        });
+        return {
+            from: input.from.trim(),
+            direction: input.direction,
+            resolvedSystem: result.resolvedSystem,
+            hits: result.hits.map((h) => ({
+                source: h.source,
+                system: h.system,
+                value: h.value,
+                ...(h.description ? { description: h.description } : {}),
+            })),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## ${result.direction}: ${result.from}`,
+            result.resolvedSystem ? `**Resolved system:** ${result.resolvedSystem}` : '',
+            '',
+        ].filter(Boolean);
+        for (const h of result.hits) {
+            lines.push(`- **${h.value}**${h.system ? ` (${h.system})` : ''} via ${h.source}${h.description ? `: ${h.description}` : ''}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=map-codes.tool.js.map