reenio MCP by usefulapi
Read reservations, customers and payments; change states and blocked times in reenio.
Should I use this
Quality & Safety
Findings (2)
- LOWin reenio_find_reservation_by_code
- LOWin reenio_get_reservation_payment_documents
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"reenio": {
"url": "https://reenio.usefulapi.io/mcp"
}
}
}Remote endpoints
https://reenio.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (22)
🟢reenio_check_access
Check that the reenio API key works. Returns accessible: true when reenio accepts it. GET /auth/checkaccess.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_get_user_info
Return the business account and the user the API key was issued for. GET /user/info.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_list_reservations(start, end, includeCancelled, includeAlternate, placeId, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"start": {
"description": "Period start (inclusive). Required unless nextPage is given.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"end": {
"description": "Period end (inclusive). Max 90 days after start. Required unless nextPage is given.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}"
},
"includeCancelled": {
"description": "Include cancelled reservations (default false).",
"type": "boolean"
},
"includeAlternate": {
"description": "Include alternate reservations.",
"type": "boolean"
},
"placeId": {
"description": "Filter by place id (from reenio_list_resources).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"serviceId": {
"description": "Filter by service id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"employeeId": {
"description": "Filter by employee id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"resourceId": {
"description": "Filter by resource id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Page size (the vendor default applies when omitted).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"nextPage": {
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_get_reservation(id)
Get one reservation with its customer, tickets, price, paid flag, state and newStateOptions (the states it may move to). GET /reservation/{id}.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Reservation id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_find_reservation_by_code(code)
Find a reservation by its reservation code, for example from a QR code at check-in. GET /reservation/detailbycode/{code}.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Reservation code."
}
},
"required": [
"code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_get_reservations(ids)
Get the details of up to 100 reservations in one call. GET /reservations/{ids}.
Input Schema
{
"type": "object",
"properties": {
"ids": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Reservation ids."
}
},
"required": [
"ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_list_customers(limit, nextPage)
List customers, one page at a time. For the next page, pass only nextPage. GET /customer.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Page size (the vendor default applies when omitted).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"nextPage": {
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_get_customer(id)
Get one customer profile: contact details, address, custom fields, labels and note. GET /customer/{id}.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_get_customer_credit(id)
Get a customer's credit balance and its expiration. GET /customer/{id}/credit.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_list_payment_documents(start, end, limit, nextPage)
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.
Input Schema
{
"type": "object",
"properties": {
"start": {
"description": "Period start, yyyy-mm-dd (inclusive). Required unless nextPage is given.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end": {
"description": "Period end, yyyy-mm-dd (inclusive). Max 90 days after start. Required unless nextPage is given.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"limit": {
"description": "Page size (the vendor default applies when omitted).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"nextPage": {
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_get_reservation_payment_documents(id)
List the payment documents (invoices, receipts) linked to one reservation. GET /paymentdocument/reservation/{id}.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Reservation id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_list_resources(kind)
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.
Input Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"place",
"service",
"employee",
"resource",
"capacity_variant"
],
"description": "Which reference list to return. resource = combinations that resourceId refers to."
}
},
"required": [
"kind"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_list_blocking_times(start, end)
List the time blocks in a period when reservations are not possible (recurring blocks are expanded into occurrences). GET /blockingtimeoccurence.
Input Schema
{
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Period start."
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}",
"description": "Period end."
}
},
"required": [
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_list_reviews(limit, nextPage)
List customer reviews, one page at a time. For the next page, pass only nextPage. GET /review.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Page size (the vendor default applies when omitted).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"nextPage": {
"description": "The nextPage URL from the previous response, exactly as returned. Omit it for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reenio_search_coupon_code(code)
Find a discount code by its text. Returns the code id, which reenio_redeem_coupon_code needs. GET /couponcode/search/{code}.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The discount code as the customer typed it."
}
},
"required": [
"code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reenio_set_reservation_state(id, state)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Reservation id."
},
"state": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Target state code."
}
},
"required": [
"id",
"state"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reenio_set_reservation_paid(id, isPaid)
Set the paid flag of one reservation. PUT /reservation/{id}/ispaid.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Reservation id."
},
"isPaid": {
"type": "boolean",
"description": "true = paid, false = unpaid."
}
},
"required": [
"id",
"isPaid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reenio_cancel_reservation(id)
Cancel one reservation. A paid reservation cannot be cancelled (HTTP 405). PUT /reservation/{id}/cancel.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Reservation id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reenio_create_blocking_time(start, end, placeId, serviceId, employeeId, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T",
"description": "Block start, ISO 8601 UTC."
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T",
"description": "Block end, ISO 8601 UTC."
},
"placeId": {
"description": "Place to block.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"serviceId": {
"description": "Service to block.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"employeeId": {
"description": "Employee to block.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"resourceId": {
"description": "Resource combination to block.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"note": {
"description": "Internal note (max 500 characters).",
"type": "string",
"maxLength": 500
}
},
"required": [
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reenio_delete_blocking_time(id)
Delete one blocked-time definition, so reservations are possible again. DELETE /blockingtimedefinition/{id}.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Blocked-time definition id (from reenio_list_blocking_times)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reenio_update_customer(id, firstName, lastName, degree, note)
Update the first name, last name, degree or note of one customer. Pass only the fields to change. PATCH /customer/{id}.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer id."
},
"firstName": {
"type": "string",
"maxLength": 200
},
"lastName": {
"type": "string",
"maxLength": 200
},
"degree": {
"description": "Title, for example Dr.",
"type": "string",
"maxLength": 100
},
"note": {
"description": "Internal customer note.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reenio_redeem_coupon_code(couponCodeId)
Mark a discount code as used (check in the code). Use the code id from reenio_search_coupon_code. PUT /couponcode/{id}/checkin.
Input Schema
{
"type": "object",
"properties": {
"couponCodeId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Coupon code id (from reenio_search_coupon_code)."
}
},
"required": [
"couponCodeId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence