Appointo MCP by usefulapi is an MCP server published by io.usefulapi, hosted at appointo.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 10 tools, including appointo_list_products, appointo_list_appointments, appointo_get_availability, appointo_list_bookings, appointo_list_cancelled_bookings.
Read Appointo bookings, availability and subscriptions; create, reschedule and cancel bookings.
4,148 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the Shopify products that are set up as bookable in Appointo: name, appointment type, whether the widget is shown, and each product's appointments (the bookable variants/services with price, currency and id). Use an appointment id for availability and bookings. GET /products.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| search_term | string | Filter by product name. |
{
"name": "appointo_list_products",
"title": "List bookable products",
"description": "List the Shopify products that are set up as bookable in Appointo: name, appointment type, whether the widget is shown, and each product's appointments (the bookable variants/services with price, currency and id). Use an appointment id for availability and bookings. GET /products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"search_term": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Filter by product name."
}
}
},
"annotations": {
"title": "List bookable products",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List appointments, i.e. the bookable services/variants, with name, price, currency and configuration. Filter by product or fetch one by id. These are the services customers book, not the bookings themselves (use appointo_list_bookings for those). GET /appointments.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| product_id | integer | Only appointments of this Appointo product id (the `id` from appointo_list_products). |
| search_term | string | |
| appointment_id | integer | Fetch a single appointment by id. |
{
"name": "appointo_list_appointments",
"title": "List appointments (bookable services)",
"description": "List appointments, i.e. the bookable services/variants, with name, price, currency and configuration. Filter by product or fetch one by id. These are the services customers book, not the bookings themselves (use appointo_list_bookings for those). GET /appointments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"product_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only appointments of this Appointo product id (the `id` from appointo_list_products).",
"exclusiveMinimum": 0
},
"search_term": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fetch a single appointment by id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List appointments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The free time slots of one appointment (bookable service) from start_date, optionally to end_date. Use it before creating or rescheduling a booking. GET /appointments/{appointment_id}/calendar_availability.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | Last day, yyyy-mm-dd. |
| start_date * | string | First day, yyyy-mm-dd. |
| appointment_id * | integer | Appointo appointment id (from appointo_list_appointments). |
{
"name": "appointo_get_availability",
"title": "Get appointment availability",
"description": "The free time slots of one appointment (bookable service) from start_date, optionally to end_date. Use it before creating or rescheduling a booking. GET /appointments/{appointment_id}/calendar_availability.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"appointment_id",
"start_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Appointo appointment id (from appointo_list_appointments).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get availability",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List bookings with time, product, duration, quantity, price and the customers (name, email, phone, address). Filter upcoming/past or search; pass booking_id for one booking. The customers' cancel/reschedule link ids are never returned. GET /bookings.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| status | string | Only upcoming or only past bookings. |
| booking_id | integer | Fetch a single booking by id. |
| search_term | string | Searches product name, customer name, email, phone and order name. |
{
"name": "appointo_list_bookings",
"title": "List bookings",
"description": "List bookings with time, product, duration, quantity, price and the customers (name, email, phone, address). Filter upcoming/past or search; pass booking_id for one booking. The customers' cancel/reschedule link ids are never returned. GET /bookings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"status": {
"enum": [
"upcoming",
"past"
],
"type": "string",
"description": "Only upcoming or only past bookings."
},
"booking_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fetch a single booking by id.",
"exclusiveMinimum": 0
},
"search_term": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Searches product name, customer name, email, phone and order name."
}
}
},
"annotations": {
"title": "List bookings",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List cancelled bookings, same shape as appointo_list_bookings. GET /bookings/cancelled_bookings.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 25). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset. |
| status | string | Only upcoming or only past bookings. |
| search_term | string | Searches product name, customer name, email, phone and order name. |
{
"name": "appointo_list_cancelled_bookings",
"title": "List cancelled bookings",
"description": "List cancelled bookings, same shape as appointo_list_bookings. GET /bookings/cancelled_bookings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset."
},
"status": {
"enum": [
"upcoming",
"past"
],
"type": "string",
"description": "Only upcoming or only past bookings."
},
"search_term": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Searches product name, customer name, email, phone and order name."
}
}
},
"annotations": {
"title": "List cancelled bookings",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the recurring booking subscription contracts (customers who subscribed to repeat appointments). Search by product, variant, order number or customer name. The API documents no paging for this list. GET /appointment_subscriptions.
| Parameter | Type | Description |
|---|---|---|
| search_term | string | Product name, variant name, order number or customer name. |
{
"name": "appointo_list_subscription_contracts",
"title": "List subscription contracts",
"description": "List the recurring booking subscription contracts (customers who subscribed to repeat appointments). Search by product, variant, order number or customer name. The API documents no paging for this list. GET /appointment_subscriptions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"search_term": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Product name, variant name, order number or customer name."
}
}
},
"annotations": {
"title": "List subscription contracts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create a booking for a customer on an appointment (bookable service) at a time slot. This is a real booking: Appointo may email the customer a confirmation and reserve the slot; the booking can later be cancelled with appointo_cancel_booking. Check appointo_get_availability first. Not idempotent: calling twice creates two bookings. The docs cap this at 100 requests per day. POST /bookings.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Customer name. |
| email * | string | Customer email. |
| phone | string | Customer phone number. |
| quantity | integer | Number of spots (default 1). |
| timestring * | string | Start of the time slot, ISO 8601, e.g. 2026-11-03T14:00:00-05:00 (use a date only, 2026-11-03, for a day booking). Check appointo_get_availability for real slots. |
| appointment_id * | integer | Appointo appointment id (from appointo_list_appointments). |
{
"name": "appointo_create_booking",
"title": "Create booking",
"description": "WRITE: create a booking for a customer on an appointment (bookable service) at a time slot. This is a real booking: Appointo may email the customer a confirmation and reserve the slot; the booking can later be cancelled with appointo_cancel_booking. Check appointo_get_availability first. Not idempotent: calling twice creates two bookings. The docs cap this at 100 requests per day. POST /bookings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"appointment_id",
"timestring",
"name",
"email"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Customer name."
},
"email": {
"type": "string",
"pattern": "^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$",
"maxLength": 254,
"minLength": 3,
"description": "Customer email."
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Customer phone number."
},
"quantity": {
"type": "integer",
"maximum": 1000,
"description": "Number of spots (default 1).",
"exclusiveMinimum": 0
},
"timestring": {
"type": "string",
"description": "Start of the time slot, ISO 8601, e.g. 2026-11-03T14:00:00-05:00 (use a date only, 2026-11-03, for a day booking). Check appointo_get_availability for real slots."
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Appointo appointment id (from appointo_list_appointments).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: move a booking (or only some of its customers) to a new time slot. Appointo may notify the customers of the change. override=true forces the booking into the slot even if it is unavailable or full, so leave it off unless the user explicitly asked for it. The docs cap this at 100 requests per day. PUT /bookings/reschedule.
| Parameter | Type | Description |
|---|---|---|
| override | boolean | Force the slot even if unavailable (default false). |
| booking_id * | integer | Booking id (from appointo_list_bookings). |
| timestring * | string | Start of the time slot, ISO 8601, e.g. 2026-11-03T14:00:00-05:00 (use a date only, 2026-11-03, for a day booking). Check appointo_get_availability for real slots. |
| customer_ids | array | Only move these customer ids of the booking; omit to move the whole booking. |
{
"name": "appointo_reschedule_booking",
"title": "Reschedule booking",
"description": "WRITE: move a booking (or only some of its customers) to a new time slot. Appointo may notify the customers of the change. override=true forces the booking into the slot even if it is unavailable or full, so leave it off unless the user explicitly asked for it. The docs cap this at 100 requests per day. PUT /bookings/reschedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id",
"timestring"
],
"properties": {
"override": {
"type": "boolean",
"description": "Force the slot even if unavailable (default false)."
},
"booking_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Booking id (from appointo_list_bookings).",
"exclusiveMinimum": 0
},
"timestring": {
"type": "string",
"description": "Start of the time slot, ISO 8601, e.g. 2026-11-03T14:00:00-05:00 (use a date only, 2026-11-03, for a day booking). Check appointo_get_availability for real slots."
},
"customer_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"minItems": 1,
"description": "Only move these customer ids of the booking; omit to move the whole booking."
}
}
},
"annotations": {
"title": "Reschedule booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: cancel a booking, or only some of its customers. The slot is freed and Appointo may notify the customers; whether a Shopify order is refunded is not controlled by this call. Cannot be undone through this server (create a new booking instead). The docs cap this at 100 requests per day. PUT /bookings/cancel.
| Parameter | Type | Description |
|---|---|---|
| booking_id * | integer | Booking id (from appointo_list_bookings). |
| customer_ids | array | Only cancel these customer ids of the booking; omit to cancel the whole booking. |
{
"name": "appointo_cancel_booking",
"title": "Cancel booking",
"description": "WRITE: cancel a booking, or only some of its customers. The slot is freed and Appointo may notify the customers; whether a Shopify order is refunded is not controlled by this call. Cannot be undone through this server (create a new booking instead). The docs cap this at 100 requests per day. PUT /bookings/cancel.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id"
],
"properties": {
"booking_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Booking id (from appointo_list_bookings).",
"exclusiveMinimum": 0
},
"customer_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"minItems": 1,
"description": "Only cancel these customer ids of the booking; omit to cancel the whole booking."
}
}
},
"annotations": {
"title": "Cancel booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: set the start and/or end buffer time (minutes blocked before/after) of one booking. At least one value is required. The docs cap this at 100 requests per day. PUT /bookings/{booking_id}.
| Parameter | Type | Description |
|---|---|---|
| booking_id * | integer | Booking id (from appointo_list_bookings). |
| end_buffer_time | integer | Buffer after the booking, minutes (> 0). |
| start_buffer_time | integer | Buffer before the booking, minutes (> 0). |
{
"name": "appointo_update_booking_buffers",
"title": "Update booking buffer times",
"description": "WRITE: set the start and/or end buffer time (minutes blocked before/after) of one booking. At least one value is required. The docs cap this at 100 requests per day. PUT /bookings/{booking_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id"
],
"properties": {
"booking_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Booking id (from appointo_list_bookings).",
"exclusiveMinimum": 0
},
"end_buffer_time": {
"type": "integer",
"maximum": 100000,
"description": "Buffer after the booking, minutes (> 0).",
"exclusiveMinimum": 0
},
"start_buffer_time": {
"type": "integer",
"maximum": 100000,
"description": "Buffer before the booking, minutes (> 0).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update booking buffer times",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Appointo, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which bookings do I have tomorrow and who are the customers?"; "Show the free slots for my 60-minute consultation next week."; "Move booking 969 to Thursday at 2 pm.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Appointo data. Free plan: 50 tool calls per month. Run appointo_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run appointo_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run appointo_upgrade without a plan: it returns both plans, each with a payment link for the user to open. appointo_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.