# Semble MCP by usefulapi (remote · semble.usefulapi.io)

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

- Trust score: 18/100 (low)
- Change this week: −46
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `semble.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-semble/semble.md), [page](https://verifymcp.io/servers/io-usefulapi-semble/semble)

## Channel facts

- Endpoint: `https://semble.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.11.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the Semble MCP by usefulapi server?

Semble MCP by usefulapi is a hosted endpoint at https://semble.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-semble 'https://semble.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-semble": {
      "url": "https://semble.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-semble": {
      "type": "http",
      "url": "https://semble.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-semble]
url = "https://semble.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-semble": {
      "type": "remote",
      "url": "https://semble.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-semble --url 'https://semble.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-semble:
    url: "https://semble.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-semble": {
      "Transport": "http",
      "Url": "https://semble.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-semble -t streamable-http -u 'https://semble.usefulapi.io/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-02 (score 18, −50)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.20 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-10-31 (score 68, +4)

- [security improvement] Authorization: partial → pass
- [functional improvement] MCP protocol: fail → pass
- [functional] New prompt “check_the_price_list”
- [functional] New prompt “find_referrers_and_payors”
- [functional] New prompt “keep_admin_tasks_moving”
- [functional] New prompt “look_up_staff_and_clinicians”
- [functional] New prompt “review_the_practice_setup”
- [functional] MCP protocol version: 2025-06-18 → 2025-11-25
- [functional] Server version: 1.7.0 → 1.9.0
- [functional] Server version: 1.6.0 → 1.7.0
- [functional] Server version: 1.5.2 → 1.6.0

### 2026-10-30 (score 64, 0)

- [functional] Server version: 1.5.1 → 1.5.2
- [functional] Server version: 1.5.0 → 1.5.1

### 2026-10-29 (score 64, 0)

- [functional] Server version: 1.4.0 → 1.5.0
- [functional] Server version: 1.3.0 → 1.4.0

### 2026-10-28 (score 64, +1)

- [functional] Server version: 1.1.0 → 1.3.0

### 2026-10-27 (score 63, 0)

- [functional improvement] Stability: unverified → 0.03
- [functional] Server version: 1.0.0 → 1.1.0

### 2026-10-26 (score 63)

First indexed and scored.

## MCP tools (19)

### `semble_get_practice` (~39 tokens)

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` (~115 tokens)

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.

Input parameters:

- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `search` (string): Free-text search (name, email, phone, date of birth).

### `semble_get_patient` (~60 tokens)

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.

Input parameters:

- `id` (string, required): Patient id (from semble_list_patients).

### `semble_list_patient_bookings` (~176 tokens)

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

Input parameters:

- `end` (string, required): Last day, YYYY-MM-DD (until 23:59 UTC, inclusive).
- `include_deleted` (boolean): Also return cancelled (deleted) bookings next to the active ones (default false).
- `only_cancelled` (boolean): Return ONLY cancelled (deleted) bookings. Takes precedence over include_deleted.
- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `patient_id` (string, required): Patient id.
- `start` (string, required): First day, YYYY-MM-DD (from 00:00 UTC).

### `semble_list_bookings` (~154 tokens)

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

Input parameters:

- `end` (string): Last day, YYYY-MM-DD (until 23:59 UTC, inclusive).
- `include_deleted` (boolean): Also return deleted bookings (default false).
- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `start` (string): First day, YYYY-MM-DD (from 00:00 UTC).

### `semble_get_booking` (~37 tokens)

Get a booking

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

Input parameters:

- `id` (string, required): Booking id.

### `semble_list_users` (~110 tokens)

List users (staff)

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

Input parameters:

- `clinicians_only` (boolean): Only clinicians.
- `include_deleted` (boolean): Also return deleted users (default false).
- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `search` (string): Free-text search.

### `semble_get_user` (~24 tokens)

Get a user (staff)

One staff user by id.

Input parameters:

- `id` (string, required): User id.

### `semble_list_products` (~91 tokens)

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.

Input parameters:

- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `search` (string): Item code or name.

### `semble_get_product` (~28 tokens)

Get a product or service

One product, service or appointment type by id.

Input parameters:

- `id` (string, required): Product id.

### `semble_list_invoices` (~140 tokens)

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.

Input parameters:

- `end` (string): Last invoice date, YYYY-MM-DD.
- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `paid_or_outstanding` (string): Filter by payment state.
- `start` (string): First invoice date, YYYY-MM-DD.
- `status` (string): Invoice status.

### `semble_get_invoice` (~34 tokens)

Get an invoice

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

Input parameters:

- `id` (string, required): Invoice id.

### `semble_list_contacts` (~108 tokens)

List contacts

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

Input parameters:

- `is_doctor` (boolean): Only doctors.
- `is_payor` (boolean): Only payors.
- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `search` (string): Free-text search.

### `semble_list_tasks` (~132 tokens)

List tasks

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

Input parameters:

- `assigned_to` (string): Only tasks assigned to this user id.
- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `patient_id` (string): Only tasks about this patient id.
- `priority` (string): Task priority.
- `status` (string): Task status.
- `task_type` (string): Task type.

### `semble_list_labels` (~79 tokens)

List patient labels

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

Input parameters:

- `page` (integer): Page number, from 1 (default 1).
- `page_size` (integer): Rows per page, 1-100 (default 25).
- `search` (string): Label title.

### `semble_create_task` (~131 tokens)

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.

Input parameters:

- `assigned_to` (string, required): User id the task is assigned to.
- `comments` (string): Extra notes.
- `due_date` (string): Due date, YYYY-MM-DD.
- `patient_id` (string): Patient the task is about.
- `priority` (string): Priority.
- `subject` (string, required): The task text.
- `task_type` (string): Task type.

### `semble_update_task` (~127 tokens)

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.

Input parameters:

- `assigned_to` (string): New assignee user id.
- `comments` (string): New notes (replace the old).
- `due_date` (string): New due date, YYYY-MM-DD.
- `id` (string, required): Task id (from semble_list_tasks).
- `priority` (string): New priority.
- `status` (string): New status.
- `subject` (string): New subject.

### `semble_add_patient_label` (~58 tokens)

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.

Input parameters:

- `label_id` (string, required): Label id (from semble_list_labels).
- `patient_id` (string, required): Patient id.

### `semble_create_patient` (~167 tokens)

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.

Input parameters:

- `address` (string): Street address.
- `city` (string): City.
- `comments` (string): Notes.
- `country` (string): Country.
- `dob` (string): Date of birth, YYYY-MM-DD.
- `email` (string): Email address.
- `first_name` (string, required): First name.
- `last_name` (string, required): Last name.
- `phone_number` (string): Phone number.
- `phone_type` (string): Phone type, for example Mobile.
- `postcode` (string): Postcode.
- `sex` (string): Sex as the practice records it.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-semble/semble#diagnostics

## Score history

- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 68
- 2026-10-31: 68
- 2026-10-30: 64
- 2026-10-29: 64
- 2026-10-28: 64
- 2026-10-27: 63
- 2026-10-26: 63

## Common questions

### What is the Semble MCP by usefulapi server?

Semble MCP by usefulapi is listed in the public MCP registry as io.usefulapi/semble. Read Semble patients, bookings, invoices and products; create patients and tasks, label patients. This page covers its hosted endpoint (https://semble.usefulapi.io/mcp).

### Is the Semble MCP by usefulapi server safe to use?

Semble MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Semble MCP by usefulapi server expose?

Semble MCP by usefulapi exposes 19 tools: semble_get_practice, semble_list_patients, semble_get_patient, semble_list_patient_bookings, semble_list_bookings, and 14 more. Their descriptions and schemas cost roughly 1,810 tokens of context every time the server is loaded.

### Does the Semble MCP by usefulapi server require authentication?

Its publisher declares no required credentials for Semble MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.

### Is the Semble MCP by usefulapi server still maintained?

Semble MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://semble.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/semble/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-semble/semble.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-semble/semble.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-semble/semble