Hostfully MCP by usefulapi
Check properties, calendars, leads, quotes, guests and messages in Hostfully, and send replies.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin hostfully_get_property_calendar
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": {
"hostfully": {
"url": "https://hostfully.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://hostfully.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (20)
🟢hostfully_list_agencies
List the agencies this API key can access, with their UIDs, currency and default check-in/out times. Start here to find the agency_uid other tools need. Hostfully: GET /api/v3.3/agencies.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_properties(agency_uid, updated_since, limit, cursor)
List an agency's properties (rentals) with name, address, type, bedrooms, active flag and pricing/availability settings. Cursor-paginated. Hostfully: GET /api/v3.3/properties.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"updated_since": {
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_get_property(property_uid)
Fetch one property's full details — address, time zone, rooms, pricing and availability settings, channel data, booking notes and cancellation policy. Hostfully: GET /api/v3.3/properties/{propertyUid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_uid": {
"type": "string",
"description": "The property's UID."
}
},
"required": [
"property_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_get_property_calendar(property_uid, from, to, availability_comments)
Day-by-day availability and pricing for one property over a date range — the direct answer to 'is it free, and at what price?'. Hostfully: GET /api/v3.3/property-calendar/{propertyUid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_uid": {
"type": "string",
"description": "The property's UID."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day (YYYY-MM-DD)."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day (YYYY-MM-DD)."
},
"availability_comments": {
"description": "Include availability comments.",
"type": "boolean"
}
},
"required": [
"property_uid",
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_get_pricing_periods(property_uid, from, to)
The nightly price, minimum stay and check-in/check-out availability set for each date of one property over a range. Hostfully: GET /api/v3.3/pricing-periods.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_uid": {
"type": "string",
"description": "The property's UID."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day (YYYY-MM-DD)."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day (YYYY-MM-DD)."
}
},
"required": [
"property_uid",
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_search_leads(agency_uid, property_uid, lead_uids, check_in_from, check_in_to, ...)
Search leads — Hostfully's word for bookings, inquiries, booking requests and calendar blocks — by agency, property or UIDs, and by check-in/check-out date. Returns status, type, channel, dates and guest info. Give at least one of agency_uid (or the default), property_uid, or lead_uids. Cursor-paginated. Hostfully: GET /api/v3.3/leads.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"property_uid": {
"description": "Only leads for this property.",
"type": "string"
},
"lead_uids": {
"description": "Only these lead UIDs.",
"type": "array",
"items": {
"type": "string"
}
},
"check_in_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-in on or after (YYYY-MM-DD)."
},
"check_in_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-in on or before (YYYY-MM-DD)."
},
"check_out_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out on or after (YYYY-MM-DD)."
},
"check_out_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out on or before (YYYY-MM-DD)."
},
"updated_since": {
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_get_lead(lead_uid)
Fetch one lead (booking, inquiry, booking request or block) by UID — status, channel, dates, guest information, notes and assignee. Hostfully: GET /api/v3.3/leads/{leadUid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"lead_uid": {
"type": "string",
"description": "The lead's UID."
}
},
"required": [
"lead_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_calculate_quote(agency_uid, property_uid, check_in_date, check_out_date, guests, ...)
Price a prospective stay at one property: rent, fees, taxes, security deposit and total for the given dates and party. Computes only — creates nothing. Hostfully: POST /api/v3.3/quotes.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"property_uid": {
"type": "string",
"description": "The property's UID."
},
"check_in_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-in date (YYYY-MM-DD)."
},
"check_out_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out date (YYYY-MM-DD)."
},
"guests": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "Number of guests."
},
"children_count": {
"description": "Children among the guests.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"pet_count": {
"description": "Number of pets.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"lead_uid": {
"description": "Quote in the context of an existing lead.",
"type": "string"
}
},
"required": [
"property_uid",
"check_in_date",
"check_out_date",
"guests"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_orders(lead_uid, property_uid, guest_uid, updated_since)
List orders — the money side of a booking: rent, fees, services, adjustments, taxes, channel commission and total. Filter by lead, property, guest or update time (at least one is required). Hostfully: GET /api/v3.3/orders.
Eingabe-Schema
{
"type": "object",
"properties": {
"lead_uid": {
"description": "Only the order of this lead.",
"type": "string"
},
"property_uid": {
"description": "Only orders for this property.",
"type": "string"
},
"guest_uid": {
"description": "Only orders of this guest.",
"type": "string"
},
"updated_since": {
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_threads(agency_uid, lead_uid, limit, cursor)
List guest-messaging threads for an agency or one lead, with participants and read status. Give lead_uid, or agency_uid (or the default). Cursor-paginated. Hostfully: GET /api/v3.3/threads.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"lead_uid": {
"type": "string"
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_messages(agency_uid, thread_uid, lead_uid, created_at, limit, ...)
Read guest messages (Airbnb, VRBO, Booking.com, email, SMS, WhatsApp, in-app) for a lead, a thread or a whole agency, with sender type, status and content. Give lead_uid, thread_uid, or agency_uid (or the default). Cursor-paginated. Hostfully: GET /api/v3.3/messages.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"thread_uid": {
"description": "Only messages in this thread.",
"type": "string"
},
"lead_uid": {
"description": "Only messages about this lead.",
"type": "string"
},
"created_at": {
"description": "Creation-date filter, ISO date-time, e.g. 2026-04-20T11:52:36Z.",
"type": "string"
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_guests(agency_uid)
List the agency's guest records — names, email, phone, address and profile notes. Hostfully: GET /api/v3.3/guests/{agencyUid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_jobs(from, to, property_uids, statuses, modified_since)
List operational jobs (cleanings, greetings, maintenance and other services) scheduled in a date window, optionally for given properties and statuses, sorted by start date. Hostfully: GET /api/v3.3/jobs.
Eingabe-Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Window start (YYYY-MM-DD)."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Window end (YYYY-MM-DD)."
},
"property_uids": {
"description": "Only jobs at these properties.",
"type": "array",
"items": {
"type": "string"
}
},
"statuses": {
"description": "Only jobs in these statuses.",
"type": "array",
"items": {
"type": "string",
"enum": [
"NEW",
"SCHEDULED",
"DONE",
"CANCELLED"
]
}
},
"modified_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only jobs modified on or after this date; Hostfully requires it, default 2000-01-01 (YYYY-MM-DD)."
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_services(agency_uid, service_provider_uid, catered_to)
List the services an agency offers or schedules (cleaning, transportation, greeting, cooking, tours ...), with provider, price and duration. A service UID is what hostfully_create_job needs. Hostfully: GET /api/v3.3/services.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"service_provider_uid": {
"description": "Only services of this provider.",
"type": "string"
},
"catered_to": {
"description": "Who the service is for.",
"type": "string",
"enum": [
"GUEST",
"HOST",
"BOTH"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_reviews(property_uid, lead_uid, source, sort, sort_direction, ...)
List guest reviews for a property or a lead — rating, title, content, source, private feedback and the host response. Cursor-paginated. Hostfully: GET /api/v3.3/reviews.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_uid": {
"description": "Reviews of this property.",
"type": "string"
},
"lead_uid": {
"description": "Reviews tied to this lead.",
"type": "string"
},
"source": {
"type": "string",
"enum": [
"BOOKING_DOT_COM",
"VRBO",
"FACEBOOK",
"TRIPADVISOR",
"REVYOOS",
"HOSTFULLY"
]
},
"sort": {
"type": "string",
"enum": [
"SORT_BY_RATING",
"SORT_BY_DATE",
"SORT_BY_AUTHOR"
]
},
"sort_direction": {
"type": "string",
"enum": [
"ASC",
"DESC"
]
},
"updated_since": {
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hostfully_list_owners(agency_uid, query)
List the agency's property owners — contact details, business name, commission rate and permissions — optionally filtered by a search string. Hostfully: GET /api/v3.3/owners.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"query": {
"description": "Free-text search over owners.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hostfully_create_lead(agency_uid, property_uid, status, check_in, check_out, ...)
Create a lead at one property: status BLOCKED puts an owner/maintenance block on the calendar; status NEW records a guest inquiry (which does not confirm a booking or take payment). Blocks can later be removed in Hostfully; inquiries go through the normal pipeline. Dates are local to the property. Hostfully: POST /api/v3.3/leads.
Eingabe-Schema
{
"type": "object",
"properties": {
"agency_uid": {
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options.",
"type": "string"
},
"property_uid": {
"type": "string",
"description": "The property's UID."
},
"status": {
"type": "string",
"enum": [
"BLOCKED",
"NEW"
],
"description": "BLOCKED = calendar block, NEW = inquiry."
},
"check_in": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Check-in, property-local, YYYY-MM-DDTHH:MM:SS."
},
"check_out": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Check-out, property-local, YYYY-MM-DDTHH:MM:SS."
},
"guest": {
"description": "Guest information — needed for an inquiry, usually omitted for a block.",
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"email": {
"type": "string",
"description": "Guest email (Hostfully requires it when guest info is given)."
},
"secondaryEmail": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"cellPhoneNumber": {
"type": "string"
},
"address1": {
"type": "string"
},
"address2": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"countryCode": {
"description": "Two-letter country code, e.g. US.",
"type": "string"
},
"flightNumber": {
"type": "string"
},
"reasonForTrip": {
"type": "string"
},
"arrivalLocalDateTime": {
"description": "Expected arrival, YYYY-MM-DDTHH:MM:SS.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
},
"departureLocalDateTime": {
"description": "Expected departure, YYYY-MM-DDTHH:MM:SS.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
},
"adultCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"childrenCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"infantCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"petCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"email"
]
},
"notes": {
"description": "Notes on the lead.",
"type": "string"
},
"external_booking_id": {
"description": "Your own reference for this lead.",
"type": "string"
}
},
"required": [
"property_uid",
"status",
"check_in",
"check_out"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hostfully_update_lead(lead_uid, notes, extra_notes, guest)
Partially update a lead's notes, extra notes and guest details (name, contact, address, arrival/departure times). Does NOT change dates, party size, property or status. Hostfully may ignore personal-data fields the key is not allowed to edit. Hostfully: PATCH /api/v3.3/leads/{leadUid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"lead_uid": {
"type": "string",
"description": "The lead's UID."
},
"notes": {
"type": "string"
},
"extra_notes": {
"type": "string"
},
"guest": {
"description": "Guest fields to change; omitted fields are kept.",
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"email": {
"type": "string"
},
"secondaryEmail": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"cellPhoneNumber": {
"type": "string"
},
"address1": {
"type": "string"
},
"address2": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"countryCode": {
"description": "Two-letter country code, e.g. US.",
"type": "string"
},
"flightNumber": {
"type": "string"
},
"reasonForTrip": {
"type": "string"
},
"arrivalLocalDateTime": {
"description": "Expected arrival, YYYY-MM-DDTHH:MM:SS.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
},
"departureLocalDateTime": {
"description": "Expected departure, YYYY-MM-DDTHH:MM:SS.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$"
}
}
}
},
"required": [
"lead_uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hostfully_send_message(lead_uid, type, text, subject, thread_uid)
Send a message to the guest of a lead, by EMAIL or as a DIRECT_MESSAGE on the booking channel (Airbnb, VRBO or Booking.com leads only). This reaches a real guest and cannot be unsent — confirm the text first. Hostfully: POST /api/v3.3/messages.
Eingabe-Schema
{
"type": "object",
"properties": {
"lead_uid": {
"type": "string",
"description": "The lead whose guest receives the message."
},
"type": {
"type": "string",
"enum": [
"EMAIL",
"DIRECT_MESSAGE"
],
"description": "EMAIL, or DIRECT_MESSAGE via the channel."
},
"text": {
"type": "string",
"minLength": 1,
"description": "The message body."
},
"subject": {
"description": "Subject line (email).",
"type": "string"
},
"thread_uid": {
"description": "Post into this existing thread.",
"type": "string"
}
},
"required": [
"lead_uid",
"type",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hostfully_create_job(property_uid, service_uid, start, end, status, ...)
Schedule a job (e.g. a cleaning or a guest greeting) for a service at a property, optionally tied to a lead. Times are property-local. hostfully_list_services gives the service UID. Hostfully: POST /api/v3.3/jobs.
Eingabe-Schema
{
"type": "object",
"properties": {
"property_uid": {
"type": "string",
"description": "The property's UID."
},
"service_uid": {
"type": "string",
"description": "The service's UID."
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Start, YYYY-MM-DDTHH:MM:SS."
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "End, YYYY-MM-DDTHH:MM:SS."
},
"status": {
"description": "Initial status; default NEW.",
"type": "string",
"enum": [
"NEW",
"SCHEDULED"
]
},
"lead_uid": {
"description": "The booking this job serves.",
"type": "string"
},
"notes": {
"type": "string"
}
},
"required": [
"property_uid",
"service_uid",
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis