Package Exports

tebra-mcp-server
tebra-mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tebra-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@allure-md/tebra-mcp-server

MCP server for Tebra (Kareo) practice management. Exposes patient data, encounters, authorizations, appointments, charges, eligibility, and procedure codes to Claude and other MCP-compatible clients.

Prerequisites

Node.js 18+
Tebra SOAP API credentials (generated in Tebra PM admin under Settings > API)

Environment Variables

Variable	Required	Description
`TEBRA_SOAP_USER`	Yes	SOAP API user (email)
`TEBRA_SOAP_PASSWORD`	Yes	SOAP API password
`TEBRA_CUSTOMER_KEY`	Yes	Customer key from Tebra PM admin
`TEBRA_SOAP_ENDPOINT`	No	Override SOAP endpoint (for testing)

Setup

cd tebra-mcp-server
npm install
npm run build

Usage

Direct execution

TEBRA_SOAP_USER=user@practice.com \
TEBRA_SOAP_PASSWORD=secret \
TEBRA_CUSTOMER_KEY=abc123 \
node dist/index.js

Claude Desktop configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "tebra": {
      "command": "node",
      "args": ["/path/to/tebra-mcp-server/dist/index.js"],
      "env": {
        "TEBRA_SOAP_USER": "user@practice.com",
        "TEBRA_SOAP_PASSWORD": "your-password",
        "TEBRA_CUSTOMER_KEY": "your-customer-key"
      }
    }
  }
}

Claude Code configuration

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "tebra": {
      "command": "node",
      "args": ["./tebra-mcp-server/dist/index.js"],
      "env": {
        "TEBRA_SOAP_USER": "user@practice.com",
        "TEBRA_SOAP_PASSWORD": "your-password",
        "TEBRA_CUSTOMER_KEY": "your-customer-key"
      }
    }
  }
}

Available Tools

Tool	Description
`tebra_search_patients`	Search patients by name, DOB, MRN, or external ID
`tebra_get_patient`	Get full patient record with insurance and authorizations
`tebra_get_patient_authorizations`	Get all authorizations across cases with status and remaining visits
`tebra_get_encounter`	Get encounter details with linked charges and procedures
`tebra_create_encounter`	Create a new encounter (superbill) with diagnoses and procedures
`tebra_get_appointments`	Get appointments within a date range, optionally by provider
`tebra_check_insurance_eligibility`	Check insurance eligibility based on on-file data
`tebra_get_charges`	Get charges with payment status, filterable by date and patient
`tebra_get_procedure_codes`	Get practice procedure codes with fees

API Reference

The server wraps the Tebra/Kareo SOAP API v2.1:

Endpoint: https://webservice.kareo.com/services/soap/2.1/KareoServices.svc
Auth: RequestHeader with User, Password, CustomerKey
All requests include retry with exponential backoff (3 attempts)

Development

npm run dev  # Uses tsx for direct TypeScript execution