Hostfully MCP by usefulapi is an MCP server published by io.usefulapi, hosted at hostfully.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 20 tools, including hostfully_list_agencies, hostfully_list_properties, hostfully_get_property, hostfully_get_property_calendar, hostfully_get_pricing_periods.
Check properties, calendars, leads, quotes, guests and messages in Hostfully, and send replies.
4,010 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "hostfully_list_agencies",
"title": "List agencies",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List agencies",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size, 1-100. |
| cursor | string | Cursor from the previous page's _paging._nextCursor. Omit for the first page. |
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
| updated_since | string | Only records updated since this UTC time, e.g. 2026-04-20T11:52:36. |
{
"name": "hostfully_list_properties",
"title": "List properties",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, 1-100."
},
"cursor": {
"type": "string",
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page."
},
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36."
}
}
},
"annotations": {
"title": "List properties",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| property_uid * | string | The property's UID. |
{
"name": "hostfully_get_property",
"title": "Get one property",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_uid"
],
"properties": {
"property_uid": {
"type": "string",
"description": "The property's UID."
}
}
},
"annotations": {
"title": "Get one property",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Last day (YYYY-MM-DD). |
| from * | string | First day (YYYY-MM-DD). |
| property_uid * | string | The property's UID. |
| availability_comments | boolean | Include availability comments. |
{
"name": "hostfully_get_property_calendar",
"title": "Get a property's calendar",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_uid",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day (YYYY-MM-DD)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day (YYYY-MM-DD)."
},
"property_uid": {
"type": "string",
"description": "The property's UID."
},
"availability_comments": {
"type": "boolean",
"description": "Include availability comments."
}
}
},
"annotations": {
"title": "Get a property's calendar",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Last day (YYYY-MM-DD). |
| from * | string | First day (YYYY-MM-DD). |
| property_uid * | string | The property's UID. |
{
"name": "hostfully_get_pricing_periods",
"title": "Get pricing periods",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_uid",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day (YYYY-MM-DD)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day (YYYY-MM-DD)."
},
"property_uid": {
"type": "string",
"description": "The property's UID."
}
}
},
"annotations": {
"title": "Get pricing periods",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size, 1-100. |
| cursor | string | Cursor from the previous page's _paging._nextCursor. Omit for the first page. |
| lead_uids | array | Only these lead UIDs. |
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
| check_in_to | string | Check-in on or before (YYYY-MM-DD). |
| check_out_to | string | Check-out on or before (YYYY-MM-DD). |
| property_uid | string | Only leads for this property. |
| check_in_from | string | Check-in on or after (YYYY-MM-DD). |
| updated_since | string | Only records updated since this UTC time, e.g. 2026-04-20T11:52:36. |
| check_out_from |
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}.
| Parameter | Type | Description |
|---|---|---|
| lead_uid * | string | The lead's UID. |
{
"name": "hostfully_get_lead",
"title": "Get one lead or booking",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lead_uid"
],
"properties": {
"lead_uid": {
"type": "string",
"description": "The lead's UID."
}
}
},
"annotations": {
"title": "Get one lead or booking",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| guests * | integer | Number of guests. |
| lead_uid | string | Quote in the context of an existing lead. |
| pet_count | integer | Number of pets. |
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
| property_uid * | string | The property's UID. |
| check_in_date * | string | Check-in date (YYYY-MM-DD). |
| check_out_date * | string | Check-out date (YYYY-MM-DD). |
| children_count | integer | Children among the guests. |
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.
| Parameter | Type | Description |
|---|---|---|
| lead_uid | string | Only the order of this lead. |
| guest_uid | string | Only orders of this guest. |
| property_uid | string | Only orders for this property. |
| updated_since | string | Only records updated since this UTC time, e.g. 2026-04-20T11:52:36. |
{
"name": "hostfully_list_orders",
"title": "List orders",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"lead_uid": {
"type": "string",
"description": "Only the order of this lead."
},
"guest_uid": {
"type": "string",
"description": "Only orders of this guest."
},
"property_uid": {
"type": "string",
"description": "Only orders for this property."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size, 1-100. |
| cursor | string | Cursor from the previous page's _paging._nextCursor. Omit for the first page. |
| lead_uid | string | |
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
{
"name": "hostfully_list_threads",
"title": "List message threads",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, 1-100."
},
"cursor": {
"type": "string",
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page."
},
"lead_uid": {
"type": "string"
},
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
}
}
},
"annotations": {
"title": "List message threads",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size, 1-100. |
| cursor | string | Cursor from the previous page's _paging._nextCursor. Omit for the first page. |
| lead_uid | string | Only messages about this lead. |
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
| created_at | string | Creation-date filter, ISO date-time, e.g. 2026-04-20T11:52:36Z. |
| thread_uid | string | Only messages in this thread. |
{
"name": "hostfully_list_messages",
"title": "List messages",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, 1-100."
},
"cursor": {
"type": "string",
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page."
},
"lead_uid": {
"type": "string",
"description": "Only messages about this lead."
},
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
},
"created_at": {
"type": "string",
"description": "Creation-date filter, ISO date-time, e.g. 2026-04-20T11:52:36Z."
},
"thread_uid": {
"type": "string",
"description": "Only messages in this thread."
}
}
},
"annotations": {
"title": "List messages",
"readOnlyHint": true
}
}List the agency's guest records — names, email, phone, address and profile notes. Hostfully: GET /api/v3.3/guests/{agencyUid}.
| Parameter | Type | Description |
|---|---|---|
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
{
"name": "hostfully_list_guests",
"title": "List guests",
"description": "List the agency's guest records — names, email, phone, address and profile notes. Hostfully: GET /api/v3.3/guests/{agencyUid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
}
}
},
"annotations": {
"title": "List guests",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Window end (YYYY-MM-DD). |
| from * | string | Window start (YYYY-MM-DD). |
| statuses | array | Only jobs in these statuses. |
| property_uids | array | Only jobs at these properties. |
| modified_since | string | Only jobs modified on or after this date; Hostfully requires it, default 2000-01-01 (YYYY-MM-DD). |
{
"name": "hostfully_list_jobs",
"title": "List jobs",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Window end (YYYY-MM-DD)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Window start (YYYY-MM-DD)."
},
"statuses": {
"type": "array",
"items": {
"enum": [
"NEW",
"SCHEDULED",
"DONE",
"CANCELLED"
],
"type": "string"
},
"description": "Only jobs in these statuses."
},
"property_uids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only jobs at these properties."
},
"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)."
}
}
},
"annotations": {
"title": "List jobs",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
| catered_to | string | Who the service is for. |
| service_provider_uid | string | Only services of this provider. |
{
"name": "hostfully_list_services",
"title": "List services",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
},
"catered_to": {
"enum": [
"GUEST",
"HOST",
"BOTH"
],
"type": "string",
"description": "Who the service is for."
},
"service_provider_uid": {
"type": "string",
"description": "Only services of this provider."
}
}
},
"annotations": {
"title": "List services",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| sort | string | one of ["SORT_BY_RATING","SORT_BY_DATE","SORT_BY_AUTHOR"] |
| limit | integer | Page size, 1-100. |
| cursor | string | Cursor from the previous page's _paging._nextCursor. Omit for the first page. |
| source | string | one of ["BOOKING_DOT_COM","VRBO","FACEBOOK","TRIPADVISOR","REVYOOS","HOSTFULLY"] |
| lead_uid | string | Reviews tied to this lead. |
| property_uid | string | Reviews of this property. |
| updated_since | string | Only records updated since this UTC time, e.g. 2026-04-20T11:52:36. |
| sort_direction | string | one of ["ASC","DESC"] |
{
"name": "hostfully_list_reviews",
"title": "List guest reviews",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"enum": [
"SORT_BY_RATING",
"SORT_BY_DATE",
"SORT_BY_AUTHOR"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, 1-100."
},
"cursor": {
"type": "string",
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page."
},
"source": {
"enum": [
"BOOKING_DOT_COM",
"VRBO",
"FACEBOOK",
"TRIPADVISOR",
"REVYOOS",
"HOSTFULLY"
],
"type": "string"
},
"lead_uid": {
"type": "string",
"description": "Reviews tied to this lead."
},
"property_uid": {
"type": "string",
"description": "Reviews of this property."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36."
},
"sort_direction": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"annotations": {
"title": "List guest reviews",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| query | string | Free-text search over owners. |
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
{
"name": "hostfully_list_owners",
"title": "List property owners",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"description": "Free-text search over owners."
},
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
}
}
},
"annotations": {
"title": "List property owners",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| guest | object | Guest information — needed for an inquiry, usually omitted for a block. |
| notes | string | Notes on the lead. |
| status * | string | BLOCKED = calendar block, NEW = inquiry. |
| check_in * | string | Check-in, property-local, YYYY-MM-DDTHH:MM:SS. |
| check_out * | string | Check-out, property-local, YYYY-MM-DDTHH:MM:SS. |
| agency_uid | string | Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options. |
| property_uid * | string | The property's UID. |
| external_booking_id | string | Your own reference for this lead. |
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}.
| Parameter | Type | Description |
|---|---|---|
| guest | object | Guest fields to change; omitted fields are kept. |
| notes | string | |
| lead_uid * | string | The lead's UID. |
| extra_notes | string |
{
"name": "hostfully_update_lead",
"title": "Update a lead's notes or guest details",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lead_uid"
],
"properties": {
"guest": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"email": {
"type": "string"
},
"state": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"address1": {
"type": "string"
},
"address2": {
"type": "string"
},
"lastName": {
"type": "string"
},
"firstName": {
"type": "string"
},
"countryCode": {
"type": "string",
"description": "Two-letter country code, e.g. US."
},
"phoneNumber": {
"type": "string"
},
"flightNumber": {
"type": "string"
},
"reasonForTrip": {
"type": "string"
},
"secondaryEmail": {
"type": "string"
},
"cellPhoneNumber": {
"type": "string"
},
"arrivalLocalDateTime": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Expected arrival, YYYY-MM-DDTHH:MM:SS."
},
"departureLocalDateTime": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Expected departure, YYYY-MM-DDTHH:MM:SS."
}
},
"description": "Guest fields to change; omitted fields are kept."
},
"notes": {
"type": "string"
},
"lead_uid": {
"type": "string",
"description": "The lead's UID."
},
"extra_notes": {
"type": "string"
}
}
},
"annotations": {
"title": "Update a lead's notes or guest details",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| text * | string | The message body. |
| type * | string | EMAIL, or DIRECT_MESSAGE via the channel. |
| subject | string | Subject line (email). |
| lead_uid * | string | The lead whose guest receives the message. |
| thread_uid | string | Post into this existing thread. |
{
"name": "hostfully_send_message",
"title": "Send a message to a guest",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lead_uid",
"type",
"text"
],
"properties": {
"text": {
"type": "string",
"minLength": 1,
"description": "The message body."
},
"type": {
"enum": [
"EMAIL",
"DIRECT_MESSAGE"
],
"type": "string",
"description": "EMAIL, or DIRECT_MESSAGE via the channel."
},
"subject": {
"type": "string",
"description": "Subject line (email)."
},
"lead_uid": {
"type": "string",
"description": "The lead whose guest receives the message."
},
"thread_uid": {
"type": "string",
"description": "Post into this existing thread."
}
}
},
"annotations": {
"title": "Send a message to a guest",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| end * | string | End, YYYY-MM-DDTHH:MM:SS. |
| notes | string | |
| start * | string | Start, YYYY-MM-DDTHH:MM:SS. |
| status | string | Initial status; default NEW. |
| lead_uid | string | The booking this job serves. |
| service_uid * | string | The service's UID. |
| property_uid * | string | The property's UID. |
{
"name": "hostfully_create_job",
"title": "Schedule a job",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_uid",
"service_uid",
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "End, YYYY-MM-DDTHH:MM:SS."
},
"notes": {
"type": "string"
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Start, YYYY-MM-DDTHH:MM:SS."
},
"status": {
"enum": [
"NEW",
"SCHEDULED"
],
"type": "string",
"description": "Initial status; default NEW."
},
"lead_uid": {
"type": "string",
"description": "The booking this job serves."
},
"service_uid": {
"type": "string",
"description": "The service's UID."
},
"property_uid": {
"type": "string",
"description": "The property's UID."
}
}
},
"annotations": {
"title": "Schedule a job",
"destructiveHint": true
}
}Tools for Hostfully, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which guest bookings arrive over the next two weeks?"; "What would a 4-night stay for 2 guests at my downtown loft cost starting July 10?"; "Which cleanings and other jobs are scheduled this week?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Hostfully data. Free plan: 50 tool calls per month. Run hostfully_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run hostfully_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run hostfully_upgrade without a plan: it returns both plans, each with a payment link for the user to open. hostfully_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| string |
| Check-out on or after (YYYY-MM-DD). |
{
"name": "hostfully_search_leads",
"title": "Search leads and bookings",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, 1-100."
},
"cursor": {
"type": "string",
"description": "Cursor from the previous page's _paging._nextCursor. Omit for the first page."
},
"lead_uids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only these lead UIDs."
},
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
},
"check_in_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-in on or before (YYYY-MM-DD)."
},
"check_out_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out on or before (YYYY-MM-DD)."
},
"property_uid": {
"type": "string",
"description": "Only leads for this property."
},
"check_in_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-in on or after (YYYY-MM-DD)."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Only records updated since this UTC time, e.g. 2026-04-20T11:52:36."
},
"check_out_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out on or after (YYYY-MM-DD)."
}
}
},
"annotations": {
"title": "Search leads and bookings",
"readOnlyHint": true
}
}{
"name": "hostfully_calculate_quote",
"title": "Calculate a stay quote",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_uid",
"check_in_date",
"check_out_date",
"guests"
],
"properties": {
"guests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of guests."
},
"lead_uid": {
"type": "string",
"description": "Quote in the context of an existing lead."
},
"pet_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of pets."
},
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
},
"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)."
},
"children_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Children among the guests."
}
}
},
"annotations": {
"title": "Calculate a stay quote",
"readOnlyHint": true
}
}{
"name": "hostfully_create_lead",
"title": "Create a calendar block or inquiry",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_uid",
"status",
"check_in",
"check_out"
],
"properties": {
"guest": {
"type": "object",
"required": [
"email"
],
"properties": {
"city": {
"type": "string"
},
"email": {
"type": "string",
"description": "Guest email (Hostfully requires it when guest info is given)."
},
"state": {
"type": "string"
},
"zipCode": {
"type": "string"
},
"address1": {
"type": "string"
},
"address2": {
"type": "string"
},
"lastName": {
"type": "string"
},
"petCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"firstName": {
"type": "string"
},
"adultCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"countryCode": {
"type": "string",
"description": "Two-letter country code, e.g. US."
},
"infantCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"phoneNumber": {
"type": "string"
},
"flightNumber": {
"type": "string"
},
"childrenCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"reasonForTrip": {
"type": "string"
},
"secondaryEmail": {
"type": "string"
},
"cellPhoneNumber": {
"type": "string"
},
"arrivalLocalDateTime": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Expected arrival, YYYY-MM-DDTHH:MM:SS."
},
"departureLocalDateTime": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?$",
"description": "Expected departure, YYYY-MM-DDTHH:MM:SS."
}
},
"description": "Guest information — needed for an inquiry, usually omitted for a block."
},
"notes": {
"type": "string",
"description": "Notes on the lead."
},
"status": {
"enum": [
"BLOCKED",
"NEW"
],
"type": "string",
"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."
},
"agency_uid": {
"type": "string",
"description": "Agency UID. Defaults to HOSTFULLY_AGENCY_UID; hostfully_list_agencies lists the options."
},
"property_uid": {
"type": "string",
"description": "The property's UID."
},
"external_booking_id": {
"type": "string",
"description": "Your own reference for this lead."
}
}
},
"annotations": {
"title": "Create a calendar block or inquiry",
"destructiveHint": true
}
}