Halaxy MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.12.4更新於 Nov 7, 2026

Read Halaxy patients, appointments, slots and invoices; create patients, appointments and notes.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行位置與生活金融商業與電商

概覽

AI 產生的概覽

供 Halaxy 診所管理使用的託管 MCP 伺服器:讀取病患、預約、時段與發票,並可建立病患、預約與草稿病歷。

可以做什麼
  • 列出並取得病患、執業人員、執業角色、機構與診所
  • 列出並取得排班、時段、預約類型與預約
  • 尋找符合預約偏好的空閒看診時間
  • 列出並取得費用、保險給付、發票、發票明細、付款交易、轉診與轉診範本
  • 建立病患、預約看診、更新預約狀態、新增草稿臨床紀錄
  • 查看用量、提出功能需求、升級或取消訂閱
適用情境
適合使用 Halaxy 的診所與櫃檯人員,讓助理回答當天預約、病患資料、可預約時段或未付發票等問題,並在不開啟 Halaxy 的情況下建立預約與草稿紀錄。
執行需求
需將 halaxy.usefulapi.io/mcp 新增為遠端 MCP 伺服器;用戶端設定中不要填 API 金鑰或 Authorization 標頭。透過 OAuth 登入,首次連線時需貼上 Halaxy Client ID 與 Client Secret,並依使用者儲存。需要 Halaxy 帳號;免費方案每月 50 次工具呼叫。
安裝前請注意
涉及健康資料:病患基本資料、預約、保險給付與轉診會提供給助理及託管服務。寫入類工具會變更線上 Halaxy 帳號:建立病患可能產生重複紀錄,預約會同時產生發票、病歷與提醒,狀態變更(例如「取消(不收費)」)會修改發票。付費方案需付費(Pro 每月 9 美元或每年 90 美元,Pro+ 每月 39 美元或每年 390 美元),取消當期不退費。Halaxy Client ID 與 Client Secret 會交給託管服務商。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Halaxy MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fhalaxy/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "halaxy-by-usefulapi": {
      "type": "http",
      "url": "https://halaxy.usefulapi.io/mcp"
    }
  }
}

README

Halaxy MCP by usefulapi

Live endpoint: https://halaxy.usefulapi.io/mcp

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://halaxy.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http halaxy https://halaxy.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "halaxy": {      "url": "https://halaxy.usefulapi.io/mcp"    }  }}

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.

Tools

ToolTypeWhat it does
halaxy_list_patientsreadList or search patients
halaxy_list_practitionersreadList practitioners
halaxy_list_practitioner_rolesreadList practitioner roles (clinic locations)
halaxy_list_organizationsreadList organizations and clinics
halaxy_list_appointmentsreadList appointments
halaxy_list_schedulesreadList practitioner schedules
halaxy_list_slotsreadList time slots
halaxy_list_healthcare_servicesreadList appointment types
halaxy_list_feesreadList fees
halaxy_list_coveragereadList patient coverage (claim details)
halaxy_list_invoicesreadList invoices
halaxy_list_invoice_linesreadList invoice lines
halaxy_list_payment_transactionsreadList payment transactions
halaxy_list_referralsreadList referrals
halaxy_list_referral_definitionsreadList referral templates
halaxy_get_patientreadGet a patient
halaxy_get_practitionerreadGet a practitioner
halaxy_get_practitioner_rolereadGet a practitioner role
halaxy_get_organizationreadGet an organization
halaxy_get_appointmentreadGet an appointment
halaxy_get_schedulereadGet a schedule
halaxy_get_slotreadGet a time slot
halaxy_get_healthcare_servicereadGet an appointment type
halaxy_get_feereadGet a fee
halaxy_get_coveragereadGet patient coverage
halaxy_get_invoicereadGet an invoice
halaxy_get_invoice_linereadGet an invoice line
halaxy_get_payment_transactionreadGet a payment transaction
halaxy_get_referralreadGet a referral
halaxy_get_referral_definitionreadGet a referral template
halaxy_find_available_appointmentsreadFind available appointment times
halaxy_create_patientwriteCreate a patient
halaxy_create_appointmentwriteBook an appointment
halaxy_update_appointment_statuswriteUpdate an appointment status
halaxy_create_clinical_notewriteCreate a draft clinical note
halaxy_usage_statusmetaUsage status (free-tier meter)
halaxy_request_featuremetaRequest a missing feature
halaxy_upgrademetaUpgrade to Pro or Pro+
halaxy_cancel_subscriptionmetaCancel the Pro subscription

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.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per account)$9/mo or $90/yr (2 months free)Unlimited*

*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].

License

MIT

來源:servers/halaxy/README.md,提交 4046075

工具

35

halaxy_list_patients

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 個

halaxy_list_practitioners

List 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_updated

halaxy_list_practitioner_roles

List 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_number

halaxy_list_organizations

List 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_updated

halaxy_list_appointments

List 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 個

halaxy_list_schedules

List 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_updated

halaxy_list_slots

List 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 個

halaxy_list_healthcare_services

List 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_updated

halaxy_list_fees

List 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_status

halaxy_list_coverage

List 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_organization

halaxy_list_invoices

List 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 個

halaxy_list_invoice_lines

List 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 個

halaxy_list_payment_transactions

List payment transactions

List or search payment transactions recorded on invoices. Filters combine with AND. Paged: pass next_page as page. GET /main/PaymentTransaction.

輸入參數idpagecountcreatedlast_updated

halaxy_list_referrals

List 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_updated

halaxy_list_referral_definitions

List 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_organization

halaxy_get_patient

Get a patient

Fetch a patient record (HEALTH DATA) by id. GET /main/Patient/{id}.

輸入參數id必填

halaxy_get_practitioner

Get a practitioner

Fetch a practitioner or administrator by id. GET /main/Practitioner/{id}.

輸入參數id必填

halaxy_get_practitioner_role

Get a practitioner role

Fetch a practitioner role at a clinic location by id. GET /main/PractitionerRole/{id}.

輸入參數id必填

halaxy_get_organization

Get an organization

Fetch a practice group, clinic, funder or external practice by id. GET /main/Organization/{id}.

輸入參數id必填

halaxy_get_appointment

Get an appointment

Fetch an appointment with its participants and statuses (HEALTH DATA) by id. GET /main/Appointment/{id}.

輸入參數id必填

halaxy_get_schedule

Get a schedule

Fetch a practitioner schedule by id. GET /main/Schedule/{id}.

輸入參數id必填

halaxy_get_slot

Get a time slot

Fetch a time slot by id. GET /main/Slot/{id}.

輸入參數id必填

halaxy_get_healthcare_service

Get an appointment type

Fetch an appointment type by id. GET /main/HealthcareService/{id}.

輸入參數id必填

halaxy_get_fee

Get a fee

Fetch a fee (ChargeItemDefinition) by id. GET /main/ChargeItemDefinition/{id}.

輸入參數id必填

halaxy_get_coverage

Get patient coverage

Fetch a patient's coverage (claim details) record by id. GET /main/Coverage/{id}.

輸入參數id必填

halaxy_get_invoice

Get an invoice

Fetch an invoice by id. GET /main/Invoice/{id}.

輸入參數id必填

halaxy_get_invoice_line

Get an invoice line

Fetch an invoice line by id. GET /main/InvoiceLine/{id}.

輸入參數id必填

halaxy_get_payment_transaction

Get a payment transaction

Fetch a payment transaction by id. GET /main/PaymentTransaction/{id}.

輸入參數id必填

halaxy_get_referral

Get a referral

Fetch a referral (HEALTH DATA) by id. GET /main/Referral/{id}.

輸入參數id必填

halaxy_get_referral_definition

Get a referral template

Fetch a referral template by id. GET /main/ReferralDefinition/{id}.

輸入參數id必填

halaxy_find_available_appointments

Find 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.

輸入參數end必填showsortstart必填duration必填emergencyorganizationpractitionerapply_buffer_timepractitioner_role

halaxy_create_patient

Create 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.

輸入參數emailgiven必填family必填gendermobileaddressbirth_datepreferred_namemanaging_organization

halaxy_create_appointment

Book 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.

輸入參數end必填start必填statuspatient_id必填practitioner_role_id必填healthcare_service_idfail_on_double_bookingcharge_item_definition_id

halaxy_update_appointment_status

Update 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}.

輸入參數status必填patient_idappointment_id必填

halaxy_create_clinical_note

Create 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.

輸入參數html必填title必填patient_id必填practitioner_role_id必填

版本歷史

12
  1. v1.12.4最新Nov 7, 2026
  2. v1.11.3Nov 5, 2026
  3. v1.11.2Nov 5, 2026
  4. v1.11.1Nov 4, 2026
  5. v1.11.0Nov 3, 2026
  6. v1.10.1Nov 3, 2026
  7. v1.9.0Nov 1, 2026
  8. v1.7.0Oct 31, 2026
  9. v1.6.0Oct 31, 2026
  10. v1.5.2Oct 30, 2026
  11. v1.5.0Oct 30, 2026
  12. v1.0.0Oct 26, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合