io.usefulapiPublished by usefulapi.ioOfficial publisherv1.12.4Updated Nov 7, 2026
Read Halaxy patients, appointments, slots and invoices; create patients, appointments and notes.
The publisher's own server: Ably MCP by usefulapi
Hosted MCP server for Halaxy practice management: read patients, appointments, slots and invoices, and create patients, bookings and draft notes.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fhalaxy/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"halaxy-by-usefulapi": {
"type": "http",
"url": "https://halaxy.usefulapi.io/mcp"
}
}
}Live endpoint: https://halaxy.usefulapi.io/mcp
https://halaxy.usefulapi.io/mcp.claude mcp add --transport http halaxy https://halaxy.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Halaxy credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/halaxy/
On first connect you will paste your Halaxy Client ID and Client Secret. They are validated, stored per-user, and scoped to you. No keys in config files.
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with halaxy_upgrade (it returns a Stripe Checkout link). Cancel any time with halaxy_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running halaxy_upgrade before then undoes the cancel. Or write to [email protected].
MIT
Source: servers/halaxy/README.md at commit 4046075
List or search patients
List or search patient records (demographics and contact details; HEALTH DATA). Filters combine with AND. Paged: pass next_page as page. GET /main/Patient.
idnamepagesortcountemailgivenphonefamilystatuscreatedinclude+3 moreList practitioners
List or search practitioners and administrators of the practice group (ids look like PR-12345). Filters combine with AND. Paged: pass next_page as page. GET /main/Practitioner.
idnamepagesortcountemailgivenactivefamilyprofilelast_updatedList practitioner roles (clinic locations)
List or search practitioner roles: a practitioner's association with one clinic location (the id used when booking and for clinical notes). Filters combine with AND. Paged: pass next_page as page. GET /main/PractitionerRole.
idpagecountincludeprofilelast_updatedorganizationpractitionerprovider_numberList organizations and clinics
List or search the practice group, its clinic locations, funders and external practices (practice group ids look like PG-12345). Filters combine with AND. Paged: pass next_page as page. GET /main/Organization.
idnamepagecountprofilelast_updatedList appointments
List or search appointments (HEALTH DATA: names the patient). Filters combine with AND. Paged: pass next_page as page. GET /main/Appointment.
iddatepagesortcountcreatedincludepatientpart_statuslast_updatedorganizationpractitioner+2 moreList practitioner schedules
List or search schedules: containers of bookable time slots per practitioner. Filters combine with AND. Paged: pass next_page as page. GET /main/Schedule.
idpageactorcountactiveincludelast_updatedList time slots
List or search time slots of practitioner schedules (free or busy). Filters combine with AND. Paged: pass next_page as page. GET /main/Slot.
idendpagecountstartstatusincludedurationschedulelast_updatedorganizationpractitioner+1 moreList appointment types
List or search appointment types used by the practice group, clinics and practitioners. Filters combine with AND. Paged: pass next_page as page. GET /main/HealthcareService.
idnamepagecountactivelast_updatedList fees
List or search fees (ChargeItemDefinition): the services and products a practice charges for. Filters combine with AND. Paged: pass next_page as page. GET /main/ChargeItemDefinition.
idcodepagecounttitlecreatedpublishercontext_typelast_updatedproperty_group_statusList patient coverage (claim details)
List or search patients' health fund membership and claim details (HEALTH DATA). Filters combine with AND. Paged: pass next_page as page. GET /main/Coverage.
idpagesortcountpayorcreatedincludesubscriberbeneficiarylast_updatedsubscriber_idcoverage_organizationList invoices
List or search invoices of the practice group. Filters combine with AND. Paged: pass next_page as page. GET /main/Invoice.
idpagecountstatuscreatedincluderecipienttotal_paidlast_updatedorganizationpractitionertotal_balance+2 moreList invoice lines
List or search invoice lines: single fees on invoices. Filters combine with AND. Paged: pass next_page as page. GET /main/InvoiceLine.
idpagecountamountfundercreatedincludeinvoicesubjectcoveragereferralperformer+1 moreList payment transactions
List or search payment transactions recorded on invoices. Filters combine with AND. Paged: pass next_page as page. GET /main/PaymentTransaction.
idpagecountcreatedlast_updatedList referrals
List or search referrals from one healthcare provider to another (HEALTH DATA). Filters combine with AND. Paged: pass next_page as page. GET /main/Referral.
idpagesortcountcreatedincludesubjectcoveragelast_updatedList referral templates
List or search referral templates with preset properties. Filters combine with AND. Paged: pass next_page as page. GET /main/ReferralDefinition.
idpagecountlast_updatedfunding_organizationGet a patient
Fetch a patient record (HEALTH DATA) by id. GET /main/Patient/{id}.
idrequiredGet a practitioner
Fetch a practitioner or administrator by id. GET /main/Practitioner/{id}.
idrequiredGet a practitioner role
Fetch a practitioner role at a clinic location by id. GET /main/PractitionerRole/{id}.
idrequiredGet an organization
Fetch a practice group, clinic, funder or external practice by id. GET /main/Organization/{id}.
idrequiredGet an appointment
Fetch an appointment with its participants and statuses (HEALTH DATA) by id. GET /main/Appointment/{id}.
idrequiredGet a schedule
Fetch a practitioner schedule by id. GET /main/Schedule/{id}.
idrequiredGet a time slot
Fetch a time slot by id. GET /main/Slot/{id}.
idrequiredGet an appointment type
Fetch an appointment type by id. GET /main/HealthcareService/{id}.
idrequiredGet a fee
Fetch a fee (ChargeItemDefinition) by id. GET /main/ChargeItemDefinition/{id}.
idrequiredGet patient coverage
Fetch a patient's coverage (claim details) record by id. GET /main/Coverage/{id}.
idrequiredGet an invoice
Fetch an invoice by id. GET /main/Invoice/{id}.
idrequiredGet an invoice line
Fetch an invoice line by id. GET /main/InvoiceLine/{id}.
idrequiredGet a payment transaction
Fetch a payment transaction by id. GET /main/PaymentTransaction/{id}.
idrequiredGet a referral
Fetch a referral (HEALTH DATA) by id. GET /main/Referral/{id}.
idrequiredGet a referral template
Fetch a referral template by id. GET /main/ReferralDefinition/{id}.
idrequiredFind available appointment times
Find free appointment times between start and end for a given duration, respecting each practitioner's online booking preferences (buffer time, lead time, advance booking limit). Narrow it with practitioner, practitioner_role or organization. GET /main/Appointment/$find.
endrequiredshowsortstartrequireddurationrequiredemergencyorganizationpractitionerapply_buffer_timepractitioner_roleCreate a patient
Writes to the live Halaxy account. Creates a new patient record (always a new one: search with halaxy_list_patients first to avoid a duplicate). Pass managing_organization (the practice group id, e.g. PG-12345, from halaxy_list_organizations) if Halaxy asks for it. POST /main/Patient.
emailgivenrequiredfamilyrequiredgendermobileaddressbirth_datepreferred_namemanaging_organizationBook an appointment
Writes to the live Halaxy account. Books an appointment for a patient with a practitioner at a clinic (the practitioner role). Halaxy also creates the invoice, clinical note and reminder. Use halaxy_find_available_appointments for free times. By default a double booking is refused (HTTP 409, nothing created). POST /main/Appointment/$book.
endrequiredstartrequiredstatuspatient_idrequiredpractitioner_role_idrequiredhealthcare_service_idfail_on_double_bookingcharge_item_definition_idUpdate an appointment status
Writes to the live Halaxy account. Sets the patient's status on an appointment (shown in the Halaxy calendar), for example arrived, attended, confirmed or cancelled. "cancelled (no charge)" also sets the invoice to $0. For a group appointment pass patient_id to say whose status changes. PATCH /main/Appointment/{id}.
statusrequiredpatient_idappointment_idrequiredCreate a draft clinical note
Writes to the live Halaxy account. Adds a clinical note to a patient's record as a DRAFT (preliminary); the practitioner reviews and publishes it in Halaxy. The author is a PractitionerRole (practitioner at a clinic). Only HTML text is supported. POST /main/DocumentReference.
htmlrequiredtitlerequiredpatient_idrequiredpractitioner_role_idrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.
io.usefulapiOfficial publisher
Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.
io.usefulapiOfficial publisher
Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.
{ "mcpServers": { "halaxy": { "url": "https://halaxy.usefulapi.io/mcp" } }}