Avirato MCP by usefulapi

Read reservations, availability, rates and prices; record cash payments in Avirato.

Should I use this

Quality & Safety

A
Description quality
99%
Schema completeness
83%
Naming quality
75%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (6)

  • LOWTool 'avirato_get_reservation_details' name length outside 3-30 rangein avirato_get_reservation_details
  • LOWTool 'avirato_get_related_reservations' name length outside 3-30 rangein avirato_get_related_reservations
  • LOWTool 'avirato_get_booking_engine_overview' name length outside 3-30 rangein avirato_get_booking_engine_overview
  • LOWTool 'avirato_list_rates_by_room_category' name length outside 3-30 rangein avirato_list_rates_by_room_category
  • LOWTool 'avirato_list_promotional_packages' name length outside 3-30 rangein avirato_list_promotional_packages
  • LOWTool 'avirato_add_booking_cash_payment' name length outside 3-30 rangein avirato_add_booking_cash_payment

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~4,697Tokens (tool definitions)
~1.3 KBTypical response size
Significant attention impact (3.67% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "avirato": {
      "url": "https://avirato.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (23)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢avirato_list_reservations(start_date, end_date)

Reservations of the establishment between two dates (reservation id, channel booking id, room, rate, guest name and document, check-in/out, price, paid and outstanding, status, notes) plus a summary of counts by status. Dates are whole days (yyyy-mm-dd) or exact date-times. GET /reservation/betweenDates.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "First day (yyyy-mm-dd) or date-time (yyyy-mm-dd hh:mm:ss) of the range."
    },
    "end_date": {
      "type": "string",
      "description": "Last day (yyyy-mm-dd, through 23:59:59) or date-time of the range."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_reservation(booking_id, operator_id)

One reservation by the hotel's own booking id, or by a channel's booking id together with the channel (operator) id. Returns the booking(s) with guest, room, rate, dates, price, paid and outstanding amounts and status. Card data is never returned. GET /reservation/{bookingId}.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The hotel's booking id, or a channel's (operator's) booking id."
    },
    "operator_id": {
      "description": "The channel (operator) id when booking_id is a channel's booking id. See avirato_list_booking_channels.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_reservation_details(booking_id)

Extended information of one reservation by its booking id (the reservationInfo view). Card data is never returned. GET /reservation/reservationInfo.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The hotel's booking (reservation) id."
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_related_reservations(reservation_id)

A reservation with the other reservations of the same group (master booking and its related rooms). Card data is never returned. GET /reservation/related/{reservationId}.

Input Schema

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

Every reservation of the establishment in the PMS (can be a very large list for an old hotel; prefer avirato_list_reservations with a date range). Returns `limit` entries from `offset` (default the first 100), the total count and next_offset. Card data is never returned. GET /reservation/allReservations.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "How many reservations to return (default 100, max 500).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 500
    },
    "offset": {
      "description": "Skip this many reservations first (default 0); pass the previous reply's next_offset to read on.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_list_booking_channels

The sales channels (operators: OTAs, own website, ...) that book into the establishment, with their operator ids (used by avirato_get_reservation). GET /reservation/operators.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_check_availability(check_in_date, check_out_date, online_only, with_valid_space_ids, space_type_id, ...)

Availability of rooms for a stay: which room types and rooms are free between check-in and check-out, optionally limited to a room category, rooms, room types or zones. GET /availability.

Input Schema

{
  "type": "object",
  "properties": {
    "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."
    },
    "online_only": {
      "description": "Only rooms offered for online sale.",
      "type": "boolean"
    },
    "with_valid_space_ids": {
      "description": "Only rooms (spaces) that exist as valid rooms.",
      "type": "boolean"
    },
    "space_type_id": {
      "description": "Room category id (space type).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "space_ids": {
      "description": "Only these room (space) ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "space_subtype_ids": {
      "description": "Only these room type (space subtype) ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "zone_ids": {
      "description": "Only these zone ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    }
  },
  "required": [
    "check_in_date",
    "check_out_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_list_available_spaces(start_date, end_date, space_type_id)

The free rooms (spaces) of one room category between two dates. GET /availability/availableSpaces.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "First night, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Last day, yyyy-mm-dd."
    },
    "space_type_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Room category id (space type). See avirato_get_booking_engine_overview."
    }
  },
  "required": [
    "start_date",
    "end_date",
    "space_type_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_unavailable_dates(booking_id, space_id, start_date)

The dates a room (space) is not free from a start date on, ignoring the given booking (useful to check whether a booking can be extended or moved). GET /availability/unavailable-dates.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The booking id to ignore."
    },
    "space_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The room (space) id."
    },
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Start date, yyyy-mm-dd."
    }
  },
  "required": [
    "booking_id",
    "space_id",
    "start_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_booking_engine_overview(start_date, end_date)

The booking-engine start data between two dates: room types with descriptions and availability, meal plans (diets), taxes, extras and billing configuration. The quickest way to learn the room type, space type and rate ids of the establishment. GET /rate/init.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "First day, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Last day, yyyy-mm-dd."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_list_rates(rate_ids, mode)

The rates of the establishment (name, minimum/maximum stay, refundable, linked rate and percentage, release days, room category), optionally only some rate ids and one rate mode. GET /rate.

Input Schema

{
  "type": "object",
  "properties": {
    "rate_ids": {
      "description": "Only these rate ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "mode": {
      "description": "Rate mode: 'dias' (nightly) or 'horas' (hourly).",
      "type": "string",
      "enum": [
        "dias",
        "horas"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_list_rates_by_room_category(rate_ids, space_type_ids)

All rates of the establishment, optionally limited to some rate ids and room categories (space types). GET /rate/all.

Input Schema

{
  "type": "object",
  "properties": {
    "rate_ids": {
      "description": "Only these rate ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "space_type_ids": {
      "description": "Only these room category (space type) ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_rate(rate_id)

One rate by id: name, stay limits, refundable, linked and master rate, release days and mode. GET /rate/{rateId}.

Input Schema

{
  "type": "object",
  "properties": {
    "rate_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The rate id."
    }
  },
  "required": [
    "rate_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_price(start_date, end_date, space_subtype_id, rate_id, adults, ...)

The final price of a stay for one room type and rate, with discounts and increments applied, for a number of adults, children, meal plan and rooms. GET /rate/getPrice.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "First night, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Check-out date, yyyy-mm-dd."
    },
    "space_subtype_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Room type (space subtype) id."
    },
    "rate_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Rate id."
    },
    "adults": {
      "description": "Adults (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "children": {
      "description": "Children (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    },
    "diet": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "description": "Meal plan (diet) id; 0 = none. List them with avirato_list_diets."
    },
    "num_rooms": {
      "description": "Total rooms in the booking (used for discounts; default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "start_date",
    "end_date",
    "space_subtype_id",
    "rate_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_prices_map(start_date, end_date, space_subtype_ids, rate_ids)

Prices per room type and rate for each day of a period, with the establishment's taxes. GET /rate/getPricesMap.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "First day, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Last day, yyyy-mm-dd."
    },
    "space_subtype_ids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      },
      "description": "Room type (space subtype) ids."
    },
    "rate_ids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      },
      "description": "Rate ids."
    }
  },
  "required": [
    "start_date",
    "end_date",
    "space_subtype_ids",
    "rate_ids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_discounts(start_date, end_date, space_subtype_ids, rate_ids, num_rooms)

The discounts and increments that apply to room types and rates for a period and a number of rooms. GET /rate/discounts.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "First day, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Last day, yyyy-mm-dd."
    },
    "space_subtype_ids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      },
      "description": "Room type (space subtype) ids."
    },
    "rate_ids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      },
      "description": "Rate ids."
    },
    "num_rooms": {
      "description": "Total rooms wanted (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "start_date",
    "end_date",
    "space_subtype_ids",
    "rate_ids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_list_diets

The meal plans (diets) of the establishment with their ids, as used by the price tools. GET /rate/diets.

Input Schema

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

The release (minimum advance booking) days of each rate. GET /rate/release.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_minimum_stay(final_date, initial_date, rate_ids, space_subtype_ids)

The minimum-stay restrictions per day for room types and rates over a period. GET /restrictions/minimum-stay.

Input Schema

{
  "type": "object",
  "properties": {
    "final_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Last day of the period, yyyy-mm-dd."
    },
    "initial_date": {
      "description": "First day of the period, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
    },
    "rate_ids": {
      "description": "Only these rate ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "space_subtype_ids": {
      "description": "Only these room type (space subtype) ids.",
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    }
  },
  "required": [
    "final_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_get_daily_prices(date, rate_id)

The daily prices of one rate on one date (per room type and occupancy). GET /dailyPrice.

Input Schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "The date, yyyy-mm-dd."
    },
    "rate_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The rate id."
    }
  },
  "required": [
    "date",
    "rate_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢avirato_list_promotional_packages

The promotional packages of the establishment with their extras. GET /payment/promotionalPackages.

Input Schema

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

The extras (additional services) that can be charged on a booking. GET /payment/extras.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡avirato_add_booking_cash_payment(booking_id, amount, datetime, confirm)

WRITE: records a cash payment on an existing booking in the hotel's PMS (it changes the booking's paid and outstanding amounts and cannot be undone through this server). Not idempotent: calling it twice records two payments. Confirm the booking id and the amount with the user first, then pass confirm: true. If the call fails with a network error or timeout the payment may still have been recorded: read the booking (avirato_get_reservation) and check its payments before trying again. Card payments are not supported. POST /payment/addBookingPayment.

Input Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The booking (reservation) id."
    },
    "amount": {
      "type": "number",
      "description": "Payment amount in the establishment's currency; must not be 0."
    },
    "datetime": {
      "description": "When the payment was received, yyyy-mm-dd hh:mm:ss (default: now, UTC).",
      "type": "string"
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true: you confirm the user asked to record exactly this payment on this booking."
    }
  },
  "required": [
    "booking_id",
    "amount",
    "confirm"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded23 tools