# Bookafy MCP by usefulapi (remote · bookafy.usefulapi.io)

Review appointments, customers and staff, and manage Bookafy bookings.

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

## Components

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

## Channel facts

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

## 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 Bookafy MCP by usefulapi server?

Bookafy MCP by usefulapi is a hosted endpoint at https://bookafy.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-bookafy 'https://bookafy.usefulapi.io/mcp'
```

### Cursor

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

### VS Code

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

### Codex

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

### opencode

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

### OpenClaw

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

### Hermes

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

### Netclaw

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

### Vellum

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

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-bookafy": {
      "type": "http",
      "url": "https://bookafy.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, −48)

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

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

- [security improvement] Authorization: partial → pass
- [functional improvement] Stability: unverified → 0.03
- [functional improvement] MCP protocol: fail → pass
- [functional] New prompt “find_a_customer_record”
- [functional] New prompt “reschedule_an_appointment”
- [functional] New prompt “review_a_staff_calendar”
- [functional] New prompt “share_a_self_booking_link”
- [functional] MCP protocol version: 2025-06-18 → 2025-11-25
- [functional] Server version: 1.2.0 → 1.4.0
- [functional] Server version: 1.1.0 → 1.2.0
- [functional] Server version: 1.0.2 → 1.1.0

### 2026-10-30 (score 62)

First indexed and scored.

## MCP tools (15)

### `bookafy_get_account` (~41 tokens)

Get account

The account this API key belongs to: the admin user's email. Use it to confirm which Bookafy account is connected. GET /api/v3/me.

### `bookafy_list_appointments` (~222 tokens)

List appointments

List the appointments of ONE staff member (identified by their email: take it from bookafy_list_staff), newest first, optionally within a UTC date range. Each item has the service, customer, start/end time (UTC), title, price, duration and status. Page with page/per_page (default 25). Cancel/reschedule tokens are never returned. GET /api/v3/appointments.

Input parameters:

- `from` (string): Only appointments starting at or after this moment: yyyy-mm-dd (midnight UTC) or ISO 8601 date-time with timezone.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).
- `staff_email` (string, required): Email of the staff user whose appointments to list (from bookafy_list_staff).
- `to` (string): Only appointments ending before this moment: yyyy-mm-dd (midnight UTC) or ISO 8601 date-time with timezone.

### `bookafy_create_appointment` (~326 tokens)

Create appointment

WRITE: book an appointment for a customer with a staff member and service (ids from bookafy_list_staff and bookafy_list_services). The customer is created from the given name/email/phone. Bookafy may email the booking confirmation to the customer and add the event to connected calendars, so only call it when the user clearly asked to book. Times are converted to UTC. POST /api/v3/appointments.

Input parameters:

- `custom_fields` (object): Custom booking-form answers as {field_name: value}, with underscores for spaces, e.g. {"What_is_your_DOB": "1990"}.
- `customer_email` (string): Customer's email (the confirmation goes there).
- `customer_name` (string, required): Customer's full name.
- `customer_phone` (string): Customer's phone number.
- `description` (string): Notes shown with the appointment.
- `end` (string, required): End, ISO 8601 date-time with timezone (after start, at most 24 h later).
- `price` (number): Price of the appointment (default: the service's price).
- `service_id` (integer, required): Service id assigned to that staff user (from bookafy_list_services).
- `staff_user_id` (integer, required): Staff user id (from bookafy_list_staff).
- `start` (string, required): Start, ISO 8601 date-time with timezone, e.g. 2026-11-02T09:30:00-05:00.
- `title` (string): Title shown for the appointment (default: Bookafy's own).

### `bookafy_update_appointment` (~272 tokens)

Update appointment

WRITE: reschedule or edit an existing appointment. Send the required staff, service, new times and customer name — read current values with bookafy_list_appointments first. Omitted optional fields are not sent. The customer may be notified of the change. Times are converted to UTC. PUT /api/v3/appointments/{id}.

Input parameters:

- `appointment_id` (integer, required): Appointment id (from bookafy_list_appointments).
- `custom_fields` (object): Custom booking-form answers as {field_name: value}, with underscores for spaces, e.g. {"What_is_your_DOB": "1990"}.
- `customer_email` (string): Customer's email.
- `customer_name` (string, required): Customer's full name.
- `customer_phone` (string): Customer's phone number.
- `description` (string): Notes shown with the appointment.
- `end` (string, required): New end, ISO 8601 date-time with timezone (after start, at most 24 h later).
- `price` (number): Price of the appointment.
- `service_id` (integer, required): Service id.
- `staff_user_id` (integer, required): Staff user the appointment is with.
- `start` (string, required): New start, ISO 8601 date-time with timezone.
- `title` (string): Appointment title.

### `bookafy_cancel_appointment` (~108 tokens)

Cancel appointment

WRITE, IRREVERSIBLE: delete (cancel) an appointment. Bookafy may notify the customer and remove the event from connected calendars, and the appointment cannot be restored through the API. Only call it when the user explicitly asked to cancel this appointment. DELETE /api/v3/appointments/{id}.

Input parameters:

- `appointment_id` (integer, required): Appointment id (from bookafy_list_appointments).
- `staff_user_id` (integer, required): Staff user the appointment is with (its user_id).

### `bookafy_list_customers` (~140 tokens)

List customers

List the account's customers (id, name, email, phone and custom booking-form answers). Bookafy returns the whole list at once; use `search` (matches name, email or phone) and `limit`/`offset` to page through it. GET /api/v3/customers.

Input parameters:

- `limit` (integer): Most customers to return, 1-500 (default 100).
- `offset` (integer): Skip this many matches (default 0). Pass the previous reply's next_offset to read on.
- `search` (string): Only customers whose name, email or phone contains this text (case-insensitive).

### `bookafy_create_customer` (~115 tokens)

Create customer

WRITE: add a customer record (name required; email, phone and custom booking-form answers optional). It does not book anything. POST /api/v3/customers.

Input parameters:

- `custom_fields` (object): Custom booking-form answers as {field_name: value}, with underscores for spaces, e.g. {"What_is_your_DOB": "1990"}.
- `email` (string): Customer's email.
- `name` (string, required): Customer's full name.
- `phone` (string): Customer's phone number.

### `bookafy_update_customer` (~151 tokens)

Update customer

WRITE: change a customer's details. Bookafy needs the name every time, so pass the current name when you only change the email or phone. Fields you leave out are not sent. PUT /api/v3/customers/{id}.

Input parameters:

- `custom_fields` (object): Custom booking-form answers as {field_name: value}, with underscores for spaces, e.g. {"What_is_your_DOB": "1990"}.
- `customer_id` (integer, required): Customer id (from bookafy_list_customers).
- `email` (string): New email.
- `name` (string, required): Customer's full name (required by Bookafy on every update).
- `phone` (string): New phone number.

### `bookafy_list_services` (~51 tokens)

List services

List every service (appointment type) with id, name, price, duration, buffers, category, scheduling mode and online-meeting options. Use the ids when booking. GET /api/v3/services.

### `bookafy_list_appointment_types` (~48 tokens)

List appointment types with booking links

The appointment types grouped by category, each with its public booking-page link — use it to give a customer the link to book themselves. GET /api/v3/appointment_types.

### `bookafy_list_staff` (~42 tokens)

List staff

List the staff users (id, name, email, booking-page URL). Use the id or email for appointments. GET /api/v3/staff_members.

### `bookafy_list_classes` (~50 tokens)

List classes

List classes and one-off appointments with price, duration, location, seats, booking link and their sessions (date, seats total/filled/remaining, zoom link). GET /api/v3/classes.

### `bookafy_get_class` (~172 tokens)

Get class with sessions and attendees

One class with its sessions and the attendees booked on each (name, email, phone, booking time). Optional filters narrow the sessions. GET /api/v3/classes/{id}.

Input parameters:

- `attendee_name` (string): Only sessions with an attendee of this name.
- `class_id` (integer, required): Class id (from bookafy_list_classes).
- `duration` (integer): Only sessions of this length in minutes.
- `from` (string): Only sessions starting at or after this moment (yyyy-mm-dd or ISO 8601 date-time with timezone).
- `price` (number): Only sessions with this price.
- `provider_name` (string): Only sessions run by this provider.
- `to` (string): Only sessions ending before this moment (yyyy-mm-dd or ISO 8601 date-time with timezone).

### `bookafy_list_session_attendees` (~60 tokens)

List session attendees

The attendees of one class session (name, email, phone). Get session ids from bookafy_list_classes. GET /api/v3/sessions.

Input parameters:

- `session_id` (integer, required): Session id (sessionId in bookafy_list_classes).

### `bookafy_list_webhooks` (~43 tokens)

List webhook subscriptions

List the webhook subscriptions (id, callback URL, event type such as appointment_created or customer_updated). Read-only. GET /api/v3/api_subscriptions.

## Diagnostics

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

## Score history

- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 66
- 2026-10-31: 66
- 2026-10-30: 62

## Common questions

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

Bookafy MCP by usefulapi is listed in the public MCP registry as io.usefulapi/bookafy. Review appointments, customers and staff, and manage Bookafy bookings. This page covers its hosted endpoint (https://bookafy.usefulapi.io/mcp).

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

Bookafy 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 Bookafy MCP by usefulapi server expose?

Bookafy MCP by usefulapi exposes 15 tools: bookafy_get_account, bookafy_list_appointments, bookafy_create_appointment, bookafy_update_appointment, bookafy_cancel_appointment, and 10 more. Their descriptions and schemas cost roughly 1,841 tokens of context every time the server is loaded.

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

Its publisher declares no required credentials for Bookafy 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 Bookafy MCP by usefulapi server still maintained?

Bookafy 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://bookafy.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/bookafy/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-bookafy/bookafy.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-bookafy/bookafy.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-bookafy/bookafy