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