io.usefulapi/acuity-scheduling
REMOTE · ACUITY-SCHEDULING.USEFULAPI.IO · SCANNED AUG 3
Read appointments, types, calendars and availability; create, cancel or reschedule bookings.
Available components
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 Security78
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- 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
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability81
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 1627 tokens (~90/item across 18 items; 18 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities60
- Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
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 · acuity-scheduling.usefulapi.io
claude mcp add --transport http io-usefulapi-acuity-scheduling https://acuity-scheduling.usefulapi.io/mcp
[mcp_servers.io-usefulapi-acuity-scheduling] url = "https://acuity-scheduling.usefulapi.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"io-usefulapi-acuity-scheduling": {
"type": "remote",
"url": "https://acuity-scheduling.usefulapi.io/mcp",
"enabled": true
}
}
} openclaw mcp add io-usefulapi-acuity-scheduling --url https://acuity-scheduling.usefulapi.io/mcp --transport streamable-http
mcp_servers:
io-usefulapi-acuity-scheduling:
url: "https://acuity-scheduling.usefulapi.io/mcp" {
"mcpServers": {
"io-usefulapi-acuity-scheduling": {
"type": "http",
"url": "https://acuity-scheduling.usefulapi.io/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
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.
- 2 Aug 26 +1
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.20 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Capabilities: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Endpoint reachability: not serving MCP → reachable ▲ functional
- First check of Schema quality: 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
- 28 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.
- 27 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
- 26 Jul 26 68
First indexed and scored.
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://acuity-scheduling.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 | 19 Jul 2026 | 17 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | 3ea364e336e2b9940eece69c219b0dad |
| SANs: usefulapi.io, acuity-scheduling.usefulapi.io, *.acuity-scheduling.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 acuity-scheduling.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 Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer realm="OAuth", resource_metadata="https://acuity-scheduling.usefulapi.io/.well-known/oauth-protected-resource/mcp", error="invalid_token", error_description="Missing or invalid access token"
Bearer realm="OAuth", resource_metadata="https://acuity-scheduling.usefulapi.io/.well-known/oauth-protected-resource/mcp", error="invalid_token", error_description="Missing or invalid access token"Protected resource metadata
| Document | https://acuity-scheduling.usefulapi.io/.well-known/oauth-protected-resource/mcp |
|---|---|
| Retrieved | Yes |
| Resource | https://acuity-scheduling.usefulapi.io/mcp |
| Authorisation server | https://acuity-scheduling.usefulapi.io |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://acuity-scheduling.usefulapi.io/mcp | Verified | 200 | |
| http (plaintext) | http://acuity-scheduling.usefulapi.io/mcp | Inconclusive | 401 |
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.
acuity_availability_classes Get available classes ~115
List group class time slots (for class-type appointment types) in a month. Acuity REST: GET /availability/classes.
| Name | Type | Req | Description |
|---|---|---|---|
| appointmentTypeID | integer | yes | Class appointment type id (required). |
| includeUnavailable | boolean | — | If true, also include full/unavailable class times. |
| month | string | yes | Month to check, formatted YYYY-MM, e.g. '2026-08'. |
| timezone | string | — | IANA timezone for the returned times, e.g. 'America/New_York'. |
No output schema declared.
No examples provided.
acuity_availability_dates Get available dates ~113
List dates in a month that have availability for an appointment type. Acuity REST: GET /availability/dates.
| Name | Type | Req | Description |
|---|---|---|---|
| appointmentTypeID | integer | yes | Appointment type id to check availability for (required). |
| calendarID | integer | — | Restrict to a specific calendar id. |
| month | string | yes | Month to check, formatted YYYY-MM, e.g. '2026-08'. |
| timezone | string | — | IANA timezone for the returned dates, e.g. 'America/New_York'. |
No output schema declared.
No examples provided.
acuity_availability_times Get available times ~116
List available time slots on a given date for an appointment type. Acuity REST: GET /availability/times.
| Name | Type | Req | Description |
|---|---|---|---|
| appointmentTypeID | integer | yes | Appointment type id to check availability for (required). |
| calendarID | integer | — | Restrict to a specific calendar id. |
| date | string | yes | Date to check, formatted YYYY-MM-DD, e.g. '2026-08-15'. |
| timezone | string | — | IANA timezone for the returned times, e.g. 'America/New_York'. |
No output schema declared.
No examples provided.
acuity_cancel_appointment Cancel appointment ~105
CANCELS an existing appointment. This MODIFIES the calendar and, unless suppressed, may send cancellation emails. Acuity REST: PUT /appointments/{id}/cancel.
| Name | Type | Req | Description |
|---|---|---|---|
| admin | boolean | — | If true, cancel as admin (bypasses client cancellation restrictions). |
| cancelNote | string | — | Optional note explaining the cancellation. |
| id | integer | yes | Appointment id to cancel (required). |
| noEmail | boolean | — | If true, suppress cancellation emails. |
No output schema declared.
No examples provided.
acuity_create_appointment Create appointment ~265
CREATES a new appointment (books a client into a time slot). This MODIFIES the calendar and, unless suppressed, may send confirmation emails. Acuity REST: POST /appointments.
| Name | Type | Req | Description |
|---|---|---|---|
| admin | boolean | — | If true, book as admin — bypasses availability checks and required-form enforcement. Default false. |
| appointmentTypeID | integer | yes | Appointment type id to book (required). |
| calendarID | integer | — | Calendar id to book on (defaults to an available one). |
| datetime | string | yes | Start time in ISO 8601 with offset, e.g. '2026-08-15T14:00:00-0400' (required). |
| string | yes | Client email (required). | |
| fields | array | — | Intake form field answers, each { id, value }. |
| firstName | string | yes | Client first name (required). |
| lastName | string | yes | Client last name (required). |
| noEmail | boolean | — | If true, suppress client/owner confirmation emails. |
| notes | string | — | Notes to attach to the appointment. |
| phone | string | — | Client phone number. |
| timezone | string | — | IANA timezone for the datetime, e.g. 'America/New_York'. |
No output schema declared.
No examples provided.
acuity_create_client Create client ~95
CREATES a new client record in the account's client list. This ADDS data to the account. Acuity REST: POST /clients.
| Name | Type | Req | Description |
|---|---|---|---|
| string | — | Client email. | |
| firstName | string | yes | Client first name (required). |
| lastName | string | yes | Client last name (required). |
| notes | string | — | Notes about the client. |
| phone | string | — | Client phone number. |
No output schema declared.
No examples provided.
acuity_get_appointment Get appointment ~38
Get a single appointment by its id. Acuity REST: GET /appointments/{id}.
| Name | Type | Req | Description |
|---|---|---|---|
| id | integer | yes | Appointment id. |
No output schema declared.
No examples provided.
acuity_get_me Get account info ~37
Get the authenticated Acuity account's profile (name, email, timezone, plan, currency). Acuity REST: GET /me.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
acuity_list_appointment_types List appointment types ~57
List the account's appointment types (services and classes), including price, duration and calendars. Acuity REST: GET /appointment-types.
| Name | Type | Req | Description |
|---|---|---|---|
| includeDeleted | boolean | — | If true, also include deleted/inactive appointment types. |
No output schema declared.
No examples provided.
acuity_list_appointments List appointments ~186
List appointments scheduled on the account, with optional filters. Acuity REST: GET /appointments.
| Name | Type | Req | Description |
|---|---|---|---|
| appointmentTypeID | integer | — | Filter to a specific appointment type id. |
| calendarID | integer | — | Filter to a specific calendar id. |
| canceled | boolean | — | If true, return canceled appointments (default false). |
| direction | string | — | Sort order by datetime. ASC (default) or DESC. |
| string | — | Filter by client email. | |
| firstName | string | — | Filter by client first name. |
| lastName | string | — | Filter by client last name. |
| max | integer | — | Max appointments to return. |
| maxDate | string | — | Only appointments on/before this date (YYYY-MM-DD or ISO datetime). |
| minDate | string | — | Only appointments on/after this date (YYYY-MM-DD or ISO datetime). |
No output schema declared.
No examples provided.
acuity_list_blocks List blocked-off times ~102
List blocked-off (unavailable) time ranges on the account's calendars. Acuity REST: GET /blocks.
| Name | Type | Req | Description |
|---|---|---|---|
| calendarID | integer | — | Filter to a specific calendar id. |
| max | integer | — | Max blocks to return. |
| maxDate | string | — | Only blocks on/before this date (YYYY-MM-DD or ISO datetime). |
| minDate | string | — | Only blocks on/after this date (YYYY-MM-DD or ISO datetime). |
No output schema declared.
No examples provided.
acuity_list_calendars List calendars ~36
List the account's calendars (staff/resources appointments can be booked on). Acuity REST: GET /calendars.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
acuity_list_clients List clients ~55
List clients on the account, optionally filtered by a search string (name/email/phone). Acuity REST: GET /clients.
| Name | Type | Req | Description |
|---|---|---|---|
| search | string | — | Optional search string to match client name, email, or phone. |
No output schema declared.
No examples provided.
acuity_list_forms List intake forms ~29
List the account's custom intake forms and their fields. Acuity REST: GET /forms.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
acuity_list_labels List labels ~31
List the appointment labels (colored tags) defined on the account. Acuity REST: GET /labels.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
acuity_list_orders List orders ~54
List store orders (product / package / gift-certificate purchases). Acuity REST: GET /orders.
| Name | Type | Req | Description |
|---|---|---|---|
| string | — | Filter orders by buyer email. | |
| max | integer | — | Max orders to return. |
No output schema declared.
No examples provided.
acuity_list_products List products ~31
List the account's products / packages / gift certificates for sale. Acuity REST: GET /products.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
acuity_reschedule_appointment Reschedule appointment ~162
RESCHEDULES an existing appointment to a new time (and optionally a new calendar). This MODIFIES the calendar and, unless suppressed, may send update emails. Acuity REST: PUT /appointments/{id}/reschedule.
| Name | Type | Req | Description |
|---|---|---|---|
| admin | boolean | — | If true, reschedule as admin (bypasses availability checks). |
| calendarID | integer | — | Move the appointment to this calendar id. |
| datetime | string | yes | New start time in ISO 8601 with offset, e.g. '2026-08-16T10:00:00-0400' (required). |
| id | integer | yes | Appointment id to reschedule (required). |
| noEmail | boolean | — | If true, suppress reschedule emails. |
No output schema declared.
No examples provided.