Hostaway MCP by usefulapi

Manage Hostaway listings, reservations, calendar, guest messages, reviews and tasks.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
99%
Vollständigkeit des Schemas
93%
Qualität der Benennung
79%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'hostaway_list_conversation_messages' name length outside 3-30 rangein hostaway_list_conversation_messages

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~7,466Tokens (Tool-Definitionen)
~3.3 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (5.83% von 128k Kontext)

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": {
    "hostaway": {
      "url": "https://hostaway.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://hostaway.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (20)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢hostaway_list_listings(match, city, country, propertyTypeId, availabilityDateStart, ...)

List the account's properties (listings) with name, address, capacity, base price, fees and check-in times. Filter by name, city, country, property type, availability for a date range and guest count, or active/archived status. Hostaway: GET /v1/listings.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "match": {
      "description": "Search by listing name.",
      "type": "string"
    },
    "city": {
      "description": "City.",
      "type": "string"
    },
    "country": {
      "description": "Country.",
      "type": "string"
    },
    "propertyTypeId": {
      "description": "Property type id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "availabilityDateStart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only listings available from (YYYY-MM-DD)."
    },
    "availabilityDateEnd": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only listings available until (YYYY-MM-DD)."
    },
    "availabilityGuestNumber": {
      "description": "Only listings that fit this many guests.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "specialStatus": {
      "description": "Filter by status; omit for both active and archived.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "active",
          "archived"
        ]
      }
    },
    "sortOrder": {
      "description": "Sort order.",
      "type": "string",
      "enum": [
        "name",
        "nameReversed",
        "order",
        "orderReversed",
        "contactName",
        "contactNameReversed",
        "latestActivity",
        "latestActivityDesc"
      ]
    },
    "includeResources": {
      "description": "Include attached sub-resources (sent as includeResources=1).",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_get_listing(listingId, includeResources)

Fetch a single listing by id — full details including description, house rules, amenities, images, fees, taxes, cancellation policy and access info (door code, wifi). Hostaway: GET /v1/listings/{listingId}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "listingId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listing id."
    },
    "includeResources": {
      "description": "Include attached sub-resources (sent as includeResources=1).",
      "type": "boolean"
    }
  },
  "required": [
    "listingId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_list_reservations(listingId, channelId, assigneeUserId, match, guestEmail, ...)

List reservations across all channels (Airbnb, Vrbo, Booking.com, direct…) with guest, dates, status, price and channel. Filter by listing, channel, arrival/departure window, guest name or email, unread messages, and more. Default order is newest first; for large accounts page with afterId (the id of the last reservation on the previous page). Channel ids: 2000 direct, 2018 airbnbOfficial, 2002 homeaway/Vrbo, 2005 bookingcom, 2007 expedia, 2013 bookingengine, 2019 marriott, 2020 partner, 2022 google. Hostaway: GET /v1/reservations.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "listingId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Only reservations for this listing."
    },
    "channelId": {
      "description": "Only this channel id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "assigneeUserId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Only reservations assigned to this user."
    },
    "match": {
      "description": "Search by guest name.",
      "type": "string"
    },
    "guestEmail": {
      "description": "Filter by guest email.",
      "type": "string"
    },
    "arrivalStartDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Arrival on or after (YYYY-MM-DD)."
    },
    "arrivalEndDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Arrival on or before (YYYY-MM-DD)."
    },
    "departureStartDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Departure on or after (YYYY-MM-DD)."
    },
    "departureEndDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Departure on or before (YYYY-MM-DD)."
    },
    "dateType": {
      "description": "Which date startDate/endDate bound (only on accounts with the new reservations query; 'cancellation' also restricts to cancelled).",
      "type": "string",
      "enum": [
        "arrival",
        "departure",
        "creation",
        "cancellation"
      ]
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Lower bound for dateType (YYYY-MM-DD)."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Upper bound for dateType (YYYY-MM-DD)."
    },
    "latestActivityStart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Latest activity on or after (YYYY-MM-DD)."
    },
    "latestActivityEnd": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Latest activity on or before (YYYY-MM-DD)."
    },
    "hasUnreadConversationMessages": {
      "description": "Only reservations with unread guest messages.",
      "type": "boolean"
    },
    "isStarred": {
      "description": "Only starred.",
      "type": "boolean"
    },
    "isArchived": {
      "description": "Archived or not.",
      "type": "boolean"
    },
    "sortOrder": {
      "description": "Sort order.",
      "type": "string",
      "enum": [
        "arrivalDate",
        "arrivalDateDesc",
        "lastConversationMessageSent",
        "lastConversationMessageSentDesc",
        "lastConversationMessageReceived",
        "lastConversationMessageReceivedDesc",
        "latestActivity",
        "latestActivityDesc",
        "updatedOn"
      ]
    },
    "includeResources": {
      "description": "Include attached sub-resources (sent as includeResources=1).",
      "type": "boolean"
    },
    "includeCancellationPolicy": {
      "description": "Attach the cancellation-policy snapshot to each reservation.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "afterId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Cursor: the id of the last reservation from the previous page (offset is then ignored)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_get_reservation(reservationId)

Fetch a single reservation by its Hostaway id — guest contact details, dates, guest counts, price breakdown, payment state, door code, notes, channel and cancellation policy. Hostaway: GET /v1/reservations/{reservationId}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Hostaway reservation id."
    }
  },
  "required": [
    "reservationId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_get_reservation_logs(reservationId, limit, offset)

The audit trail for one reservation: every field change with previous and new value, when, and by which user (most recent first). Useful for 'who changed these dates / this price?'. Hostaway: GET /v1/reservations/{reservationId}/logs.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Hostaway reservation id."
    },
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "reservationId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_get_calendar(listingId, startDate, endDate, includeResources)

Day-by-day availability and pricing for one listing over a date range: status (available, blocked, reserved, pending), nightly price, min/max stay, closed-to-arrival/departure and notes. Set includeResources to see the reservations occupying each day. Hostaway: GET /v1/listings/{listingId}/calendar.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "listingId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listing id."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day (YYYY-MM-DD)."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day (YYYY-MM-DD)."
    },
    "includeResources": {
      "description": "Include attached sub-resources (sent as includeResources=1).",
      "type": "boolean"
    }
  },
  "required": [
    "listingId",
    "startDate",
    "endDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_calculate_price(listingId, startingDate, endingDate, numberOfGuests, reservationCouponId, ...)

Calculate what a stay at a listing would cost — total price plus the component breakdown (base rate, cleaning fee, taxes, discounts). A calculation only: nothing is booked or held. Hostaway: POST /v1/listings/{listingId}/calendar/priceDetails (version 2).

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "listingId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listing id."
    },
    "startingDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Arrival date (YYYY-MM-DD)."
    },
    "endingDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Departure date (YYYY-MM-DD)."
    },
    "numberOfGuests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Number of guests."
    },
    "reservationCouponId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Reservation coupon id to apply."
    },
    "markup": {
      "description": "Price markup multiplier (must be more than 1.0).",
      "type": "number",
      "minimum": 1
    }
  },
  "required": [
    "listingId",
    "startingDate",
    "endingDate",
    "numberOfGuests"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_list_conversations(reservationId, includeResources, limit, offset)

List guest conversations (the unified inbox across channels), each with its latest message and linked reservation. Filter to one reservation. Hostaway: GET /v1/conversations.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Only conversations for this reservation."
    },
    "includeResources": {
      "description": "Include attached sub-resources (sent as includeResources=1).",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_list_conversation_messages(conversationId, includeScheduledMessages, limit, offset)

The messages in one guest conversation — body, direction (isIncoming), channel/email/SMS type, send status and timestamps. By default only sent messages; set includeScheduledMessages to also see scheduled, paused or failed ones. Hostaway: GET /v1/conversations/{conversationId}/messages.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Conversation id."
    },
    "includeScheduledMessages": {
      "description": "Also return scheduled / failed / paused messages.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "conversationId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_list_reviews(listingMapIds, reservationId, type, statuses, guestName, ...)

List guest-to-host and host-to-guest reviews with rating (0-10), public review, private feedback and the host's reply. Filter by listings, reservation, type, status, rating range, dates, guest name, or whether the host has replied. Hostaway: GET /v1/reviews.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "listingMapIds": {
      "description": "Only reviews for these listing ids.",
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Hostaway reservation id."
    },
    "type": {
      "description": "Review direction.",
      "type": "string",
      "enum": [
        "guest-to-host",
        "host-to-guest"
      ]
    },
    "statuses": {
      "description": "Review statuses.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "awaiting",
          "pending",
          "scheduled",
          "submitted",
          "published",
          "expired"
        ]
      }
    },
    "guestName": {
      "description": "Partial, case-insensitive guest-name match.",
      "type": "string"
    },
    "ratingMin": {
      "description": "Minimum rating (0-10).",
      "type": "number",
      "minimum": 0,
      "maximum": 10
    },
    "ratingMax": {
      "description": "Maximum rating (0-10).",
      "type": "number",
      "minimum": 0,
      "maximum": 10
    },
    "hasHostReply": {
      "description": "true = only replied-to reviews; false = only unanswered.",
      "type": "boolean"
    },
    "submittedAtStart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Submitted on or after (YYYY-MM-DD)."
    },
    "submittedAtEnd": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Submitted on or before (YYYY-MM-DD)."
    },
    "departureDateStart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Reservation departure on or after (YYYY-MM-DD)."
    },
    "departureDateEnd": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Reservation departure on or before (YYYY-MM-DD)."
    },
    "sortBy": {
      "description": "Sort field.",
      "type": "string",
      "enum": [
        "id",
        "rating",
        "submittedAt",
        "arrivalDate",
        "departureDate",
        "guestName",
        "listingMapId",
        "status"
      ]
    },
    "sortOrder": {
      "description": "Sort direction (default desc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_list_tasks(reservationId, status, match, channelId, canStartFromStart, ...)

List operational tasks (cleaning, maintenance, check-in/out) with assignee, status, time window and cost. Filter by reservation, status, text match, channel, or start/deadline windows. Hostaway: GET /v1/tasks.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Only tasks for this reservation."
    },
    "status": {
      "description": "Task status.",
      "type": "string",
      "enum": [
        "pending",
        "confirmed",
        "inProgress",
        "completed",
        "cancelled"
      ]
    },
    "match": {
      "description": "Text search.",
      "type": "string"
    },
    "channelId": {
      "description": "Channel id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "canStartFromStart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start window from (YYYY-MM-DD)."
    },
    "canStartFromEnd": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start window until (YYYY-MM-DD)."
    },
    "shouldEndByStart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Deadline from (YYYY-MM-DD)."
    },
    "shouldEndByEnd": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Deadline until (YYYY-MM-DD)."
    },
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_list_expenses(limit, offset)

List expenses (negative amounts) and extras (positive amounts) recorded against listings and reservations, with date, concept, categories and the owner statements they appear on. Hostaway: GET /v1/expenses.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Maximum records to return (1-500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Records to skip from the start.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_list_owner_statements

List the account's owner statements (id and name). Hostaway: GET /v1/ownerStatements.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢hostaway_get_owner_statement(ownerStatementId)

Fetch one owner statement — the filter it was generated with (listings, date range), summary and per-reservation financial data, grand totals, expenses, and owner / property-manager details. Hostaway: GET /v1/ownerStatement/{ownerStatementId}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "ownerStatementId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Owner statement id."
    }
  },
  "required": [
    "ownerStatementId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴hostaway_create_reservation(listingMapId, arrivalDate, departureDate, channelId, totalPrice, ...)

Create a new reservation on a listing (it blocks the calendar and syncs to connected channels). Only channelId 2000 (direct, the default), 2002 (homeaway) or 2020 (partner) are accepted. To price it correctly, call hostaway_calculate_price first and pass its total as totalPrice. Overbooking protection is always left on. Hostaway: POST /v1/reservations.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "listingMapId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listing id to book."
    },
    "arrivalDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Arrival date (YYYY-MM-DD)."
    },
    "departureDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Departure date (YYYY-MM-DD)."
    },
    "channelId": {
      "description": "2000 direct (default), 2002 homeaway, 2020 partner.",
      "anyOf": [
        {
          "type": "number",
          "const": 2000
        },
        {
          "type": "number",
          "const": 2002
        },
        {
          "type": "number",
          "const": 2020
        }
      ]
    },
    "totalPrice": {
      "description": "Total price of the stay.",
      "type": "number",
      "minimum": 0
    },
    "currency": {
      "description": "Currency code, e.g. USD.",
      "type": "string"
    },
    "guestName": {
      "description": "Guest full name.",
      "type": "string"
    },
    "guestFirstName": {
      "description": "Guest first name.",
      "type": "string"
    },
    "guestLastName": {
      "description": "Guest last name.",
      "type": "string"
    },
    "guestEmail": {
      "description": "Guest email.",
      "type": "string"
    },
    "phone": {
      "description": "Guest phone, e.g. +15125551212.",
      "type": "string"
    },
    "guestAddress": {
      "description": "Guest street address.",
      "type": "string"
    },
    "guestCity": {
      "description": "Guest city.",
      "type": "string"
    },
    "guestZipCode": {
      "description": "Guest ZIP / postal code.",
      "type": "string"
    },
    "guestCountry": {
      "description": "Guest country (ISO 3166 code, e.g. US).",
      "type": "string"
    },
    "numberOfGuests": {
      "description": "Total number of guests.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "adults": {
      "description": "Adults.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "children": {
      "description": "Children.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "infants": {
      "description": "Infants.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pets": {
      "description": "Pets.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "checkInTime": {
      "description": "Check-in time (hour of day, 0-23).",
      "type": "integer",
      "minimum": 0,
      "maximum": 23
    },
    "checkOutTime": {
      "description": "Check-out time (hour of day, 0-23).",
      "type": "integer",
      "minimum": 0,
      "maximum": 23
    },
    "hostNote": {
      "description": "Internal host note (not shown to the guest).",
      "type": "string"
    },
    "guestNote": {
      "description": "Note from the guest.",
      "type": "string"
    },
    "doorCode": {
      "description": "Door / lock code for this stay.",
      "type": "string"
    },
    "doorCodeVendor": {
      "description": "Lock vendor.",
      "type": "string"
    },
    "doorCodeInstruction": {
      "description": "Door-code instructions.",
      "type": "string"
    },
    "comment": {
      "description": "Free-text comment.",
      "type": "string"
    }
  },
  "required": [
    "listingMapId",
    "arrivalDate",
    "departureDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴hostaway_update_reservation(reservationId, arrivalDate, departureDate, guestName, guestFirstName, ...)

Change fields on an existing reservation — guest details and counts, dates, check-in/out hours, door code, host note or comment. Send only the fields to change. The listing cannot be changed, and this tool never cancels or reprices a booking. Date changes on channel bookings may be overwritten by the channel. Hostaway: PUT /v1/reservations/{reservationId}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Hostaway reservation id."
    },
    "arrivalDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "New arrival date (YYYY-MM-DD)."
    },
    "departureDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "New departure date (YYYY-MM-DD)."
    },
    "guestName": {
      "description": "Guest full name.",
      "type": "string"
    },
    "guestFirstName": {
      "description": "Guest first name.",
      "type": "string"
    },
    "guestLastName": {
      "description": "Guest last name.",
      "type": "string"
    },
    "guestEmail": {
      "description": "Guest email.",
      "type": "string"
    },
    "phone": {
      "description": "Guest phone, e.g. +15125551212.",
      "type": "string"
    },
    "guestAddress": {
      "description": "Guest street address.",
      "type": "string"
    },
    "guestCity": {
      "description": "Guest city.",
      "type": "string"
    },
    "guestZipCode": {
      "description": "Guest ZIP / postal code.",
      "type": "string"
    },
    "guestCountry": {
      "description": "Guest country (ISO 3166 code, e.g. US).",
      "type": "string"
    },
    "numberOfGuests": {
      "description": "Total number of guests.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "adults": {
      "description": "Adults.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "children": {
      "description": "Children.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "infants": {
      "description": "Infants.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pets": {
      "description": "Pets.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "checkInTime": {
      "description": "Check-in time (hour of day, 0-23).",
      "type": "integer",
      "minimum": 0,
      "maximum": 23
    },
    "checkOutTime": {
      "description": "Check-out time (hour of day, 0-23).",
      "type": "integer",
      "minimum": 0,
      "maximum": 23
    },
    "hostNote": {
      "description": "Internal host note (not shown to the guest).",
      "type": "string"
    },
    "guestNote": {
      "description": "Note from the guest.",
      "type": "string"
    },
    "doorCode": {
      "description": "Door / lock code for this stay.",
      "type": "string"
    },
    "doorCodeVendor": {
      "description": "Lock vendor.",
      "type": "string"
    },
    "doorCodeInstruction": {
      "description": "Door-code instructions.",
      "type": "string"
    },
    "comment": {
      "description": "Free-text comment.",
      "type": "string"
    }
  },
  "required": [
    "reservationId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴hostaway_update_calendar(listingId, startDate, endDate, isAvailable, desiredUnitsToSell, ...)

Change availability and/or pricing for a date range on one listing, pushed to every connected channel: block (isAvailable=false) or open days, set the nightly price, min/max stay, closed-to-arrival/departure, or a note. For multi-unit listings set desiredUnitsToSell instead of isAvailable (0 blocks). Hostaway: PUT /v1/listings/{listingId}/calendar.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "listingId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listing id."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day to change (YYYY-MM-DD)."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day to change (YYYY-MM-DD)."
    },
    "isAvailable": {
      "description": "false blocks the days, true opens them (single-unit listings).",
      "type": "boolean"
    },
    "desiredUnitsToSell": {
      "description": "Multi-unit listings: units to sell (0 blocks).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "price": {
      "description": "Nightly price.",
      "type": "number",
      "minimum": 0
    },
    "minimumStay": {
      "description": "Minimum nights.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "maximumStay": {
      "description": "Maximum nights.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "closedOnArrival": {
      "description": "Closed to arrival.",
      "type": "boolean"
    },
    "closedOnDeparture": {
      "description": "Closed to departure.",
      "type": "boolean"
    },
    "note": {
      "description": "Calendar note.",
      "type": "string"
    }
  },
  "required": [
    "listingId",
    "startDate",
    "endDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴hostaway_send_message(conversationId, body, communicationType)

Send a message to the guest in a conversation — it is delivered immediately and cannot be recalled. Delivered by email by default, or via the booking channel, SMS or WhatsApp. Attachments are not supported. Rate-limited by Hostaway to 30 messages per minute. Hostaway: POST /v1/conversations/{conversationId}/messages.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Conversation id (see hostaway_list_conversations)."
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "description": "Message text."
    },
    "communicationType": {
      "description": "Delivery method (Hostaway default: email).",
      "type": "string",
      "enum": [
        "email",
        "channel",
        "sms",
        "whatsapp"
      ]
    }
  },
  "required": [
    "conversationId",
    "body"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴hostaway_create_task(title, description, listingMapId, reservationId, assigneeUserId, ...)

Create an operational task — e.g. a cleaning after a checkout or a maintenance job — optionally tied to a listing and reservation, assigned to a user, with a time window, category and cost. Hostaway: POST /v1/tasks.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Task title."
    },
    "description": {
      "description": "Task description.",
      "type": "string"
    },
    "listingMapId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listing id the task belongs to."
    },
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Reservation id the task relates to."
    },
    "assigneeUserId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "User id to assign the task to."
    },
    "supervisorUserId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Supervisor user id."
    },
    "canStartFrom": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
      "description": "Earliest start time (\"YYYY-MM-DD HH:MM:SS\", UTC)."
    },
    "shouldEndBy": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
      "description": "Deadline (\"YYYY-MM-DD HH:MM:SS\", UTC)."
    },
    "status": {
      "description": "pending, confirmed, inProgress, completed or cancelled.",
      "type": "string",
      "enum": [
        "pending",
        "confirmed",
        "inProgress",
        "completed",
        "cancelled"
      ]
    },
    "priority": {
      "description": "Priority.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "categoriesMap": {
      "description": "Categories: 1 cleaning, 2 maintenance, 3 check-in, 4 check-out, 5 back office, 6 other.",
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 6
      }
    },
    "cost": {
      "description": "Task cost.",
      "type": "number"
    },
    "costCurrency": {
      "description": "Cost currency, e.g. USD.",
      "type": "string"
    },
    "costDescription": {
      "description": "Cost description.",
      "type": "string"
    },
    "color": {
      "description": "Colour in hex, e.g. #FF8800.",
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$"
    }
  },
  "required": [
    "title"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴hostaway_update_task(taskId, title, resolutionNote, description, listingMapId, ...)

Update a task — change its status (e.g. completed), reassign it, move its window, or add a resolution note. Send only the fields to change. Hostaway: PUT /v1/tasks/{taskId}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "taskId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Task id."
    },
    "title": {
      "description": "Task title.",
      "type": "string",
      "minLength": 1
    },
    "resolutionNote": {
      "description": "Resolution note.",
      "type": "string"
    },
    "description": {
      "description": "Task description.",
      "type": "string"
    },
    "listingMapId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Listing id the task belongs to."
    },
    "reservationId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Reservation id the task relates to."
    },
    "assigneeUserId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "User id to assign the task to."
    },
    "supervisorUserId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Supervisor user id."
    },
    "canStartFrom": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
      "description": "Earliest start time (\"YYYY-MM-DD HH:MM:SS\", UTC)."
    },
    "shouldEndBy": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
      "description": "Deadline (\"YYYY-MM-DD HH:MM:SS\", UTC)."
    },
    "status": {
      "description": "pending, confirmed, inProgress, completed or cancelled.",
      "type": "string",
      "enum": [
        "pending",
        "confirmed",
        "inProgress",
        "completed",
        "cancelled"
      ]
    },
    "priority": {
      "description": "Priority.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "categoriesMap": {
      "description": "Categories: 1 cleaning, 2 maintenance, 3 check-in, 4 check-out, 5 back office, 6 other.",
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 6
      }
    },
    "cost": {
      "description": "Task cost.",
      "type": "number"
    },
    "costCurrency": {
      "description": "Cost currency, e.g. USD.",
      "type": "string"
    },
    "costDescription": {
      "description": "Cost description.",
      "type": "string"
    },
    "color": {
      "description": "Colour in hex, e.g. #FF8800.",
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$"
    }
  },
  "required": [
    "taskId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet20 Tools
verifiziertVersion nicht aufgezeichnet20 Tools
verifiziertVersion nicht aufgezeichnet20 Tools
verifiziertVersion nicht aufgezeichnet20 Tools