Hostfully API and MCP server Let your AI agent answer booking requests and guests.

ToolWhat it doesAccess

• list_properties List the properties of your Hostfully account. read

  Returns each property with its UID, name, city and whether it is a multi-unit property. Use the UID in the other tools. You see only the properties your Hostfully user can open.

  MCP callhostfully_read → list_properties

  REST endpointGET https://cotlet.dev/api/v1/hostfully/properties

  Parameters

  Parameters: list_properties

  Name	Type	Description
  limit integer	integer	Maximum properties to return.

  Example response

  {
    "properties": [
      {
        "property": "a1b2c3d4-0001",
        "name": "Harbor View Loft",
        "city": "Lisbon",
        "multi_unit": false
      },
      {
        "property": "a1b2c3d4-0002",
        "name": "Garden Cottage",
        "city": "Porto",
        "multi_unit": false
      }
    ]
  }

• get_calendar Read the nights of one property: booked, blocked and open, with the nightly rate. read

  Returns one entry per night in date order with its state and rate. Blocks show their reason when Hostfully has one.

  MCP callhostfully_read → get_calendar

  REST endpointGET https://cotlet.dev/api/v1/hostfully/calendar

  Parameters

  Parameters: get_calendar

  Name	Type	Description
  property string required	string	Property UID from list_properties.
  from string required	string	First date, YYYY-MM-DD.
  to string required	string	Last date, YYYY-MM-DD.

  Example input

  {
    "property": "property",
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "property": "a1b2c3d4-0001",
    "nights": [
      {
        "date": "2026-12-20",
        "state": "open",
        "rate": 140
      },
      {
        "date": "2026-12-21",
        "state": "booked",
        "rate": 140
      },
      {
        "date": "2026-12-22",
        "state": "blocked",
        "rate": 140
      }
    ]
  }

• set_pricing_period Set the nightly rate of a property for a date range. writeasks first

  Replaces the rate for the nights in the range and syncs to the connected channels. It changes what new guests pay, so you confirm it. Read the range with get_calendar first. By default you confirm each call; you can switch that off for this tool.

  MCP callhostfully_write → set_pricing_period

  REST endpointPUT https://cotlet.dev/api/v1/hostfully/pricing-period

  Parameters

  Parameters: set_pricing_period

  Name	Type	Description
  property string required	string	Property UID from list_properties.
  from string required	string	First date, YYYY-MM-DD.
  to string required	string	Last date, YYYY-MM-DD.
  nightly_rate number required	number	Rate per night in the property currency.

  Example input

  {
    "property": "property",
    "from": "from",
    "to": "to",
    "nightly_rate": 1
  }

  Example response

  {
    "property": "a1b2c3d4-0001",
    "from": "2026-12-20",
    "to": "2026-12-31",
    "nightly_rate": 161,
    "currency": "EUR"
  }

ToolWhat it doesAccess

• list_reservations List reservations and booking requests, filtered by status and check-in dates. read

  Returns each reservation with guest first name, property, dates, nights, status and source channel, ordered by check-in date. Guest contact details stay on the reservation page and come only from get_reservation.

  MCP callhostfully_read → list_reservations

  REST endpointGET https://cotlet.dev/api/v1/hostfully/reservations

  Parameters

  Parameters: list_reservations

  Name	Type	Description
  status string	string	booking, request, inquiry or cancelled. Leave empty for all.
  check_in_from string	string	Earliest check-in date, YYYY-MM-DD.
  check_in_to string	string	Latest check-in date, YYYY-MM-DD.
  property string	string	Property UID from list_properties. Leave empty for all.

  Example response

  {
    "reservations": [
      {
        "reservation_id": "r-5501",
        "property": "Harbor View Loft",
        "guest": "Elena",
        "check_in": "2026-11-03",
        "nights": 4,
        "status": "booking",
        "channel": "Airbnb"
      },
      {
        "reservation_id": "r-5502",
        "property": "Garden Cottage",
        "guest": "Marcus",
        "check_in": "2026-11-05",
        "nights": 3,
        "status": "request",
        "channel": "Direct"
      }
    ]
  }

• get_reservation Read one reservation with its guests, price and notes. read

  Returns dates, number of guests, the price breakdown, status and the notes on the reservation. It reads the same page you open from the Booking Pipeline.

  MCP callhostfully_read → get_reservation

  REST endpointGET https://cotlet.dev/api/v1/hostfully/reservations/{reservation_id}

  Parameters

  Parameters: get_reservation

  Name	Type	Description
  reservation_id string required	string	Reservation ID from list_reservations.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "r-5502",
    "property": "Garden Cottage",
    "guest": "Marcus",
    "guests": 2,
    "check_in": "2026-11-05",
    "check_out": "2026-11-08",
    "nights": 3,
    "status": "request",
    "total": 480,
    "currency": "EUR",
    "notes": "Asks for late check-in"
  }

• accept_booking_request Accept an open booking request. writeasks first

  Turns the request into a booking and blocks the nights in the calendar. The guest is notified by Hostfully. It works only on reservations with status request. By default you confirm each call; you can switch that off for this tool.

  MCP callhostfully_write → accept_booking_request

  REST endpointPOST https://cotlet.dev/api/v1/hostfully/reservations/{reservation_id}/booking-request/accept

  Parameters

  Parameters: accept_booking_request

  Name	Type	Description
  reservation_id string required	string	Reservation ID from list_reservations.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "r-5502",
    "status": "booking"
  }

• decline_booking_request Decline an open booking request. writeasks first

  Closes the request and frees the nights. The guest is notified by Hostfully. It works only on reservations with status request. By default you confirm each call; you can switch that off for this tool.

  MCP callhostfully_write → decline_booking_request

  REST endpointPOST https://cotlet.dev/api/v1/hostfully/reservations/{reservation_id}/booking-request/decline

  Parameters

  Parameters: decline_booking_request

  Name	Type	Description
  reservation_id string required	string	Reservation ID from list_reservations.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "r-5503",
    "status": "declined"
  }

• cancel_booking Cancel a confirmed booking. writeasks first

  Cancels the booking and frees the nights. The guest is notified and refund terms of the booking apply, so check them first. By default you confirm each call; you can switch that off for this tool.

  MCP callhostfully_write → cancel_booking

  REST endpointPOST https://cotlet.dev/api/v1/hostfully/reservations/{reservation_id}/booking/cancel

  Parameters

  Parameters: cancel_booking

  Name	Type	Description
  reservation_id string required	string	Reservation ID from list_reservations.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "r-5501",
    "status": "cancelled"
  }

ToolWhat it doesAccess

• list_message_threads List guest conversations from the Unified Inbox. read

  Returns each thread with the guest first name, property, reservation, last message time and a preview, newest first. It does not mark anything as read.

  MCP callhostfully_read → list_message_threads

  REST endpointGET https://cotlet.dev/api/v1/hostfully/message-threads

  Parameters

  Parameters: list_message_threads

  Name	Type	Description
  unanswered boolean	boolean	Only threads whose last message came from the guest.

  Example response

  {
    "threads": [
      {
        "thread_id": "t-301",
        "guest": "Elena",
        "property": "Harbor View Loft",
        "reservation_id": "r-5501",
        "last_message_at": "2026-10-30T18:40:00Z",
        "preview": "What time can we check in?"
      }
    ]
  }

• list_messages Read the messages of one thread, oldest first. read

  Returns sender, time and text of each message, including automated messages Hostfully sent. Reading does not send or change anything.

  MCP callhostfully_read → list_messages

  REST endpointGET https://cotlet.dev/api/v1/hostfully/threads/{thread_id}/messages

  Parameters

  Parameters: list_messages

  Name	Type	Description
  thread_id string required	string	Thread ID from list_message_threads.

  Example input

  {
    "thread_id": "thread_8c41d2"
  }

  Example response

  {
    "messages": [
      {
        "from": "host",
        "at": "2026-10-29T09:00:00Z",
        "text": "Welcome, Elena. Your stay starts on 3 November."
      },
      {
        "from": "guest",
        "at": "2026-10-30T18:40:00Z",
        "text": "What time can we check in?"
      }
    ]
  }

• send_message Send a message to a guest in the thread of a reservation. writeasks first

  Sends the message through Hostfully, which delivers it on the channel of the booking. The guest receives it, so it cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callhostfully_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/hostfully/threads/{thread_id}/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  thread_id string required	string	Thread ID from list_message_threads.
  text string required	string	Message text.

  Example input

  {
    "thread_id": "t-301",
    "text": "Hi Elena, check-in starts at 3 pm. Happy to arrange earlier if the loft is free."
  }

  Example response

  {
    "thread_id": "t-301",
    "status": "sent",
    "sent_at": "2026-10-31T08:15:00Z"
  }