Quendoo MCP by usefulapi
Read rooms, rates and bookings; set availability, rates, restrictions; book and cancel in Quendoo.
¿Debería usar esto?
Calidad y seguridad
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": {
"quendoo": {
"url": "https://quendoo.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://quendoo.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (18)
🟢quendoo_list_properties(page, limit)
List the hotel properties this token reaches, with name, type, currency, star rating and mode (shadow or live). Good first call to get a property_id. Connect API: GET /properties.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_get_property(property_id)
Read one property: address, contact details, check-in and check-out times, currency and mode. Connect API: GET /properties/{property_id}.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_get_structure(property_id)
Read the whole structure of one property: room types, rate plans and their links. One call instead of several. Connect API: GET /properties/{property_id}/structure.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_list_room_types(property_id)
List the room types of one property, with capacity, quantity and partner code. Connect API: GET /properties/{property_id}/room_types.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_list_rate_plans(property_id)
List the rate plans of one property: room type, meal plan, cancellation and payment policy, and occupancy rates. Connect API: GET /properties/{property_id}/rate_plans.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_get_availability(property_id, date_from, date_to, room_type_id)
Read the calendar per day and room type: rooms open, booked and free to sell. Use a date range of a few weeks. Connect API: GET /properties/{property_id}/availability.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"room_type_id": {
"description": "Limit to one room type.",
"type": "string"
}
},
"required": [
"property_id",
"date_from",
"date_to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_get_rates(property_id, rate_plan_id, date_from, date_to, consolidated)
Read the prices and restrictions of one rate plan over a date range. Connect API: GET /properties/{property_id}/rate_plans/{rate_plan_id}/rates.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"rate_plan_id": {
"type": "string",
"description": "The rate plan id (from quendoo_list_rate_plans)."
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"consolidated": {
"description": "true returns one merged row per run of equal days.",
"type": "boolean"
}
},
"required": [
"property_id",
"rate_plan_id",
"date_from",
"date_to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_search_offers(property_id, checkin, checkout, adults, children_ages, ...)
Search the offers a property sells for dates and a party. Returns each offer with a search_token (valid 30 minutes) to book with quendoo_book_from_search. Connect API: GET /properties/{property_id}/booking_offers.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"checkin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"checkout": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "Adults in the first room."
},
"children_ages": {
"description": "Ages of the children in the first room.",
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 17
}
},
"promo_code": {
"type": "string"
},
"currency": {
"description": "ISO 4217 code, for example EUR.",
"type": "string",
"minLength": 3,
"maxLength": 3
},
"lang": {
"description": "Language code, for example en.",
"type": "string"
}
},
"required": [
"property_id",
"checkin",
"checkout",
"adults"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_list_bookings(property_id, page, limit, checkin_from, checkin_to, ...)
List bookings of one property, filtered by check-in or check-out window, status or guest name. Connect API: GET /properties/{property_id}/bookings.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"checkin_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"checkin_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"checkout_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"checkout_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"booking_status": {
"description": "Filter by booking status, for example CREATED or CANCELLED.",
"type": "string"
},
"partner_reference": {
"description": "Your own reference, sent when you booked.",
"type": "string"
},
"guest_name": {
"type": "string"
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_get_booking(property_id, booking_id)
Read one booking: status, payment status, dates, total amount and payment plan. Connect API: GET /properties/{property_id}/bookings/{booking_id}.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"booking_id": {
"type": "string",
"description": "The booking id (from quendoo_list_bookings)."
}
},
"required": [
"property_id",
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_get_cancellation_quote(property_id, booking_id)
Read what cancelling a booking costs today, under its cancellation policy. Makes no change. Connect API: GET /properties/{property_id}/bookings/{booking_id}/cancellation_quote.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"booking_id": {
"type": "string",
"description": "The booking id (from quendoo_list_bookings)."
}
},
"required": [
"property_id",
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quendoo_list_booking_revisions(property_id, since, limit, lang)
Read the booking change feed: created, changed and cancelled bookings not yet acknowledged. Pass next_cursor as since to continue. Reading does not acknowledge. Connect API: GET /booking_revisions/feed.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"description": "Limit the feed to one property.",
"type": "string"
},
"since": {
"description": "Cursor: the next_cursor of the last answer.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"lang": {
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡quendoo_update_availability(property_id, values, idempotency_key)
Set the rooms to sell, and open or close room types, for date ranges. Send up to 1000 rows per call; a row covers a date range. Connect API: POST /properties/{property_id}/inventory/availability. Writes take effect only when the property is live. In shadow mode the answer has dry: true and nothing is stored.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"values": {
"minItems": 1,
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"room_type_id": {
"type": "string"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"availability": {
"description": "Rooms to sell in the date range.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"opened": {
"description": "true opens the room type for sale in the range.",
"type": "boolean"
},
"closed": {
"description": "true closes the room type in the range.",
"type": "boolean"
}
},
"required": [
"room_type_id",
"date_from",
"date_to"
]
}
},
"idempotency_key": {
"description": "Optional Idempotency-Key. A retry with the same key is replayed, not done twice.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"property_id",
"values"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡quendoo_update_rates(property_id, values, idempotency_key)
Set the price of a rate plan on a room type for date ranges. Send up to 1000 rows per call. Connect API: POST /properties/{property_id}/inventory/rates. Writes take effect only when the property is live. In shadow mode the answer has dry: true and nothing is stored.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"values": {
"minItems": 1,
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"room_type_id": {
"type": "string"
},
"rate_plan_id": {
"type": "string"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"rate": {
"description": "Price for the date range, in the property currency.",
"type": "number",
"minimum": 0
},
"prices": {
"description": "Prices per occupancy, in the shape the rate plan defines.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"room_type_id",
"rate_plan_id",
"date_from",
"date_to"
]
}
},
"idempotency_key": {
"description": "Optional Idempotency-Key. A retry with the same key is replayed, not done twice.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"property_id",
"values"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡quendoo_update_restrictions(property_id, values, idempotency_key)
Set stay restrictions (minimum or maximum nights, stop sell, closed to arrival or departure) for date ranges. Send up to 900 rows per call. Connect API: POST /properties/{property_id}/inventory/restrictions. Writes take effect only when the property is live. In shadow mode the answer has dry: true and nothing is stored.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"values": {
"minItems": 1,
"maxItems": 900,
"type": "array",
"items": {
"type": "object",
"properties": {
"room_type_id": {
"type": "string"
},
"rate_plan_id": {
"type": "string"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date, yyyy-mm-dd."
},
"min_los": {
"description": "Minimum length of stay, in nights.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_los": {
"description": "Maximum length of stay, in nights.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"stop_sell": {
"type": "boolean"
},
"closed_to_arrival": {
"type": "boolean"
},
"closed_to_departure": {
"type": "boolean"
}
},
"required": [
"room_type_id",
"rate_plan_id",
"date_from",
"date_to"
]
}
},
"idempotency_key": {
"description": "Optional Idempotency-Key. A retry with the same key is replayed, not done twice.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"property_id",
"values"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴quendoo_book_from_search(property_id, search_token, client, items, partner_reference, ...)
Create a real booking from a search_token and the offers the guest chose. Confirm the guest, dates and price first. Returns the payment_url to send to the guest. Connect API: POST /properties/{property_id}/bookings/from_search. Writes take effect only when the property is live. In shadow mode the answer has dry: true and nothing is stored.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"search_token": {
"type": "string",
"minLength": 1,
"description": "The search_token from quendoo_search_offers. Valid 30 minutes."
},
"client": {
"type": "object",
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"nationality": {
"type": "string"
},
"lng_locale": {
"type": "string"
}
},
"required": [
"first_name",
"last_name",
"email",
"phone"
]
},
"items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"offer_id": {
"type": "string"
},
"guests": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "A guest entry, in the shape of the offer's guests list."
}
},
"extras": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"offer_id"
]
}
},
"partner_reference": {
"description": "Your own booking reference.",
"type": "string"
},
"additional_notes": {
"type": "string"
},
"request": {
"description": "true sends a booking request the hotel must approve.",
"type": "boolean"
},
"payment_method_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"idempotency_key": {
"description": "Optional Idempotency-Key. A retry with the same key is replayed, not done twice.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"property_id",
"search_token",
"client",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴quendoo_cancel_booking(property_id, booking_id, idempotency_key)
Cancel a whole booking. Read quendoo_get_cancellation_quote first and confirm the cost with the user. Connect API: POST /properties/{property_id}/bookings/{booking_id}/cancel.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The property id (from quendoo_list_properties)."
},
"booking_id": {
"type": "string",
"description": "The booking id (from quendoo_list_bookings)."
},
"idempotency_key": {
"description": "Optional Idempotency-Key. A retry with the same key is replayed, not done twice.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"property_id",
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡quendoo_ack_booking_revision(revision_id, idempotency_key)
Acknowledge one booking change from quendoo_list_booking_revisions after you saved it. Acknowledging the same change again is safe. Connect API: POST /booking_revisions/{id}/ack.
Esquema de entrada
{
"type": "object",
"properties": {
"revision_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The numeric id of the change (from quendoo_list_booking_revisions)."
},
"idempotency_key": {
"description": "Optional Idempotency-Key. A retry with the same key is replayed, not done twice.",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"revision_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia