reenio MCP by usefulapi is an MCP server published by io.usefulapi, hosted at reenio.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 22 tools, including reenio_check_access, reenio_get_user_info, reenio_list_reservations, reenio_get_reservation, reenio_find_reservation_by_code.
Read reservations, customers and payments; change states and blocked times in reenio.
4,113 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Check that the reenio API key works. Returns accessible: true when reenio accepts it. GET /auth/checkaccess.
No parameters.
{
"name": "reenio_check_access",
"title": "Check API key access",
"description": "Check that the reenio API key works. Returns accessible: true when reenio accepts it. GET /auth/checkaccess.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Check API key access",
"readOnlyHint": true
}
}Return the business account and the user the API key was issued for. GET /user/info.
None yet. Changes appear after a server's second daily check.
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.
No parameters.
{
"name": "reenio_get_user_info",
"title": "Get account and key owner",
"description": "Return the business account and the user the API key was issued for. GET /user/info.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account and key owner",
"readOnlyHint": true
}
}List reservations in a period, optionally filtered by place, service, employee or resource. Max 90 days per request. For the next page, pass only nextPage (from the previous response). Dates: yyyy-mm-dd or ISO 8601 UTC. GET /reservation.
| Parameter | Type | Description |
|---|---|---|
| end | string | Period end (inclusive). Max 90 days after start. Required unless nextPage is given. |
| limit | integer | Page size (the vendor default applies when omitted). |
| start | string | Period start (inclusive). Required unless nextPage is given. |
| placeId | integer | Filter by place id (from reenio_list_resources). |
| nextPage | string | The nextPage URL from the previous response, exactly as returned. Omit it for the first page. |
| serviceId | integer | Filter by service id. |
| employeeId | integer | Filter by employee id. |
| resourceId | integer | Filter by resource id. |
| includeAlternate | boolean | Include alternate reservations. |
| includeCancelled | boolean | Include cancelled reservations (default false). |
{
"name": "reenio_list_reservations",
"title": "List reservations",
"description": "List reservations in a period, optionally filtered by place, service, employee or resource. Max 90 days per request. For the next page, pass only nextPage (from the previous response). Dates: yyyy-mm-dd or ISO 8601 UTC. GET /reservation.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Period end (inclusive). Max 90 days after start. Required unless nextPage is given."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size (the vendor default applies when omitted).",
"exclusiveMinimum": 0
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Period start (inclusive). Required unless nextPage is given."
},
"placeId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Filter by place id (from reenio_list_resources).",
"exclusiveMinimum": 0
},
"nextPage": {
"type": "string",
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page."
},
"serviceId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Filter by service id.",
"exclusiveMinimum": 0
},
"employeeId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Filter by employee id.",
"exclusiveMinimum": 0
},
"resourceId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Filter by resource id.",
"exclusiveMinimum": 0
},
"includeAlternate": {
"type": "boolean",
"description": "Include alternate reservations."
},
"includeCancelled": {
"type": "boolean",
"description": "Include cancelled reservations (default false)."
}
}
},
"annotations": {
"title": "List reservations",
"readOnlyHint": true
}
}Get one reservation with its customer, tickets, price, paid flag, state and newStateOptions (the states it may move to). GET /reservation/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Reservation id. |
{
"name": "reenio_get_reservation",
"title": "Get a reservation",
"description": "Get one reservation with its customer, tickets, price, paid flag, state and newStateOptions (the states it may move to). GET /reservation/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a reservation",
"readOnlyHint": true
}
}Find a reservation by its reservation code, for example from a QR code at check-in. GET /reservation/detailbycode/{code}.
| Parameter | Type | Description |
|---|---|---|
| code * | string | Reservation code. |
{
"name": "reenio_find_reservation_by_code",
"title": "Find a reservation by code",
"description": "Find a reservation by its reservation code, for example from a QR code at check-in. GET /reservation/detailbycode/{code}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Reservation code."
}
}
},
"annotations": {
"title": "Find a reservation by code",
"readOnlyHint": true
}
}Get the details of up to 100 reservations in one call. GET /reservations/{ids}.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | Reservation ids. |
{
"name": "reenio_get_reservations",
"title": "Get several reservations",
"description": "Get the details of up to 100 reservations in one call. GET /reservations/{ids}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"minItems": 1,
"description": "Reservation ids."
}
}
},
"annotations": {
"title": "Get several reservations",
"readOnlyHint": true
}
}List customers, one page at a time. For the next page, pass only nextPage. GET /customer.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size (the vendor default applies when omitted). |
| nextPage | string | The nextPage URL from the previous response, exactly as returned. Omit it for the first page. |
{
"name": "reenio_list_customers",
"title": "List customers",
"description": "List customers, one page at a time. For the next page, pass only nextPage. GET /customer.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size (the vendor default applies when omitted).",
"exclusiveMinimum": 0
},
"nextPage": {
"type": "string",
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}Get one customer profile: contact details, address, custom fields, labels and note. GET /customer/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Customer id. |
{
"name": "reenio_get_customer",
"title": "Get a customer",
"description": "Get one customer profile: contact details, address, custom fields, labels and note. GET /customer/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Customer id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a customer",
"readOnlyHint": true
}
}Get a customer's credit balance and its expiration. GET /customer/{id}/credit.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Customer id. |
{
"name": "reenio_get_customer_credit",
"title": "Get customer credit",
"description": "Get a customer's credit balance and its expiration. GET /customer/{id}/credit.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Customer id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get customer credit",
"readOnlyHint": true
}
}List invoices and receipts whose payment was completed in a period. Max 90 days per request. For the next page, pass only nextPage. GET /paymentdocument.
| Parameter | Type | Description |
|---|---|---|
| end | string | Period end, yyyy-mm-dd (inclusive). Max 90 days after start. Required unless nextPage is given. |
| limit | integer | Page size (the vendor default applies when omitted). |
| start | string | Period start, yyyy-mm-dd (inclusive). Required unless nextPage is given. |
| nextPage | string | The nextPage URL from the previous response, exactly as returned. Omit it for the first page. |
{
"name": "reenio_list_payment_documents",
"title": "List payment documents",
"description": "List invoices and receipts whose payment was completed in a period. Max 90 days per request. For the next page, pass only nextPage. GET /paymentdocument.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period end, yyyy-mm-dd (inclusive). Max 90 days after start. Required unless nextPage is given."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size (the vendor default applies when omitted).",
"exclusiveMinimum": 0
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Period start, yyyy-mm-dd (inclusive). Required unless nextPage is given."
},
"nextPage": {
"type": "string",
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page."
}
}
},
"annotations": {
"title": "List payment documents",
"readOnlyHint": true
}
}List the payment documents (invoices, receipts) linked to one reservation. GET /paymentdocument/reservation/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Reservation id. |
{
"name": "reenio_get_reservation_payment_documents",
"title": "Get payment documents for a reservation",
"description": "List the payment documents (invoices, receipts) linked to one reservation. GET /paymentdocument/reservation/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get payment documents for a reservation",
"readOnlyHint": true
}
}List the reference data that reservations use: places, services, employees, resource combinations (place + service + employee) or capacity variants (for example adult and child). Changes rarely. GET /resource/place, /resource/service, /resource/employee, /resource, /capacityvariant.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | Which reference list to return. resource = combinations that resourceId refers to. |
{
"name": "reenio_list_resources",
"title": "List places, services and employees",
"description": "List the reference data that reservations use: places, services, employees, resource combinations (place + service + employee) or capacity variants (for example adult and child). Changes rarely. GET /resource/place, /resource/service, /resource/employee, /resource, /capacityvariant.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"place",
"service",
"employee",
"resource",
"capacity_variant"
],
"type": "string",
"description": "Which reference list to return. resource = combinations that resourceId refers to."
}
}
},
"annotations": {
"title": "List places, services and employees",
"readOnlyHint": true
}
}List the time blocks in a period when reservations are not possible (recurring blocks are expanded into occurrences). GET /blockingtimeoccurence.
| Parameter | Type | Description |
|---|---|---|
| end * | string | Period end. |
| start * | string | Period start. |
{
"name": "reenio_list_blocking_times",
"title": "List blocked times",
"description": "List the time blocks in a period when reservations are not possible (recurring blocks are expanded into occurrences). GET /blockingtimeoccurence.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Period end."
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Period start."
}
}
},
"annotations": {
"title": "List blocked times",
"readOnlyHint": true
}
}List customer reviews, one page at a time. For the next page, pass only nextPage. GET /review.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size (the vendor default applies when omitted). |
| nextPage | string | The nextPage URL from the previous response, exactly as returned. Omit it for the first page. |
{
"name": "reenio_list_reviews",
"title": "List customer reviews",
"description": "List customer reviews, one page at a time. For the next page, pass only nextPage. GET /review.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size (the vendor default applies when omitted).",
"exclusiveMinimum": 0
},
"nextPage": {
"type": "string",
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page."
}
}
},
"annotations": {
"title": "List customer reviews",
"readOnlyHint": true
}
}Find a discount code by its text. Returns the code id, which reenio_redeem_coupon_code needs. GET /couponcode/search/{code}.
| Parameter | Type | Description |
|---|---|---|
| code * | string | The discount code as the customer typed it. |
{
"name": "reenio_search_coupon_code",
"title": "Search a coupon code",
"description": "Find a discount code by its text. Returns the code id, which reenio_redeem_coupon_code needs. GET /couponcode/search/{code}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The discount code as the customer typed it."
}
}
},
"annotations": {
"title": "Search a coupon code",
"readOnlyHint": true
}
}Move a reservation to another state. Allowed states come from reenio_get_reservation (newStateOptions). Standard codes: 0 new, 1 confirmed, 2 cancelled, 3 did not take place, 4 took place, 5 no-show, 6 approved. PUT /reservation/{id}/state.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Reservation id. |
| state * | integer | Target state code. |
{
"name": "reenio_set_reservation_state",
"title": "Change reservation state",
"description": "Move a reservation to another state. Allowed states come from reenio_get_reservation (newStateOptions). Standard codes: 0 new, 1 confirmed, 2 cancelled, 3 did not take place, 4 took place, 5 no-show, 6 approved. PUT /reservation/{id}/state.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"state"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation id.",
"exclusiveMinimum": 0
},
"state": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Target state code."
}
}
},
"annotations": {
"title": "Change reservation state",
"destructiveHint": true
}
}Set the paid flag of one reservation. PUT /reservation/{id}/ispaid.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Reservation id. |
| isPaid * | boolean | true = paid, false = unpaid. |
{
"name": "reenio_set_reservation_paid",
"title": "Mark reservation paid or unpaid",
"description": "Set the paid flag of one reservation. PUT /reservation/{id}/ispaid.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"isPaid"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation id.",
"exclusiveMinimum": 0
},
"isPaid": {
"type": "boolean",
"description": "true = paid, false = unpaid."
}
}
},
"annotations": {
"title": "Mark reservation paid or unpaid",
"destructiveHint": true
}
}Cancel one reservation. A paid reservation cannot be cancelled (HTTP 405). PUT /reservation/{id}/cancel.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Reservation id. |
{
"name": "reenio_cancel_reservation",
"title": "Cancel a reservation",
"description": "Cancel one reservation. A paid reservation cannot be cancelled (HTTP 405). PUT /reservation/{id}/cancel.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Cancel a reservation",
"destructiveHint": true
}
}Block a time so reservations are not possible, for example to mirror an external calendar. Give the period and at least one of placeId, serviceId, employeeId or resourceId. POST /blockingtimedefinition.
| Parameter | Type | Description |
|---|---|---|
| end * | string | Block end, ISO 8601 UTC. |
| note | string | Internal note (max 500 characters). |
| start * | string | Block start, ISO 8601 UTC. |
| placeId | integer | Place to block. |
| serviceId | integer | Service to block. |
| employeeId | integer | Employee to block. |
| resourceId | integer | Resource combination to block. |
{
"name": "reenio_create_blocking_time",
"title": "Block a time",
"description": "Block a time so reservations are not possible, for example to mirror an external calendar. Give the period and at least one of placeId, serviceId, employeeId or resourceId. POST /blockingtimedefinition.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T",
"description": "Block end, ISO 8601 UTC."
},
"note": {
"type": "string",
"maxLength": 500,
"description": "Internal note (max 500 characters)."
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T",
"description": "Block start, ISO 8601 UTC."
},
"placeId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Place to block.",
"exclusiveMinimum": 0
},
"serviceId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Service to block.",
"exclusiveMinimum": 0
},
"employeeId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Employee to block.",
"exclusiveMinimum": 0
},
"resourceId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Resource combination to block.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Block a time",
"destructiveHint": true
}
}Delete one blocked-time definition, so reservations are possible again. DELETE /blockingtimedefinition/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Blocked-time definition id (from reenio_list_blocking_times). |
{
"name": "reenio_delete_blocking_time",
"title": "Delete a blocked time",
"description": "Delete one blocked-time definition, so reservations are possible again. DELETE /blockingtimedefinition/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Blocked-time definition id (from reenio_list_blocking_times).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Delete a blocked time",
"destructiveHint": true
}
}Update the first name, last name, degree or note of one customer. Pass only the fields to change. PATCH /customer/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Customer id. |
| note | string | Internal customer note. |
| degree | string | Title, for example Dr. |
| lastName | string | |
| firstName | string |
{
"name": "reenio_update_customer",
"title": "Update customer details",
"description": "Update the first name, last name, degree or note of one customer. Pass only the fields to change. PATCH /customer/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Customer id.",
"exclusiveMinimum": 0
},
"note": {
"type": "string",
"maxLength": 2000,
"description": "Internal customer note."
},
"degree": {
"type": "string",
"maxLength": 100,
"description": "Title, for example Dr."
},
"lastName": {
"type": "string",
"maxLength": 200
},
"firstName": {
"type": "string",
"maxLength": 200
}
}
},
"annotations": {
"title": "Update customer details",
"destructiveHint": true
}
}Mark a discount code as used (check in the code). Use the code id from reenio_search_coupon_code. PUT /couponcode/{id}/checkin.
| Parameter | Type | Description |
|---|---|---|
| couponCodeId * | integer | Coupon code id (from reenio_search_coupon_code). |
{
"name": "reenio_redeem_coupon_code",
"title": "Redeem a coupon code",
"description": "Mark a discount code as used (check in the code). Use the code id from reenio_search_coupon_code. PUT /couponcode/{id}/checkin.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"couponCodeId"
],
"properties": {
"couponCodeId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Coupon code id (from reenio_search_coupon_code).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Redeem a coupon code",
"destructiveHint": true
}
}Tools for reenio, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which reservations do we have tomorrow, and which of them are not paid yet?"; "Find the reservation for code ABC123 and check it in."; "Show the payment documents from last week so I can send them to the accountant.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes reenio data. Free plan: 50 tool calls per month. Run reenio_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 reenio_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 reenio_upgrade without a plan: it returns both plans, each with a payment link for the user to open. reenio_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.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.