Semble MCP by usefulapi

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

Read Semble patients, bookings, invoices and products; create patients and tasks, label patients.

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

已驗證Streamable HTTP可網頁執行效率與工作流金融商業與電商

概覽

AI 產生的概覽

將助理連接到 Semble 診所管理系統:讀取病患、預約、發票與員工資料,並可建立病患、任務與標籤。

可以做什麼
  • 查詢診所資訊、員工使用者、聯絡人與價目表(服務項目、預約類型與庫存品項)
  • 搜尋並讀取病患資料,包含基本資料、聯絡方式、標籤與狀態
  • 依整個診所或單一病患列出並讀取預約,含醫師、地點、類型與看診流程狀態
  • 依日期與狀態篩選並讀取發票,含總額、明細與未結金額
  • 列出任務,並建立或更新任務(狀態、負責人、到期日、優先順序、備註)
  • 列出病患標籤,並為病患加上既有標籤
適用情境
適合診所或機構人員以自然語言查詢 Semble 資料,例如明天的預約、某位病患近期的預約或未結發票,或請助理建立任務、為病患加上標籤。
執行需求
透過 streamable HTTP 存取的遠端端點,不需在本機安裝套件。以 OAuth 登入,首次連線時需貼上 Semble API 權杖並選擇 Production 或 Sandbox。用戶端設定不需 API 金鑰或 Authorization 標頭。需要 usefulapi.io 帳號與方案(免費方案每月 50 次工具呼叫)。
安裝前請注意
涉及病患個人與健康資料,應僅限獲授權人員使用。有四個寫入工具(建立病患、建立任務、更新任務、新增病患標籤);建立病患不會檢查是否重複,應先搜尋。用量按次計費,付費方案透過 Stripe 結帳連結付款;取消後服務持續到已付費期間結束,當期不退費。API 權杖依使用者儲存在此託管服務上。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

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

README

Semble MCP by usefulapi

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://semble.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http semble https://semble.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": {    "semble": {      "url": "https://semble.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 Semble credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/semble/

On first connect you will paste your Semble API token and choose Production or Sandbox. They are validated, stored per-user, and scoped to you. No keys in config files.

Tools

ToolTypeWhat it does
semble_get_practicereadGet the practice
semble_list_patientsreadList or search patients
semble_get_patientreadGet a patient
semble_list_patient_bookingsreadList a patient's bookings
semble_list_bookingsreadList bookings
semble_get_bookingreadGet a booking
semble_list_usersreadList users (staff)
semble_get_userreadGet a user (staff)
semble_list_productsreadList products and services
semble_get_productreadGet a product or service
semble_list_invoicesreadList invoices
semble_get_invoicereadGet an invoice
semble_list_contactsreadList contacts
semble_list_tasksreadList tasks
semble_list_labelsreadList patient labels
semble_create_taskwriteCreate a task (WRITE)
semble_update_taskwriteUpdate a task (WRITE)
semble_add_patient_labelwriteAdd a label to a patient (WRITE)
semble_create_patientwriteCreate a patient (WRITE)
semble_usage_statusmetaUsage status (free-tier meter)
semble_request_featuremetaRequest a missing feature
semble_upgrademetaUpgrade to Pro or Pro+
semble_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 semble_upgrade (it returns a Stripe Checkout link). Cancel any time with semble_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running semble_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

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

工具

19

semble_get_practice

Get the practice

The practice the API token belongs to: name, timezone, locations, appointment types and medical specialties. A good first call to check the connection.

無需輸入參數。

semble_list_patients

List or search patients

Patients of the practice (personal and health data). `search` matches name, email, phone or date of birth. Returns id, name, date of birth, contact details and status, plus pageInfo.hasMore for the next page.

輸入參數pagesearchpage_size

semble_get_patient

Get a patient

One patient by id (personal data): demographics, phones, address, numbers, custom attributes, labels, comments and status. Appointments, invoices and tasks have their own tools.

輸入參數id必填

semble_list_patient_bookings

List a patient's bookings

The bookings (appointments) of one patient between two dates, with doctor, location, appointment type and status. Both dates are required (YYYY-MM-DD).

輸入參數end必填pagestart必填page_sizepatient_id必填only_cancelledinclude_deleted

semble_list_bookings

List bookings

Bookings (appointments) of the whole practice. With a date range, a booking is included if it starts or ends inside it. Returns patient, doctor, location, appointment type, status and journey (arrived, consultation, departed, dna).

輸入參數endpagestartpage_sizeinclude_deleted

semble_get_booking

Get a booking

One booking by id, with patient, doctor, location, appointment type, status and journey.

輸入參數id必填

semble_list_users

List users (staff)

Staff users of the practice (clinicians and admin): name, email, role, qualifications and specialties. Use the ids for bookings and tasks.

輸入參數pagesearchpage_sizeclinicians_onlyinclude_deleted

semble_get_user

Get a user (staff)

One staff user by id.

輸入參數id必填

semble_list_products

List products and services

The practice's price list: appointment types, services and stock items, with price, cost, duration and stock level. `search` matches the item code or name.

輸入參數pagesearchpage_size

semble_get_product

Get a product or service

One product, service or appointment type by id.

輸入參數id必填

semble_list_invoices

List invoices

Invoices whose invoice date is inside a date range, with patient, totals and what is outstanding. Filter by status (active or cancelled) and paid_or_outstanding. Monetary amounts are in the practice currency.

輸入參數endpagestartstatuspage_sizepaid_or_outstanding

semble_get_invoice

Get an invoice

One invoice by id, with its line items, totals and what is outstanding.

輸入參數id必填

semble_list_contacts

List contacts

Contacts of the practice (referring doctors, insurers and other payors). `search` matches name, email, phone, specialty and numbers.

輸入參數pagesearchis_payoris_doctorpage_size

semble_list_tasks

List tasks

Practice tasks, filtered by patient, status, priority, type or assignee. Returns subject, due date, priority, assignee and patient.

輸入參數pagestatusprioritypage_sizetask_typepatient_idassigned_to

semble_list_labels

List patient labels

The labels that can be put on patients (id, title, colour). Use the id with semble_add_patient_label.

輸入參數pagesearchpage_size

semble_create_task

Create a task (WRITE)

Creates a task in Semble assigned to a staff user (get ids from semble_list_users), optionally about a patient, with a due date, priority and type. Creates a new record each time it is called.

輸入參數subject必填commentsdue_dateprioritytask_typepatient_idassigned_to必填

semble_update_task

Update a task (WRITE)

Changes a task: close or reopen it (status), reassign it, move the due date, or edit subject, priority and notes. Only the fields you pass are changed.

輸入參數id必填statussubjectcommentsdue_datepriorityassigned_to

semble_add_patient_label

Add a label to a patient (WRITE)

Puts an existing label on a patient (label ids from semble_list_labels). Adds only; nothing is removed.

輸入參數label_id必填patient_id必填

semble_create_patient

Create a patient (WRITE)

Creates a new patient record (personal data) from the details you give. It does not check for an existing patient: search with semble_list_patients first to avoid a duplicate.

輸入參數dobsexcityemailaddresscountrycommentspostcodelast_name必填first_name必填phone_typephone_number

版本歷史

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 整合