Avantio API and MCP server Let your AI agent handle your Avantio bookings.

ToolWhat it doesAccess

• list_accommodations List the accommodations of your Avantio account. read

  Returns each accommodation with its ID, name and city. Use the ID in the other tools. You see only the accommodations your Avantio user can open.

  MCP callavantio_read → list_accommodations

  REST endpointGET https://cotlet.dev/api/v1/avantio/accommodations

  Parameters

  Parameters: list_accommodations

  Name	Type	Description
  limit integer	integer	Maximum accommodations to return.

  Example response

  {
    "accommodations": [
      {
        "accommodation": "acc-1001",
        "name": "Casa del Sol",
        "city": "Valencia"
      },
      {
        "accommodation": "acc-1002",
        "name": "Pine Chalets",
        "city": "Girona"
      }
    ]
  }

• list_bookings List bookings filtered by check-in dates and accommodation. read

  Returns each booking with its number, accommodation, guest first name, dates, nights, payment status and source portal, ordered by check-in date. Guest contact details come only from get_booking.

  MCP callavantio_read → list_bookings

  REST endpointGET https://cotlet.dev/api/v1/avantio/bookings

  Parameters

  Parameters: list_bookings

  Name	Type	Description
  check_in_from string	string	Earliest check-in date, YYYY-MM-DD.
  check_in_to string	string	Latest check-in date, YYYY-MM-DD.
  accommodation string	string	Accommodation ID from list_accommodations. Leave empty for all.

  Example response

  {
    "bookings": [
      {
        "booking_id": "b-7001",
        "accommodation": "Casa del Sol",
        "guest": "Elena",
        "check_in": "2026-11-03",
        "nights": 3,
        "payment": "Paid",
        "portal": "Airbnb"
      },
      {
        "booking_id": "b-7002",
        "accommodation": "Pine Chalets",
        "guest": "Marcus",
        "check_in": "2026-11-05",
        "nights": 5,
        "payment": "Pending",
        "portal": "Booking.com"
      }
    ]
  }

• get_booking Read one booking with its guest, price, payments and notes. read

  Returns dates, guest name and contact, number of guests, the price, the payments recorded and the notes on the booking. It shows the same information as the booking page in the Bookings module.

  MCP callavantio_read → get_booking

  REST endpointGET https://cotlet.dev/api/v1/avantio/bookings/{booking_id}

  Parameters

  Parameters: get_booking

  Name	Type	Description
  booking_id string required	string	Booking ID from list_bookings.

  Example input

  {
    "booking_id": "booking_8c41d2"
  }

  Example response

  {
    "booking_id": "b-7002",
    "accommodation": "Pine Chalets",
    "guest": "Marcus",
    "email": "marcus@example.com",
    "guests": 2,
    "check_in": "2026-11-05",
    "check_out": "2026-11-10",
    "nights": 5,
    "total": 640,
    "paid": 320,
    "currency": "EUR",
    "notes": "Asks for late check-in"
  }

ToolWhat it doesAccess

• get_calendar Read the nights of one accommodation: booked and open. read

  Returns one entry per night in date order with its state and, for booked nights, the booking number. It reads the Calendar module and changes nothing.

  MCP callavantio_read → get_calendar

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

  Parameters

  Parameters: get_calendar

  Name	Type	Description
  accommodation string required	string	Accommodation ID from list_accommodations.
  from string required	string	First date, YYYY-MM-DD.
  to string required	string	Last date, YYYY-MM-DD.

  Example input

  {
    "accommodation": "accommodation",
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "accommodation": "acc-1001",
    "nights": [
      {
        "date": "2026-12-20",
        "state": "open"
      },
      {
        "date": "2026-12-21",
        "state": "booked",
        "booking_id": "b-7010"
      },
      {
        "date": "2026-12-22",
        "state": "booked",
        "booking_id": "b-7010"
      },
      {
        "date": "2026-12-23",
        "state": "open"
      }
    ]
  }

• get_rates_and_rules Read the nightly rates and occupancy rules of one accommodation, with its occupancy percentage and average daily rate. read

  Returns one entry per night with its rate and minimum stay, plus the occupancy percentage and the average daily rate (ADR) for the period. It reads the Revenue Calendar and changes nothing. Read it before update_rates to keep the old values.

  MCP callavantio_read → get_rates_and_rules

  REST endpointGET https://cotlet.dev/api/v1/avantio/rates-and-rules

  Parameters

  Parameters: get_rates_and_rules

  Name	Type	Description
  accommodation string required	string	Accommodation ID from list_accommodations.
  from string required	string	First date, YYYY-MM-DD.
  to string required	string	Last date, YYYY-MM-DD.

  Example input

  {
    "accommodation": "accommodation",
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "accommodation": "acc-1001",
    "occupancy_percent": 50,
    "adr": 140,
    "nights": [
      {
        "date": "2026-12-20",
        "rate": 140,
        "min_stay": 2
      },
      {
        "date": "2026-12-21",
        "rate": 140,
        "min_stay": 2
      },
      {
        "date": "2026-12-22",
        "rate": 140,
        "min_stay": 3
      },
      {
        "date": "2026-12-23",
        "rate": 140,
        "min_stay": 3
      }
    ]
  }

• list_rate_changes Read the record of changes made to rates and rules of one accommodation. read

  Returns each change with the time, the user who made it and the dates it covered, newest first. It is the record the Revenue Calendar keeps, so changes made by this integration show up in it too.

  MCP callavantio_read → list_rate_changes

  REST endpointGET https://cotlet.dev/api/v1/avantio/rate-changes

  Parameters

  Parameters: list_rate_changes

  Name	Type	Description
  accommodation string required	string	Accommodation ID from list_accommodations.
  limit integer	integer	Maximum changes to return.

  Example input

  {
    "accommodation": "accommodation"
  }

  Example response

  {
    "changes": [
      {
        "at": "2026-10-30T14:05:00Z",
        "user": "maya@example.com",
        "from": "2026-12-20",
        "to": "2026-12-31",
        "summary": "Rate set to 161"
      }
    ]
  }

• update_rates Set the nightly rate of an accommodation for a date range. writeasks first

  Replaces the rate for the nights in the range through the Revenue Calendar, and Avantio passes it on to the connected portals. It changes what new guests pay, so you confirm it. Read the range with get_rates_and_rules first, and check list_rate_changes afterwards. By default you confirm each call; you can switch that off for this tool.

  MCP callavantio_write → update_rates

  REST endpointPATCH https://cotlet.dev/api/v1/avantio/rates

  Parameters

  Parameters: update_rates

  Name	Type	Description
  accommodation string required	string	Accommodation ID from list_accommodations.
  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 currency of the accommodation.

  Example input

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

  Example response

  {
    "accommodation": "acc-1001",
    "from": "2026-12-20",
    "to": "2026-12-31",
    "nightly_rate": 161,
    "currency": "EUR"
  }

• update_minimum_stay Set the minimum stay of an accommodation for a date range. writeasks first

  Replaces the minimum stay for the nights in the range through the Revenue Calendar, and Avantio passes it on to the connected portals. It changes which bookings guests can make, so you confirm it. Run it again with the old value to undo it. By default you confirm each call; you can switch that off for this tool.

  MCP callavantio_write → update_minimum_stay

  REST endpointPATCH https://cotlet.dev/api/v1/avantio/minimum-stay

  Parameters

  Parameters: update_minimum_stay

  Name	Type	Description
  accommodation string required	string	Accommodation ID from list_accommodations.
  from string required	string	First date, YYYY-MM-DD.
  to string required	string	Last date, YYYY-MM-DD.
  min_stay integer required	integer	Minimum number of nights.

  Example input

  {
    "accommodation": "accommodation",
    "from": "from",
    "to": "to",
    "min_stay": 1
  }

  Example response

  {
    "accommodation": "acc-1001",
    "from": "2026-12-23",
    "to": "2026-12-23",
    "min_stay": 1
  }

ToolWhat it doesAccess

• list_conversations List conversations from the Unified Inbox. read

  Returns each conversation with the guest first name, accommodation, booking, channel, last message time and a preview, newest first. It does not mark anything as read.

  MCP callavantio_read → list_conversations

  REST endpointGET https://cotlet.dev/api/v1/avantio/conversations

  Parameters

  Parameters: list_conversations

  Name	Type	Description
  booking_id string	string	Booking ID from list_bookings. Leave empty for all conversations.
  unanswered boolean	boolean	Only conversations whose last message came from the guest.

  Example response

  {
    "conversations": [
      {
        "conversation_id": "c-301",
        "guest": "Elena",
        "accommodation": "Casa del Sol",
        "booking_id": "b-7001",
        "channel": "Airbnb",
        "last_message_at": "2026-10-30T18:40:00Z",
        "preview": "What time can we check in?"
      }
    ]
  }

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

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

  MCP callavantio_read → list_messages

  REST endpointGET https://cotlet.dev/api/v1/avantio/conversations/{conversation_id}/messages

  Parameters

  Parameters: list_messages

  Name	Type	Description
  conversation_id string required	string	Conversation ID from list_conversations.

  Example input

  {
    "conversation_id": "conversation_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 an Unified Inbox conversation. writeasks first

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

  MCP callavantio_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/avantio/conversations/{conversation_id}/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  conversation_id string required	string	Conversation ID from list_conversations.
  text string required	string	Message text.

  Example input

  {
    "conversation_id": "c-301",
    "text": "Hi Elena, check-in starts at 3 pm. Happy to arrange earlier if Casa del Sol is free."
  }

  Example response

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

ToolWhat it doesAccess

• list_tasks List tasks from the Operations Management Tool, filtered by type, status and dates. read

  Returns each task with its title, accommodation or booking, assignee, date, time, priority and status. It reads the task list and changes nothing.

  MCP callavantio_read → list_tasks

  REST endpointGET https://cotlet.dev/api/v1/avantio/tasks

  Parameters

  Parameters: list_tasks

  Name	Type	Description
  status string	string	Task status as Avantio shows it. Leave empty for all.
  from string	string	Earliest task date, YYYY-MM-DD.
  to string	string	Latest task date, YYYY-MM-DD.
  accommodation string	string	Accommodation ID from list_accommodations. Leave empty for all.

  Example response

  {
    "tasks": [
      {
        "task_id": "t-410",
        "title": "Cleaning after check-out",
        "accommodation": "Casa del Sol",
        "assignee": "Cleaning team",
        "date": "2026-11-06",
        "priority": "High",
        "status": "Open"
      }
    ]
  }

• create_task Create a task in the Operations Management Tool and assign it. writeasks first

  Creates the task and assigns it, so the assignee sees it in Avantio. A task is not undone by a call of this integration, so you confirm it; you edit it in the Operations module. By default you confirm each call; you can switch that off for this tool.

  MCP callavantio_write → create_task

  REST endpointPOST https://cotlet.dev/api/v1/avantio/tasks

  Parameters

  Parameters: create_task

  Name	Type	Description
  title string required	string	Task title.
  accommodation string	string	Accommodation ID from list_accommodations.
  booking_id string	string	Booking ID from list_bookings, to link the task to a booking.
  assignee string	string	Team member or service provider, as named in Avantio.
  date string	string	Task date, YYYY-MM-DD.
  description string	string	Written briefing for the assignee.

  Example input

  {
    "title": "title"
  }

  Example response

  {
    "task_id": "t-411",
    "title": "Cleaning after check-out",
    "accommodation": "Casa del Sol",
    "assignee": "Cleaning team",
    "date": "2026-11-06",
    "status": "Open"
  }