A Model Context Protocol (MCP) server that provides seamless integration with the Kipu API. This server enables AI assistants and applications to access comprehensive healthcare data including patient records, vital signs, medications, appointments, and more through a secure, standardized interface.
This MCP server is brought to you by Wrkdn - the leading platform for AI-powered healthcare compliance and revenue optimization.
- 📈 Increase Revenue: Find missed billing opportunities and boost insurance reimbursements
- 🛡️ Ensure Compliance: Automated protocol tracking reduces regulatory risk by up to 40%
- ⚡ Real-time Monitoring: AI-powered oversight of clinical protocols and documentation
- 🎯 Prevent Errors: Proactive alerts help staff maintain compliance before issues escalate
"Ensuring clinical compliance isn't just about avoiding penalties — it's about protecting patients and supporting frontline staff. Wrkdn's proactive approach is a game-changer."
- Joel N.H. Stern, PhD, Professor of Neurology, Zucker School of Medicine
Run the MCP server:
npx kipu-mcpOr programmatically:
const { spawn } = require('child_process');
const mcpServer = spawn('npx', ['kipu-mcp'], {
env: {
...process.env,
KIPU_ACCESS_ID: 'your_access_id',
KIPU_SECRET_KEY: 'your_secret_key',
KIPU_APP_ID: 'your_app_id'
}
});| Variable | Description | Required |
|---|---|---|
KIPU_ACCESS_ID |
Your Kipu API access identifier | ✅ |
KIPU_SECRET_KEY |
Secret key for HMAC signature generation | ✅ |
KIPU_APP_ID |
Application ID for your Kipu integration | ✅ |
To obtain your Kipu API credentials:
- Contact Kipu Systems to set up your healthcare integration
- Request API access for your healthcare facility
- Receive your
ACCESS_ID,SECRET_KEY, andAPP_ID
The Kipu MCP server provides access to a comprehensive set of healthcare data endpoints:
- GetPatientsCensus - List all patients from a census of the database
- GetPatientsLatest - List patients with updated_at within a date range
- GetPatientsOccupancy - Occupancy
- GetPatientsByPatientId - Fetch a Patient Record
- GetVaultsPatients - Lists all soft-deleted patients
- GetPatientsCareTeam - List a patient's care team
- GetPatientsCareTeams - List all patients' care teams
- GetPatientsMedications - List medications for a specific patient
- GetMedications - List all medications
- GetPatientsAllergies - List allergies scoped to a patient
- GetAllergens - List all allergens
- GetAllergies - List all allergies
- GetPatientsDiagnoses - List diagnoses for a specific patient
- GetDiagnoses - List all diagnoses
- GetPatientsDiagnosisHistory - List a patient's diagnosis history
- GetPatientsVitalSigns - List all vital signs scoped to a given patient
- GetVitalSigns - List all vital signs
- GetPatientsOrthostaticVitalSigns - List all Orthostatic vital signs scoped to a given patient
- GetOrthostaticVitalSigns - List all orthostatic vital signs
- GetPatientsCiwaArs - List all CiwaArs scoped to a given patient
- GetCiwaArs - List all CiwaArs
- GetPatientsCiwaBs - List all CiwaBs scoped to a given patient
- GetCiwaBs - List all CiwaBs
- GetPatientsCows - List all Cows scoped to a given patient
- GetCows - List all Cows
- GetPatientsGlucoseLogs - List all Glucose Logs scoped to a given patient
- GetGlucoseLogs - List all GlucoseLogs
- GetAppointments - List and search appointments
- GetAppointmentsByAppointmentId - Fetch an Appointment Record
- GetPatientsAppointments - List all appointments scoped to a given patient
- GetProvidersAppointments - List all appointments scoped to a given provider
- GetUsersAppointments - List all appointments scoped to a given user
- GetSchedulerAppointments - List all appointments
- GetSchedulerAppointmentByAppointmentId - Fetch an appointment
- GetSchedulerAppointmentTypes - List all appointment types
- GetSchedulerAppointmentStatuses - List all appointment statuses
- GetSchedulerResources - List all resources
- GetPatientsOrders - List patient orders
- GetPatientOrders - List all patient orders
- GetPatientOrderByPatientOrderId - Fetch Details of a Patient Order
- GetPatientsPatientOrders - List all patient orders scoped to a patient
- GetPatientsAdmissions - List patient admissions history
- GetPatientsProgramHistory - List a patient's program history
- GetPatientsEvaluations - List all patient evaluations
- GetPatientsProcesses - List all patient processes
- GetEvaluations - List all Evaluations
- GetEvaluationByEvaluationId - Fetch Details for a Evaluation
- GetPatientEvaluations - List all Patient Evaluations
- GetPatientEvaluationByPatientEvaluationId - Fetch Details for a Patient Evaluation
- GetPatientsPatientEvaluations - List all Patient Evaluations scoped to a patient
- GetGroupSessions - List all group sessions
- GetGroupSessionsById - Fetches a group session
- GetPatientsGroupSessions - List all group sessions scoped to a given patient
- GetPatientsGroupSessionsById - Fetches group session of the given patient
- GetPatientsInsurance - List insurance information for a specific patient
- GetInsurances - List insurances with updated_at within a date range
- GetPatientsUtilizationReviews - List patient utilization reviews
- GetUtilizationReviewsLatest - List utilization reviews with updated_at within a date range
- GetSettingsPayors - List all payors
- GetConsentForms - List all Consent Forms
- GetConsentFormRecords - List all Consent Form Records
- GetConsentFormRecordsByRecordId - Fetch Details for a Consent Form Record
- GetPatientsConsentFormRecords - List all Consent Form Records for a patient
- GetUsers - List all Users
- GetUsersById - Fetch a User Record
- GetUsersRoles - List all roles scoped to a given user
- GetProviders - List all Providers
- GetProvidersById - Fetch a Provider Record
- GetProvidersRoles - List all roles scoped to a given provider
- GetRoles - List all Roles
- GetRolesUsers - List all users scoped to a given role
- GetUserTitles - List user titles
- GetLocations - List all locations
- GetCareLevels - List all Levels of Care
- GetContacts - List all contacts
- GetContactsById - Fetches a contact
- GetContactsReferrers - List all referrers
- GetContactTypes - List all contact types
- GetPatientSettings - List all patient settings
- GetPatientColors - List all patient colors
- GetPatientTags - List all patient tags
- GetPatientDiets - List all patient diets
- GetPatientsPatientDiets - List patient diets scoped to a patient
- GetFlags - List all flags
- GetFlagCategories - List all flag categories
The server implements Kipu's secure APIAuth authentication system using HMAC-SHA1 signatures:
- All requests are signed with your secret key
- Timestamps prevent replay attacks
- Secure header-based authentication
- PHI (Protected Health Information) access levels supported
- Node.js 20.0.0 or higher
- TypeScript 5.8+
- Valid Kipu API credentials
-
Clone the repository:
git clone https://github.com/Wrkdn/kipu-mcp.git cd kipu-mcp -
Install dependencies:
npm install
-
Set up environment variables:
cp .env.example .env # Edit .env with your credentials -
Run local dev:
npm run dev
npm run dev- Run with hot reload using tsxnpm run build- Compile TypeScript to JavaScript
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
For detailed API documentation, visit the Kipu API Documentation.
- GitHub Repository: https://github.com/Wrkdn/kipu-mcp
- NPM Package: https://www.npmjs.com/package/kipu-mcp
- Wrkdn Platform: https://wrkdn.com
This project is licensed under the MIT License - see the LICENSE file for details.
- Technical Issues: Create an issue
- API Questions: Contact Kipu Systems
Built with ❤️ by the Wrkdn team for the healthcare community.