Amenitiz MCP by usefulapi
Read properties, unit groups, bookings, invoices, rate plans and availability in Amenitiz.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"amenitiz": {
"url": "https://amenitiz.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://amenitiz.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (15)
🟢amenitiz_list_properties(cursor, limit)
List the hotel properties this credential can read. Use this first to find property IDs. GET /inventory/properties.
Eingabe-Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_get_property(property_id)
Fetch one property by UUID. GET /inventory/properties/{uuid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Property ID (UUID)."
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_list_unit_groups(property_id, name, cursor, limit)
List the unit groups (room types) of one property, optionally filtered by name. GET /inventory/unit-groups.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Property ID (UUID)."
},
"name": {
"description": "Filter by unit group name.",
"type": "string",
"maxLength": 200
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_get_unit_group(unit_group_id)
Fetch one unit group by UUID. GET /inventory/unit-groups/{uuid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"unit_group_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Unit group ID (UUID)."
}
},
"required": [
"unit_group_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_list_units(unit_group_id, cursor, limit)
List the physical units inside one unit group. GET /inventory/units.
Eingabe-Schema
{
"type": "object",
"properties": {
"unit_group_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Unit group ID (UUID)."
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"unit_group_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_get_unit(unit_id)
Fetch one unit by UUID. GET /inventory/units/{uuid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"unit_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Unit ID (UUID)."
}
},
"required": [
"unit_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_list_bookings(property_id, reference, created_from, created_to, arrival_from, ...)
List bookings for one property. Pass a reference, or at least one From date (created, arrival, departure or cancelled). Each date axis spans at most 90 days. GET /bookings/bookings.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Property ID (UUID)."
},
"reference": {
"description": "Booking reference. Use it instead of a date range.",
"type": "string",
"maxLength": 100
},
"created_from": {
"description": "Created from, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"created_to": {
"description": "Created to, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"arrival_from": {
"description": "Arrival from, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"arrival_to": {
"description": "Arrival to, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"departure_from": {
"description": "Departure from, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"departure_to": {
"description": "Departure to, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"cancelled_from": {
"description": "Cancelled from, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"cancelled_to": {
"description": "Cancelled to, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"status": {
"description": "Booking status filter, as the API documents it.",
"type": "string",
"maxLength": 64
},
"sort": {
"description": "Sort order, as the API documents it.",
"type": "string",
"maxLength": 64
},
"expand": {
"description": "Related data to include, as the API documents it.",
"type": "string",
"maxLength": 200
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_get_booking(booking_id, expand)
Fetch one booking by UUID. GET /bookings/bookings/{uuid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"booking_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Booking ID (UUID)."
},
"expand": {
"description": "Related data to include, as the API documents it.",
"type": "string",
"maxLength": 200
}
},
"required": [
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_get_reservation(reservation_id)
Fetch one reservation (a room stay inside a booking) by UUID. GET /bookings/reservations/{uuid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"reservation_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Reservation ID (UUID)."
}
},
"required": [
"reservation_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_list_booking_payments(booking_id, cursor, limit)
List the payments recorded against one booking. GET /bookings/bookings/{uuid}/payments.
Eingabe-Schema
{
"type": "object",
"properties": {
"booking_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Booking ID (UUID)."
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_list_booking_charges(booking_id, cursor, limit)
List the charges on one booking. GET /bookings/bookings/{uuid}/charges.
Eingabe-Schema
{
"type": "object",
"properties": {
"booking_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Booking ID (UUID)."
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_list_invoices(property_id, created_from, created_to, booking_reference, number, ...)
List invoices for one property, filtered by created date or by booking reference or number. GET /finance/invoices.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Property ID (UUID)."
},
"created_from": {
"description": "Created from, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"created_to": {
"description": "Created to, as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"booking_reference": {
"description": "Booking reference.",
"type": "string",
"maxLength": 100
},
"number": {
"description": "Invoice number.",
"type": "string",
"maxLength": 100
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_get_invoice(invoice_id)
Fetch one invoice by UUID. GET /finance/invoices/{uuid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Invoice ID (UUID)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_list_rate_plans(property_id, locale, cursor, limit)
List the rate plans of one property: the sellable price products. GET /rates/rate-plans.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Property ID (UUID)."
},
"locale": {
"description": "Language code for hotel-authored text, e.g. en or fr.",
"type": "string",
"maxLength": 16
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢amenitiz_get_availability(property_id, from, to, unit_group_ids, cursor, ...)
List how many units are open to sell, per unit group and date, over a date window. GET /ari/availability.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Property ID (UUID)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First date of the window, as YYYY-MM-DD."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last date of the window, as YYYY-MM-DD."
},
"unit_group_ids": {
"description": "Comma-separated unit group UUIDs to limit the reply.",
"type": "string",
"maxLength": 2000
},
"cursor": {
"description": "Cursor from the previous reply's pagination.nextCursor.",
"type": "string",
"maxLength": 512
},
"limit": {
"description": "Items per page, 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"property_id",
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis