io.usefulapi/cliniko

REMOTE · CLINIKO.USEFULAPI.IO · SCANNED AUG 3

Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.

Available components

−51 this week 18 18 Trust /100

Trust breakdown (6 categories)

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. How we score →

Endpoint Security46

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes. View diagnostics → Unverified
HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail

Transport & Reachability0

Transport check failed: declared streamable-http, but the endpoint returned HTTP 429. See how to fix → View diagnostics → Fail

Schema Quality & AI Usability0

Schema not yet verified: we couldn't read the endpoint's schema.Unverified

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage0

Tool coverage not yet verified: we couldn't read the endpoint's tools.Unverified

Capabilities0

Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified

Unverified: 4 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

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · cliniko.usefulapi.io

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add --transport http io-usefulapi-cliniko https://cliniko.usefulapi.io/mcp

# ~/.codex/config.toml

[mcp_servers.io-usefulapi-cliniko]
url = "https://cliniko.usefulapi.io/mcp"

// opencode.json

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

# add to OpenClaw

openclaw mcp add io-usefulapi-cliniko --url https://cliniko.usefulapi.io/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  io-usefulapi-cliniko:
    url: "https://cliniko.usefulapi.io/mcp"

// mcp.json

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

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 −54
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.20 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Transport: pass → fail ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: fail → unverified ▼ functional
2 Aug 26 +54
- Authorization: unverified → pass ▲ security
- Transport: fail → pass ▲ security
- MCP protocol: unverified → fail ▼ functional
- Endpoint reachability: not serving MCP → reachable ▲ functional
- Stability: unverified → 0.20 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
1 Aug 26 −53
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.13 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Transport: pass → fail ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: fail → unverified ▼ functional
31 Jul 26 +3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
28 Jul 26 0
- Stability: unverified → 0.03 ▲ functional
27 Jul 26 +57
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://cliniko.usefulapi.io/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=usefulapi.io	CN=WE1,O=Google Trust Services,C=US	17 Jul 2026	15 Oct 2026	ECDSA 256	ECDSA-SHA256	c241ce5ed3ef63ef0ecf91a748b62418
SANs: usefulapi.io, cliniko.usefulapi.io, *.cliniko.usefulapi.io
CN=WE1,O=Google Trust Services,C=US (CA)	CN=GTS Root R4,O=Google Trust Services LLC,C=US	13 Dec 2023	20 Feb 2029	ECDSA 256	ECDSA-SHA384	7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA)	CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE	15 Nov 2023	28 Jan 2028	ECDSA 384	SHA256-RSA	7fe530bf331343bedd821610493d8a1b

DNSSEC insecure

Validation of cliniko.usefulapi.io. — Not signed

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
io.	present	57355	8	Verified
usefulapi.io.	absent			Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	429

Header	Value
x-frame-options	SAMEORIGIN
referrer-policy	same-origin

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://cliniko.usefulapi.io/mcp	HTTP error	429
http (plaintext)	http://cliniko.usefulapi.io/mcp	Inconclusive	429

MCP tools — 17 exposed · ~1,600 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

cliniko_create_appointment Create an appointment ~173

WRITE — books a REAL new individual appointment in the live Cliniko practice. Requires patient_id, practitioner_id, business_id, appointment_type_id, and starts_at (ISO 8601). ends_at defaults from the appointment type if omitted. POST /individual_appointments.

Input Output Examples

Name	Type	Req	Description
appointment_type_id	—	yes	Appointment type id (required).
business_id	—	yes	Business id (required).
ends_at	string	—	End time, ISO 8601. Defaults from the appointment type if omitted.
notes	string	—	Appointment notes.
patient_id	—	yes	Patient id (required).
practitioner_id	—	yes	Practitioner id (required).
starts_at	string	yes	Start time, ISO 8601 e.g. 2026-07-20T09:00:00Z (required).

No output schema declared.

No examples provided.

cliniko_create_patient Create a patient ~174

WRITE — creates a REAL new patient record in the live Cliniko practice. Requires first_name + last_name. POST /patients.

Input Output Examples

Name	Type	Req	Description
address_1	string	—	Street address line 1.
city	string	—	City.
country_code	string	—	ISO country code, e.g. AU.
date_of_birth	string	—	Date of birth yyyy-mm-dd.
email	string	—	Email address.
first_name	string	yes	Patient first name (required).
last_name	string	yes	Patient last name (required).
notes	string	—	Free-text notes.
phone_number	string	—	A phone number (stored as a Mobile phone number).
post_code	string	—	Post / ZIP code.
state	string	—	State / region.

No output schema declared.

No examples provided.

cliniko_get_account Get account details ~43

Get the Cliniko account and subscription details for the authenticated API key. A good first call to sanity-check auth, shard, and User-Agent. GET /account.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

cliniko_get_appointment Get an appointment ~35

Fetch a single individual appointment by id. GET /individual_appointments/{id}.

Input Output Examples

Name	Type	Req	Description
id	—	yes	Individual appointment id.

No output schema declared.

No examples provided.

cliniko_get_invoice Get an invoice ~31

Fetch a single invoice by id. GET /invoices/{id}.

Input Output Examples

Name	Type	Req	Description
id	—	yes	Invoice id.

No output schema declared.

No examples provided.

cliniko_get_patient Get a patient ~30

Fetch a single patient by id. GET /patients/{id}.

Input Output Examples

Name	Type	Req	Description
id	—	yes	Patient id.

No output schema declared.

No examples provided.

cliniko_get_treatment_note Get a treatment note ~51

Fetch a single treatment note by id. NOTE: treatment notes are protected health information (PHI). Read-only. GET /treatment_notes/{id}.

Input Output Examples

Name	Type	Req	Description
id	—	yes	Treatment note id.

No output schema declared.

No examples provided.

cliniko_list_appointment_types List appointment types ~59

List appointment types (service definitions). GET /appointment_types.

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number (1-based). Default 1.
per_page	integer	—	Results per page (max 100). Default 50.

No output schema declared.

No examples provided.

cliniko_list_appointments List appointments ~213

List individual appointments, optionally filtered by patient/practitioner/business/type and a starts_at date-time window (starts_from / starts_to, ISO 8601). GET /individual_appointments.

Input Output Examples

Name	Type	Req	Description
appointment_type_id	—	—	Filter by appointment type id.
business_id	—	—	Filter by business id.
order	string	—	Sort direction. asc \| desc.
page	integer	—	Page number (1-based). Default 1.
patient_id	—	—	Filter by patient id (q[]=patient_id:=).
per_page	integer	—	Results per page (max 100). Default 50.
practitioner_id	—	—	Filter by practitioner id.
sort	string	—	Field to sort by, e.g. created_at.
starts_from	string	—	Only appointments starting at/after this ISO 8601 time (q[]=starts_at:>).
starts_to	string	—	Only appointments starting before this ISO 8601 time (q[]=starts_at:<).

No output schema declared.

No examples provided.

cliniko_list_available_times List available times ~156

List bookable appointment slots for a business + practitioner + appointment type within a date range (from/to, yyyy-mm-dd, span <= 7 days). High-value booking-slot lookup. GET /businesses/{business_id}/practitioners/{practitioner_id}/appointment_types/{appointment_type_id}/available_times.

Input Output Examples

Name	Type	Req	Description
appointment_type_id	—	yes	Appointment type id (path).
business_id	—	yes	Business id (path).
from	string	yes	Range start yyyy-mm-dd (cannot be more than 7 days before `to`).
practitioner_id	—	yes	Practitioner id (path).
to	string	yes	Range end yyyy-mm-dd (cannot be more than 7 days after `from`).

No output schema declared.

No examples provided.

cliniko_list_businesses List businesses ~61

List businesses (practice locations) in the account. GET /businesses.

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number (1-based). Default 1.
per_page	integer	—	Results per page (max 100). Default 50.

No output schema declared.

No examples provided.

cliniko_list_invoices List invoices ~105

List invoices, optionally filtered by patient. GET /invoices.

Input Output Examples

Name	Type	Req	Description
order	string	—	Sort direction. asc \| desc.
page	integer	—	Page number (1-based). Default 1.
patient_id	—	—	Filter by patient id (q[]=patient_id:=).
per_page	integer	—	Results per page (max 100). Default 50.
sort	string	—	Field to sort by, e.g. created_at.

No output schema declared.

No examples provided.

cliniko_list_patients List patients ~145

Search/list patients. Name/email filters use Cliniko 'contains' matching (q[]=field:~value). GET /patients.

Input Output Examples

Name	Type	Req	Description
email	string	—	Filter by email (contains match).
first_name	string	—	Filter by first name (contains match).
last_name	string	—	Filter by last name (contains match).
order	string	—	Sort direction. asc \| desc.
page	integer	—	Page number (1-based). Default 1.
per_page	integer	—	Results per page (max 100). Default 50.
sort	string	—	Field to sort by, e.g. created_at.

No output schema declared.

No examples provided.

cliniko_list_practitioners List practitioners ~61

List practitioners in the account. GET /practitioners.

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number (1-based). Default 1.
per_page	integer	—	Results per page (max 100). Default 50.

No output schema declared.

No examples provided.

cliniko_list_products List products ~55

List billable products/items. GET /products.

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number (1-based). Default 1.
per_page	integer	—	Results per page (max 100). Default 50.

No output schema declared.

No examples provided.

cliniko_list_treatment_notes List treatment notes ~98

List treatment notes, optionally filtered by patient. NOTE: treatment notes are protected health information (PHI) — handle with care. Read-only. GET /treatment_notes.

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number (1-based). Default 1.
patient_id	—	—	Filter by patient id (q[]=patient_id:=).
per_page	integer	—	Results per page (max 100). Default 50.

No output schema declared.

No examples provided.

cliniko_next_available_time Next available time ~110

Get the single next bookable slot for a business + practitioner + appointment type (optionally from a date). GET /businesses/{business_id}/practitioners/{practitioner_id}/appointment_types/{appointment_type_id}/next_available_time.

Input Output Examples

Name	Type	Req	Description
appointment_type_id	—	yes	Appointment type id (path).
business_id	—	yes	Business id (path).
from	string	—	Optional earliest date yyyy-mm-dd to search from.
practitioner_id	—	yes	Practitioner id (path).

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	12
27 Jul	69
28 Jul	69
29 Jul	70
30 Jul	68
31 Jul	71
1 Aug	18
2 Aug	72
3 Aug	18