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 集成