tebra-mcp-server 0.1.0

package/dist/tools/authorizations.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Tebra MCP tools: Patient authorization retrieval.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authorizationTools = void 0;
+exports.handleAuthorizationTool = handleAuthorizationTool;
+const soap_client_js_1 = require("../soap-client.js");
+// ─── Tool Definitions ───────────────────────────────────────────
+exports.authorizationTools = [
+    {
+        name: 'tebra_get_patient_authorizations',
+        description: 'Get all authorizations for a Tebra patient across all cases. Returns auth number, approved/used/remaining visits, expiry dates, and covered CPT codes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                patientId: {
+                    type: 'string',
+                    description: 'Tebra patient ID',
+                },
+            },
+            required: ['patientId'],
+        },
+    },
+];
+// ─── Tool Handler ───────────────────────────────────────────────
+async function handleAuthorizationTool(name, args, config) {
+    if (name !== 'tebra_get_patient_authorizations') {
+        return { content: [{ type: 'text', text: `Unknown authorization tool: ${name}` }] };
+    }
+    const patientId = String(args.patientId ?? '');
+    if (!patientId) {
+        return { content: [{ type: 'text', text: 'patientId is required.' }] };
+    }
+    const bodyXml = `
+    <kar:request>
+      <kar:Fields>
+        <kar:PatientID>${(0, soap_client_js_1.escapeXml)(patientId)}</kar:PatientID>
+      </kar:Fields>
+    </kar:request>`;
+    const xml = await (0, soap_client_js_1.soapRequest)(config, 'GetPatient', bodyXml);
+    const patientBlock = (0, soap_client_js_1.extractTag)(xml, 'Patient');
+    if (!patientBlock) {
+        return { content: [{ type: 'text', text: `Patient not found: ${patientId}` }] };
+    }
+    const caseBlocks = (0, soap_client_js_1.extractAllTags)(patientBlock, 'CaseData');
+    const authorizations = [];
+    for (const caseBlock of caseBlocks) {
+        const caseName = (0, soap_client_js_1.extractTag)(caseBlock, 'CaseName') || (0, soap_client_js_1.extractTag)(caseBlock, 'Name');
+        const authBlocks = (0, soap_client_js_1.extractAllTags)(caseBlock, 'AuthorizationData');
+        for (const authBlock of authBlocks) {
+            const approved = (0, soap_client_js_1.extractNumber)(authBlock, 'ApprovedVisits');
+            const used = (0, soap_client_js_1.extractNumber)(authBlock, 'UsedVisits');
+            const remaining = Math.max(0, approved - used);
+            const endDate = (0, soap_client_js_1.extractTag)(authBlock, 'EndDate');
+            const authNumber = (0, soap_client_js_1.extractTag)(authBlock, 'AuthorizationNumber');
+            let status = 'active';
+            if (remaining <= 0)
+                status = 'exhausted';
+            else if (endDate && new Date(endDate) < new Date())
+                status = 'expired';
+            else if (!authNumber)
+                status = 'pending';
+            // Check if expiring within 30 days
+            let expiringWarning;
+            if (status === 'active' && endDate) {
+                const daysUntilExpiry = Math.ceil((new Date(endDate).getTime() - Date.now()) / (1000 * 60 * 60 * 24));
+                if (daysUntilExpiry <= 30 && daysUntilExpiry > 0) {
+                    expiringWarning = `Authorization expires in ${daysUntilExpiry} days`;
+                }
+            }
+            const cptCodesRaw = (0, soap_client_js_1.extractTag)(authBlock, 'CPTCodes') || (0, soap_client_js_1.extractTag)(authBlock, 'ProcedureCodes');
+            const diagCodesRaw = (0, soap_client_js_1.extractTag)(authBlock, 'DiagnosisCodes');
+            authorizations.push({
+                caseName,
+                authorizationId: (0, soap_client_js_1.extractTag)(authBlock, 'AuthorizationID') || (0, soap_client_js_1.extractTag)(authBlock, 'ID'),
+                authNumber,
+                insurancePlan: (0, soap_client_js_1.extractTag)(authBlock, 'InsurancePlanName'),
+                status,
+                approvedVisits: approved,
+                usedVisits: used,
+                remainingVisits: remaining,
+                startDate: (0, soap_client_js_1.extractTag)(authBlock, 'StartDate'),
+                endDate,
+                approvedCptCodes: cptCodesRaw ? cptCodesRaw.split(',').map((c) => c.trim()).filter(Boolean) : [],
+                diagnosisCodes: diagCodesRaw ? diagCodesRaw.split(',').map((c) => c.trim()).filter(Boolean) : [],
+                notes: (0, soap_client_js_1.extractTag)(authBlock, 'Notes'),
+                expiringWarning,
+            });
+        }
+    }
+    if (authorizations.length === 0) {
+        return {
+            content: [{ type: 'text', text: `No authorizations found for patient ${patientId}.` }],
+        };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(authorizations, null, 2) }],
+    };
+}
+//# sourceMappingURL=authorizations.js.map

package/dist/tools/authorizations.js.map

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

package/dist/tools/charges.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tebra MCP tools: Charge retrieval.
+ */
+import type { TebraConfig } from '../config.js';
+export declare const chargeTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            fromDate: {
+                type: string;
+                description: string;
+            };
+            toDate: {
+                type: string;
+                description: string;
+            };
+            patientId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+}[];
+export declare function handleChargeTool(name: string, args: Record<string, unknown>, config: TebraConfig): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=charges.d.ts.map

package/dist/tools/charges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charges.d.ts","sourceRoot":"","sources":["../../src/tools/charges.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;GAwBvB,CAAC;AAIF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiD7D"}

package/dist/tools/charges.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Tebra MCP tools: Charge retrieval.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chargeTools = void 0;
+exports.handleChargeTool = handleChargeTool;
+const soap_client_js_1 = require("../soap-client.js");
+// ─── Tool Definitions ───────────────────────────────────────────
+exports.chargeTools = [
+    {
+        name: 'tebra_get_charges',
+        description: 'Get charges from Tebra with optional date range and patient filters. Returns charge details with payment status, amounts, and balances.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                fromDate: {
+                    type: 'string',
+                    description: 'Start date filter (ISO 8601)',
+                },
+                toDate: {
+                    type: 'string',
+                    description: 'End date filter (ISO 8601)',
+                },
+                patientId: {
+                    type: 'string',
+                    description: 'Optional Tebra patient ID to filter by',
+                },
+            },
+            required: [],
+        },
+    },
+];
+// ─── Tool Handler ───────────────────────────────────────────────
+async function handleChargeTool(name, args, config) {
+    if (name !== 'tebra_get_charges') {
+        return { content: [{ type: 'text', text: `Unknown charge tool: ${name}` }] };
+    }
+    const fromDate = args.fromDate ? String(args.fromDate) : undefined;
+    const toDate = args.toDate ? String(args.toDate) : undefined;
+    const patientId = args.patientId ? String(args.patientId) : undefined;
+    const fieldsXml = [
+        fromDate ? `<kar:FromServiceDate>${(0, soap_client_js_1.escapeXml)(fromDate)}</kar:FromServiceDate>` : '',
+        toDate ? `<kar:ToServiceDate>${(0, soap_client_js_1.escapeXml)(toDate)}</kar:ToServiceDate>` : '',
+        patientId ? `<kar:PatientID>${(0, soap_client_js_1.escapeXml)(patientId)}</kar:PatientID>` : '',
+    ]
+        .filter(Boolean)
+        .join('\n        ');
+    const bodyXml = `
+    <kar:request>
+      <kar:Fields>
+        ${fieldsXml}
+      </kar:Fields>
+    </kar:request>`;
+    const xml = await (0, soap_client_js_1.soapRequest)(config, 'GetCharges', bodyXml);
+    const blocks = (0, soap_client_js_1.extractAllTags)(xml, 'ChargeData');
+    const charges = blocks.map((block) => ({
+        chargeId: (0, soap_client_js_1.extractTag)(block, 'ChargeID') || (0, soap_client_js_1.extractTag)(block, 'ID'),
+        patientId: (0, soap_client_js_1.extractTag)(block, 'PatientID'),
+        patientName: (0, soap_client_js_1.extractTag)(block, 'PatientFullName'),
+        procedureCode: (0, soap_client_js_1.extractTag)(block, 'ProcedureCode'),
+        diagnosisCode: (0, soap_client_js_1.extractTag)(block, 'DiagnosisCode1'),
+        serviceDate: (0, soap_client_js_1.extractTag)(block, 'ServiceStartDate'),
+        amount: (0, soap_client_js_1.extractTag)(block, 'Amount'),
+        balance: (0, soap_client_js_1.extractTag)(block, 'Balance'),
+        paymentStatus: (0, soap_client_js_1.extractTag)(block, 'PaymentStatus') || (0, soap_client_js_1.extractTag)(block, 'Status'),
+        providerName: (0, soap_client_js_1.extractTag)(block, 'ProviderFullName'),
+    }));
+    if (charges.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No charges found matching the specified filters.' }],
+        };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(charges, null, 2) }],
+    };
+}
+//# sourceMappingURL=charges.js.map

package/dist/tools/charges.js.map

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

package/dist/tools/eligibility.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tebra MCP tools: Insurance eligibility checking.
+ *
+ * Note: Tebra SOAP API does not expose a direct real-time eligibility
+ * endpoint. This tool approximates eligibility by checking the patient's
+ * active insurance policies and authorization history.
+ */
+import type { TebraConfig } from '../config.js';
+export declare const eligibilityTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            patientId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function handleEligibilityTool(name: string, args: Record<string, unknown>, config: TebraConfig): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=eligibility.d.ts.map

package/dist/tools/eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../src/tools/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAWhD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;GAgB5B,CAAC;AAIF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA+E7D"}

package/dist/tools/eligibility.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Tebra MCP tools: Insurance eligibility checking.
+ *
+ * Note: Tebra SOAP API does not expose a direct real-time eligibility
+ * endpoint. This tool approximates eligibility by checking the patient's
+ * active insurance policies and authorization history.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eligibilityTools = void 0;
+exports.handleEligibilityTool = handleEligibilityTool;
+const soap_client_js_1 = require("../soap-client.js");
+// ─── Tool Definitions ───────────────────────────────────────────
+exports.eligibilityTools = [
+    {
+        name: 'tebra_check_insurance_eligibility',
+        description: 'Check insurance eligibility for a Tebra patient. Examines active insurance policies and authorization history. Note: this is an approximation based on on-file data, not a real-time payer eligibility check.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                patientId: {
+                    type: 'string',
+                    description: 'Tebra patient ID',
+                },
+            },
+            required: ['patientId'],
+        },
+    },
+];
+// ─── Tool Handler ───────────────────────────────────────────────
+async function handleEligibilityTool(name, args, config) {
+    if (name !== 'tebra_check_insurance_eligibility') {
+        return { content: [{ type: 'text', text: `Unknown eligibility tool: ${name}` }] };
+    }
+    const patientId = String(args.patientId ?? '');
+    if (!patientId) {
+        return { content: [{ type: 'text', text: 'patientId is required.' }] };
+    }
+    const bodyXml = `
+    <kar:request>
+      <kar:Fields>
+        <kar:PatientID>${(0, soap_client_js_1.escapeXml)(patientId)}</kar:PatientID>
+      </kar:Fields>
+    </kar:request>`;
+    const xml = await (0, soap_client_js_1.soapRequest)(config, 'GetPatient', bodyXml);
+    const patientBlock = (0, soap_client_js_1.extractTag)(xml, 'Patient');
+    if (!patientBlock) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        eligible: false,
+                        reason: 'Patient not found in Tebra',
+                        authRequired: false,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    const insuranceBlocks = (0, soap_client_js_1.extractAllTags)(patientBlock, 'InsurancePolicyData');
+    const caseBlocks = (0, soap_client_js_1.extractAllTags)(patientBlock, 'CaseData');
+    // Find primary insurance
+    let primaryInsurance = null;
+    for (const ins of insuranceBlocks) {
+        const seq = (0, soap_client_js_1.extractNumber)(ins, 'SequenceNumber');
+        if (seq === 1 || insuranceBlocks.length === 1) {
+            primaryInsurance = {
+                payerName: (0, soap_client_js_1.extractTag)(ins, 'PayerName') || (0, soap_client_js_1.extractTag)(ins, 'CompanyName'),
+                memberId: (0, soap_client_js_1.extractTag)(ins, 'MemberNumber') || (0, soap_client_js_1.extractTag)(ins, 'PolicyNumber'),
+            };
+            break;
+        }
+    }
+    // Check if any authorizations exist (indicates auth-required payer)
+    let hasActiveAuths = false;
+    for (const caseBlock of caseBlocks) {
+        const authBlocks = (0, soap_client_js_1.extractAllTags)(caseBlock, 'AuthorizationData');
+        if (authBlocks.length > 0) {
+            hasActiveAuths = true;
+            break;
+        }
+    }
+    const result = {
+        eligible: !!primaryInsurance,
+        planName: primaryInsurance?.payerName ?? null,
+        memberId: primaryInsurance?.memberId ?? null,
+        authRequired: hasActiveAuths,
+        insurancePoliciesOnFile: insuranceBlocks.length,
+        note: primaryInsurance
+            ? 'Eligibility based on on-file insurance data. Verify with payer for real-time status.'
+            : 'No insurance policies on file. Patient may be self-pay.',
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/tools/eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.js","sourceRoot":"","sources":["../../src/tools/eligibility.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAiCH,sDAmFC;AAjHD,sDAM2B;AAE3B,mEAAmE;AAEtD,QAAA,gBAAgB,GAAG;IAC9B;QACE,IAAI,EAAE,mCAAmC;QACzC,WAAW,EACT,+MAA+M;QACjN,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kBAAkB;iBAChC;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF;CACF,CAAC;AAEF,mEAAmE;AAE5D,KAAK,UAAU,qBAAqB,CACzC,IAAY,EACZ,IAA6B,EAC7B,MAAmB;IAEnB,IAAI,IAAI,KAAK,mCAAmC,EAAE,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IACpF,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG;;;yBAGO,IAAA,0BAAS,EAAC,SAAS,CAAC;;mBAE1B,CAAC;IAElB,MAAM,GAAG,GAAG,MAAM,IAAA,4BAAW,EAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAA,2BAAU,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAEhD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,QAAQ,EAAE,KAAK;wBACf,MAAM,EAAE,4BAA4B;wBACpC,YAAY,EAAE,KAAK;qBACpB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,+BAAc,EAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,IAAA,+BAAc,EAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAE5D,yBAAyB;IACzB,IAAI,gBAAgB,GAAmD,IAAI,CAAC;IAC5E,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,IAAA,8BAAa,EAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACjD,IAAI,GAAG,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,gBAAgB,GAAG;gBACjB,SAAS,EAAE,IAAA,2BAAU,EAAC,GAAG,EAAE,WAAW,CAAC,IAAI,IAAA,2BAAU,EAAC,GAAG,EAAE,aAAa,CAAC;gBACzE,QAAQ,EAAE,IAAA,2BAAU,EAAC,GAAG,EAAE,cAAc,CAAC,IAAI,IAAA,2BAAU,EAAC,GAAG,EAAE,cAAc,CAAC;aAC7E,CAAC;YACF,MAAM;QACR,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,IAAA,+BAAc,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;QAClE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,cAAc,GAAG,IAAI,CAAC;YACtB,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,CAAC,CAAC,gBAAgB;QAC5B,QAAQ,EAAE,gBAAgB,EAAE,SAAS,IAAI,IAAI;QAC7C,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,IAAI,IAAI;QAC5C,YAAY,EAAE,cAAc;QAC5B,uBAAuB,EAAE,eAAe,CAAC,MAAM;QAC/C,IAAI,EAAE,gBAAgB;YACpB,CAAC,CAAC,sFAAsF;YACxF,CAAC,CAAC,yDAAyD;KAC9D,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/tools/encounters.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Tebra MCP tools: Encounter creation and retrieval.
+ */
+import type { TebraConfig } from '../config.js';
+export declare const encounterTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            encounterId: {
+                type: string;
+                description: string;
+            };
+            patientId?: undefined;
+            providerId?: undefined;
+            serviceDate?: undefined;
+            diagnoses?: undefined;
+            procedures?: undefined;
+            authorizationId?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            patientId: {
+                type: string;
+                description: string;
+            };
+            providerId: {
+                type: string;
+                description: string;
+            };
+            serviceDate: {
+                type: string;
+                description: string;
+            };
+            diagnoses: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        code: {
+                            type: string;
+                            description: string;
+                        };
+                        description: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            procedures: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        code: {
+                            type: string;
+                            description: string;
+                        };
+                        modifiers: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                            description: string;
+                        };
+                        units: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            authorizationId: {
+                type: string;
+                description: string;
+            };
+            encounterId?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function handleEncounterTool(name: string, args: Record<string, unknown>, config: TebraConfig): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=encounters.d.ts.map

package/dist/tools/encounters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encounters.d.ts","sourceRoot":"","sources":["../../src/tools/encounters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwE1B,CAAC;AAeF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8G7D"}

package/dist/tools/encounters.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Tebra MCP tools: Encounter creation and retrieval.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encounterTools = void 0;
+exports.handleEncounterTool = handleEncounterTool;
+const soap_client_js_1 = require("../soap-client.js");
+// ─── Tool Definitions ───────────────────────────────────────────
+exports.encounterTools = [
+    {
+        name: 'tebra_get_encounter',
+        description: 'Get encounter details from Tebra by encounter ID, including linked charges, diagnoses, and procedures.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                encounterId: {
+                    type: 'string',
+                    description: 'Tebra encounter ID',
+                },
+            },
+            required: ['encounterId'],
+        },
+    },
+    {
+        name: 'tebra_create_encounter',
+        description: 'Create a new encounter (superbill) in Tebra with diagnoses and procedures. Returns the created encounter ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                patientId: {
+                    type: 'string',
+                    description: 'Tebra patient ID',
+                },
+                providerId: {
+                    type: 'string',
+                    description: 'Tebra provider ID',
+                },
+                serviceDate: {
+                    type: 'string',
+                    description: 'Date of service (ISO 8601, e.g. 2026-03-25)',
+                },
+                diagnoses: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            code: { type: 'string', description: 'ICD-10-CM code' },
+                            description: { type: 'string', description: 'Diagnosis description' },
+                        },
+                        required: ['code', 'description'],
+                    },
+                    description: 'Array of diagnosis codes',
+                },
+                procedures: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            code: { type: 'string', description: 'CPT code' },
+                            modifiers: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'CPT modifiers (e.g. ["-25", "-59"])',
+                            },
+                            units: { type: 'number', description: 'Number of units (default 1)' },
+                        },
+                        required: ['code'],
+                    },
+                    description: 'Array of procedure codes',
+                },
+                authorizationId: {
+                    type: 'string',
+                    description: 'Optional authorization ID to link',
+                },
+            },
+            required: ['patientId', 'providerId', 'serviceDate', 'diagnoses', 'procedures'],
+        },
+    },
+];
+async function handleEncounterTool(name, args, config) {
+    switch (name) {
+        case 'tebra_get_encounter': {
+            const encounterId = String(args.encounterId ?? '');
+            if (!encounterId) {
+                return { content: [{ type: 'text', text: 'encounterId is required.' }] };
+            }
+            const bodyXml = `
+        <kar:request>
+          <kar:Fields>
+            <kar:EncounterID>${(0, soap_client_js_1.escapeXml)(encounterId)}</kar:EncounterID>
+          </kar:Fields>
+        </kar:request>`;
+            const xml = await (0, soap_client_js_1.soapRequest)(config, 'GetEncounterDetails', bodyXml);
+            return { content: [{ type: 'text', text: formatEncounterXml(xml) }] };
+        }
+        case 'tebra_create_encounter': {
+            const patientId = String(args.patientId ?? '');
+            const providerId = String(args.providerId ?? '');
+            const serviceDate = String(args.serviceDate ?? '');
+            const diagnoses = (args.diagnoses ?? []);
+            const procedures = (args.procedures ?? []);
+            if (!patientId || !providerId || !serviceDate) {
+                return {
+                    content: [{ type: 'text', text: 'patientId, providerId, and serviceDate are required.' }],
+                };
+            }
+            if (diagnoses.length === 0 || procedures.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'At least one diagnosis and one procedure are required.' }],
+                };
+            }
+            const diagnosisXml = diagnoses
+                .map((dx, i) => `
+          <kar:EncounterDiagnosisReq>
+            <kar:DiagnosisCode>${(0, soap_client_js_1.escapeXml)(dx.code)}</kar:DiagnosisCode>
+            <kar:Description>${(0, soap_client_js_1.escapeXml)(dx.description)}</kar:Description>
+            <kar:Sequence>${i + 1}</kar:Sequence>
+          </kar:EncounterDiagnosisReq>`)
+                .join('');
+            const procedureXml = procedures
+                .map((px) => `
+          <kar:EncounterProcedureReq>
+            <kar:ProcedureCode>${(0, soap_client_js_1.escapeXml)(px.code)}</kar:ProcedureCode>
+            ${px.modifiers?.[0] ? `<kar:Modifier1>${(0, soap_client_js_1.escapeXml)(px.modifiers[0])}</kar:Modifier1>` : ''}
+            ${px.modifiers?.[1] ? `<kar:Modifier2>${(0, soap_client_js_1.escapeXml)(px.modifiers[1])}</kar:Modifier2>` : ''}
+            ${px.modifiers?.[2] ? `<kar:Modifier3>${(0, soap_client_js_1.escapeXml)(px.modifiers[2])}</kar:Modifier3>` : ''}
+            ${px.modifiers?.[3] ? `<kar:Modifier4>${(0, soap_client_js_1.escapeXml)(px.modifiers[3])}</kar:Modifier4>` : ''}
+            <kar:Units>${px.units ?? 1}</kar:Units>
+          </kar:EncounterProcedureReq>`)
+                .join('');
+            const authNumber = args.authorizationId ? String(args.authorizationId) : '';
+            const bodyXml = `
+        <kar:request>
+          <kar:Encounter>
+            <kar:PatientID>${(0, soap_client_js_1.escapeXml)(patientId)}</kar:PatientID>
+            <kar:ProviderID>${(0, soap_client_js_1.escapeXml)(providerId)}</kar:ProviderID>
+            <kar:ServiceStartDate>${(0, soap_client_js_1.escapeXml)(serviceDate)}</kar:ServiceStartDate>
+            <kar:ServiceEndDate>${(0, soap_client_js_1.escapeXml)(serviceDate)}</kar:ServiceEndDate>
+            ${authNumber ? `<kar:AuthorizationNumber>${(0, soap_client_js_1.escapeXml)(authNumber)}</kar:AuthorizationNumber>` : ''}
+            <kar:EncounterDiagnoses>${diagnosisXml}</kar:EncounterDiagnoses>
+            <kar:EncounterProcedures>${procedureXml}</kar:EncounterProcedures>
+          </kar:Encounter>
+        </kar:request>`;
+            const xml = await (0, soap_client_js_1.soapRequest)(config, 'CreateEncounter', bodyXml);
+            const encounterId = (0, soap_client_js_1.extractTag)(xml, 'EncounterID') || (0, soap_client_js_1.extractTag)(xml, 'ID');
+            const status = (0, soap_client_js_1.extractTag)(xml, 'Status') || 'created';
+            const errorMsg = (0, soap_client_js_1.extractTag)(xml, 'ErrorMessage');
+            if (errorMsg) {
+                return {
+                    content: [{ type: 'text', text: `Encounter creation error: ${errorMsg}` }],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            encounterId,
+                            status,
+                            message: `Encounter created successfully with ${diagnoses.length} diagnoses and ${procedures.length} procedures.`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        default:
+            return { content: [{ type: 'text', text: `Unknown encounter tool: ${name}` }] };
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────
+function formatEncounterXml(xml) {
+    // Extract key encounter fields for a readable response
+    const encounterId = (0, soap_client_js_1.extractTag)(xml, 'EncounterID');
+    const patientName = (0, soap_client_js_1.extractTag)(xml, 'PatientFullName');
+    const serviceDate = (0, soap_client_js_1.extractTag)(xml, 'ServiceStartDate');
+    const status = (0, soap_client_js_1.extractTag)(xml, 'Status');
+    return JSON.stringify({
+        encounterId,
+        patientName,
+        serviceDate,
+        status,
+        rawDataAvailable: true,
+    }, null, 2);
+}
+//# sourceMappingURL=encounters.js.map