reenio MCP by usefulapi

Read reservations, customers and payments; change states and blocked times in reenio.

Should I use this

Quality & Safety

A
Description quality
96%
Schema completeness
91%
Naming quality
78%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (2)

  • LOWTool 'reenio_find_reservation_by_code' name length outside 3-30 rangein reenio_find_reservation_by_code
  • LOWTool 'reenio_get_reservation_payment_documents' name length outside 3-30 rangein reenio_get_reservation_payment_documents

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,353Tokens (tool definitions)
~1.0 KBTypical response size
Significant attention impact (2.62% of 128k context)

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-http

What it can do

Tool inventory

Tools (22)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded22 tools