reenio MCP by usefulapi
Read reservations, customers and payments; change states and blocked times in reenio.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (2)
- LOWen reenio_find_reservation_by_code
- LOWen reenio_get_reservation_payment_documents
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"reenio": {
"url": "https://reenio.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://reenio.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (22)
🟢reenio_check_access
Check that the reenio API key works. Returns accessible: true when reenio accepts it. GET /auth/checkaccess.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia