tebra-mcp-server 0.1.0

package/dist/tools/encounters.js.map

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

package/dist/tools/patients.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Tebra MCP tools: Patient search and retrieval.
+ */
+import type { TebraConfig } from '../config.js';
+export declare const patientTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            patientId?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            patientId: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function handlePatientTool(name: string, args: Record<string, unknown>, config: TebraConfig): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=patients.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patients.d.ts","sourceRoot":"","sources":["../../src/tools/patients.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAWhD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BxB,CAAC;AAIF,wBAAsB,iBAAiB,CACrC,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,CAmE7D"}

package/dist/tools/patients.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Tebra MCP tools: Patient search and retrieval.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patientTools = void 0;
+exports.handlePatientTool = handlePatientTool;
+const soap_client_js_1 = require("../soap-client.js");
+// ─── Tool Definitions ───────────────────────────────────────────
+exports.patientTools = [
+    {
+        name: 'tebra_search_patients',
+        description: 'Search for patients in Tebra by name, DOB, MRN, or external ID. Returns demographics and insurance policies.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query — patient name, date of birth, MRN, or external ID',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'tebra_get_patient',
+        description: 'Get full patient record from Tebra by patient ID, including insurance policies, cases, and authorizations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                patientId: {
+                    type: 'string',
+                    description: 'Tebra patient ID',
+                },
+            },
+            required: ['patientId'],
+        },
+    },
+];
+// ─── Tool Handler ───────────────────────────────────────────────
+async function handlePatientTool(name, args, config) {
+    switch (name) {
+        case 'tebra_search_patients': {
+            const query = String(args.query ?? '');
+            if (!query || query.length < 2) {
+                return {
+                    content: [{ type: 'text', text: 'Search query must be at least 2 characters.' }],
+                };
+            }
+            const bodyXml = `
+        <kar:request>
+          <kar:Fields>
+            <kar:PatientFullName>${(0, soap_client_js_1.escapeXml)(query)}</kar:PatientFullName>
+          </kar:Fields>
+        </kar:request>`;
+            const xml = await (0, soap_client_js_1.soapRequest)(config, 'GetPatients', bodyXml);
+            const patients = parsePatientList(xml);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: patients.length === 0
+                            ? `No patients found for query: "${query}"`
+                            : JSON.stringify(patients, null, 2),
+                    },
+                ],
+            };
+        }
+        case 'tebra_get_patient': {
+            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 patient = parsePatientBlock(patientBlock);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(patient, null, 2) }],
+            };
+        }
+        default:
+            return {
+                content: [{ type: 'text', text: `Unknown patient tool: ${name}` }],
+            };
+    }
+}
+function parsePatientList(xml) {
+    const blocks = (0, soap_client_js_1.extractAllTags)(xml, 'PatientData');
+    return blocks.map(parsePatientBlock);
+}
+function parsePatientBlock(block) {
+    const insuranceBlocks = (0, soap_client_js_1.extractAllTags)(block, 'InsurancePolicyData');
+    const caseBlocks = (0, soap_client_js_1.extractAllTags)(block, 'CaseData');
+    const authorizations = [];
+    for (const caseBlock of caseBlocks) {
+        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');
+            authorizations.push({
+                authNumber: (0, soap_client_js_1.extractTag)(authBlock, 'AuthorizationNumber'),
+                insurancePlan: (0, soap_client_js_1.extractTag)(authBlock, 'InsurancePlanName'),
+                status: computeAuthStatus(authBlock, approved, used),
+                approvedVisits: approved,
+                usedVisits: used,
+                remainingVisits: Math.max(0, approved - used),
+                startDate: (0, soap_client_js_1.extractTag)(authBlock, 'StartDate'),
+                endDate: (0, soap_client_js_1.extractTag)(authBlock, 'EndDate'),
+            });
+        }
+    }
+    return {
+        patientId: (0, soap_client_js_1.extractTag)(block, 'PatientID') || (0, soap_client_js_1.extractTag)(block, 'ID'),
+        firstName: (0, soap_client_js_1.extractTag)(block, 'FirstName'),
+        lastName: (0, soap_client_js_1.extractTag)(block, 'LastName'),
+        dateOfBirth: (0, soap_client_js_1.extractTag)(block, 'DateofBirth') || (0, soap_client_js_1.extractTag)(block, 'DOB'),
+        mrn: (0, soap_client_js_1.extractTag)(block, 'MRN'),
+        insurances: insuranceBlocks.map((ins) => ({
+            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'),
+            isPrimary: ((0, soap_client_js_1.extractNumber)(ins, 'SequenceNumber') || 1) === 1,
+        })),
+        authorizations,
+    };
+}
+function computeAuthStatus(block, approved, used) {
+    const remaining = approved - used;
+    if (remaining <= 0)
+        return 'exhausted';
+    const endDate = (0, soap_client_js_1.extractTag)(block, 'EndDate');
+    if (endDate && new Date(endDate) < new Date())
+        return 'expired';
+    const authNumber = (0, soap_client_js_1.extractTag)(block, 'AuthorizationNumber');
+    if (!authNumber)
+        return 'pending';
+    return 'active';
+}
+//# sourceMappingURL=patients.js.map

package/dist/tools/patients.js.map

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

package/dist/tools/procedure-codes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tebra MCP tools: Practice procedure code lookup.
+ */
+import type { TebraConfig } from '../config.js';
+export declare const procedureCodeTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            searchTerm: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+}[];
+export declare function handleProcedureCodeTool(name: string, args: Record<string, unknown>, config: TebraConfig): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=procedure-codes.d.ts.map

package/dist/tools/procedure-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-codes.d.ts","sourceRoot":"","sources":["../../src/tools/procedure-codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;GAgB9B,CAAC;AAIF,wBAAsB,uBAAuB,CAC3C,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,CAkC7D"}

package/dist/tools/procedure-codes.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Tebra MCP tools: Practice procedure code lookup.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.procedureCodeTools = void 0;
+exports.handleProcedureCodeTool = handleProcedureCodeTool;
+const soap_client_js_1 = require("../soap-client.js");
+// ─── Tool Definitions ───────────────────────────────────────────
+exports.procedureCodeTools = [
+    {
+        name: 'tebra_get_procedure_codes',
+        description: 'Get procedure codes configured in the Tebra practice. Optionally filter by CPT code or search term. Returns codes with descriptions and default fees.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                searchTerm: {
+                    type: 'string',
+                    description: 'Optional CPT code or search term to filter by',
+                },
+            },
+            required: [],
+        },
+    },
+];
+// ─── Tool Handler ───────────────────────────────────────────────
+async function handleProcedureCodeTool(name, args, config) {
+    if (name !== 'tebra_get_procedure_codes') {
+        return { content: [{ type: 'text', text: `Unknown procedure code tool: ${name}` }] };
+    }
+    const searchTerm = args.searchTerm ? String(args.searchTerm) : undefined;
+    const bodyXml = `
+    <kar:request>
+      <kar:Fields>
+        ${searchTerm ? `<kar:Code>${(0, soap_client_js_1.escapeXml)(searchTerm)}</kar:Code>` : ''}
+      </kar:Fields>
+    </kar:request>`;
+    const xml = await (0, soap_client_js_1.soapRequest)(config, 'GetProcedureCodes', bodyXml);
+    const blocks = (0, soap_client_js_1.extractAllTags)(xml, 'ProcedureCodeData');
+    const codes = blocks.map((block) => ({
+        procedureCodeId: (0, soap_client_js_1.extractTag)(block, 'ProcedureCodeID') || (0, soap_client_js_1.extractTag)(block, 'ID'),
+        code: (0, soap_client_js_1.extractTag)(block, 'Code') || (0, soap_client_js_1.extractTag)(block, 'ProcedureCode'),
+        description: (0, soap_client_js_1.extractTag)(block, 'Description') || (0, soap_client_js_1.extractTag)(block, 'OfficialDescription'),
+        defaultFee: (0, soap_client_js_1.extractTag)(block, 'DefaultFee') || '0',
+    }));
+    if (codes.length === 0) {
+        const msg = searchTerm
+            ? `No procedure codes found matching "${searchTerm}".`
+            : 'No procedure codes configured in the practice.';
+        return { content: [{ type: 'text', text: msg }] };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(codes, null, 2) }],
+    };
+}
+//# sourceMappingURL=procedure-codes.js.map

package/dist/tools/procedure-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure-codes.js","sourceRoot":"","sources":["../../src/tools/procedure-codes.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA2BH,0DAsCC;AA9DD,sDAAuF;AAEvF,mEAAmE;AAEtD,QAAA,kBAAkB,GAAG;IAChC;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,uJAAuJ;QACzJ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAEF,mEAAmE;AAE5D,KAAK,UAAU,uBAAuB,CAC3C,IAAY,EACZ,IAA6B,EAC7B,MAAmB;IAEnB,IAAI,IAAI,KAAK,2BAA2B,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzE,MAAM,OAAO,GAAG;;;UAGR,UAAU,CAAC,CAAC,CAAC,aAAa,IAAA,0BAAS,EAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE;;mBAExD,CAAC;IAElB,MAAM,GAAG,GAAG,MAAM,IAAA,4BAAW,EAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAA,+BAAc,EAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IAExD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,eAAe,EAAE,IAAA,2BAAU,EAAC,KAAK,EAAE,iBAAiB,CAAC,IAAI,IAAA,2BAAU,EAAC,KAAK,EAAE,IAAI,CAAC;QAChF,IAAI,EAAE,IAAA,2BAAU,EAAC,KAAK,EAAE,MAAM,CAAC,IAAI,IAAA,2BAAU,EAAC,KAAK,EAAE,eAAe,CAAC;QACrE,WAAW,EAAE,IAAA,2BAAU,EAAC,KAAK,EAAE,aAAa,CAAC,IAAI,IAAA,2BAAU,EAAC,KAAK,EAAE,qBAAqB,CAAC;QACzF,UAAU,EAAE,IAAA,2BAAU,EAAC,KAAK,EAAE,YAAY,CAAC,IAAI,GAAG;KACnD,CAAC,CAAC,CAAC;IAEJ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,UAAU;YACpB,CAAC,CAAC,sCAAsC,UAAU,IAAI;YACtD,CAAC,CAAC,gDAAgD,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "tebra-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Tebra/Kareo practice management — exposes patient data, encounters, authorizations, and billing tools to AI agents via the Model Context Protocol",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "tebra-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "tebra",
+    "kareo",
+    "practice-management",
+    "medical-billing",
+    "healthcare",
+    "ehr",
+    "soap-api",
+    "claude",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jamesrosing/tebra-mcp-server.git"
+  },
+  "author": "James Rosing <james@allure-md.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}