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.
Takes no parameters.
io.usefulapiPublished by usefulapi.ioOfficial publisherv1.12.4Updated Nov 7, 2026
Read Semble patients, bookings, invoices and products; create patients and tasks, label patients.
The publisher's own server: Ably MCP by usefulapi
Connects an assistant to a Semble clinic practice: read patients, bookings, invoices and staff, and create patients, tasks and labels.
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%2Fsemble/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": {
"semble-by-usefulapi": {
"type": "http",
"url": "https://semble.usefulapi.io/mcp"
}
}
}Live endpoint: https://semble.usefulapi.io/mcp
https://semble.usefulapi.io/mcp.claude mcp add --transport http semble https://semble.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 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.
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 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].
MIT
Source: servers/semble/README.md at commit 4046075
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.
Takes no parameters.
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_sizeGet 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.
idrequiredList 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).
endrequiredpagestartrequiredpage_sizepatient_idrequiredonly_cancelledinclude_deletedList 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_deletedGet a booking
One booking by id, with patient, doctor, location, appointment type, status and journey.
idrequiredList 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_deletedGet a user (staff)
One staff user by id.
idrequiredList 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_sizeGet a product or service
One product, service or appointment type by id.
idrequiredList 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_outstandingGet an invoice
One invoice by id, with its line items, totals and what is outstanding.
idrequiredList contacts
Contacts of the practice (referring doctors, insurers and other payors). `search` matches name, email, phone, specialty and numbers.
pagesearchis_payoris_doctorpage_sizeList tasks
Practice tasks, filtered by patient, status, priority, type or assignee. Returns subject, due date, priority, assignee and patient.
pagestatusprioritypage_sizetask_typepatient_idassigned_toList patient labels
The labels that can be put on patients (id, title, colour). Use the id with semble_add_patient_label.
pagesearchpage_sizeCreate 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.
subjectrequiredcommentsdue_dateprioritytask_typepatient_idassigned_torequiredUpdate 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.
idrequiredstatussubjectcommentsdue_datepriorityassigned_toAdd 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_idrequiredpatient_idrequiredCreate 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_namerequiredfirst_namerequiredphone_typephone_number100% 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": { "semble": { "url": "https://semble.usefulapi.io/mcp" } }}