Roraima holiday rentals

Working · 4.4 s

io.roraima/guestv1.1.1 Domain verified

Find Roraima rentals and devices, get quotes, booking links or a prepared booking. Pay on Roraima.

Maps & Travel Commerce

Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://roraima.io/mcp/guest

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_booking_link

Link to a listing page with arrival, departure and guests already chosen. The guest books and pays on that page. Without dates, the plain listing page.

listing_idinteger, required

listing_id from search_listings.

guestsinteger

Number of guests.

check_instring

Arrival date, YYYY-MM-DD.

languagestring

Language of names, descriptions and page links. Default en.

check_outstring

Departure date, YYYY-MM-DD.

Tools (8)

get_booking_link

Link to a listing page with arrival, departure and guests already chosen. The guest books and pays on that page. Without dates, the plain listing page.

read-only

Argument	Type	Description
guests	integer	Number of guests.
check_in	string	Arrival date, YYYY-MM-DD.
language	string	Language of names, descriptions and page links. Default en.
check_out	string	Departure date, YYYY-MM-DD.
listing_id*	integer	listing_id from search_listings.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "guests": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Number of guests."
    },
    "check_in": {
      "type": "string",
      "format": "date",
      "description": "Arrival date, YYYY-MM-DD."
    },
    "language": {
      "enum": [
        "en",
        "it",
        "de",
        "el",
        "es",
        "fr",
        "pl",
        "pt"
      ],
      "type": "string",
      "description": "Language of names, descriptions and page links. Default en."
    },
    "check_out": {
      "type": "string",
      "format": "date",
      "description": "Departure date, YYYY-MM-DD."
    },
    "listing_id": {
      "type": "integer",
      "minimum": 1,
      "description": "listing_id from search_listings."
    }
  },
  "additionalProperties": false
}

get_listing

Public details of one Roraima listing: name, description, town, whether it is private or shared (accommodation_type, places), stay rules, cancellation policy, registration number, amenities and the link to its page. No host contact details. amenities (nights listings only) lists what the host has stated, each with an English code, the value and the sentence the listing page shows in the language asked; applies_to tells whether it describes the listing or the whole property. An amenity not listed has not been stated: it is unknown, not absent.

read-only

Argument	Type	Description
language	string	Language of names, descriptions and page links. Default en.
listing_id*	integer	listing_id from search_listings.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "language": {
      "enum": [
        "en",
        "it",
        "de",
        "el",
        "es",
        "fr",
        "pl",
        "pt"
      ],
      "type": "string",
      "description": "Language of names, descriptions and page links. Default en."
    },
    "listing_id": {
      "type": "integer",
      "minimum": 1,
      "description": "listing_id from search_listings."
    }
  },
  "additionalProperties": false
}

get_product

Public details of one product on sale on Roraima: name, category, description, lowest price among its sellers, maker and model for devices, image and the link to its page. No seller contact details.

read-only

Argument	Type	Description
country	string	Delivery country (ISO 3166-1 alpha-2) the prices refer to. Optional: without it, each price comes with the country it applies to.
language	string	Language of names, descriptions and page links. Default en.
product_id*	integer	product_id from search_products.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "country": {
      "enum": [
        "AT",
        "BE",
        "BG",
        "CY",
        "CZ",
        "DE",
        "DK",
        "EE",
        "ES",
        "FI",
        "FR",
        "GR",
        "HR",
        "HU",
        "IE",
        "IT",
        "LT",
        "LU",
        "LV",
        "MT",
        "NL",
        "PL",
        "PT",
        "RO",
        "SE",
        "SI",
        "SK"
      ],
      "type": "string",
      "description": "Delivery country (ISO 3166-1 alpha-2) the prices refer to. Optional: without it, each price comes with the country it applies to."
    },
    "language": {
      "enum": [
        "en",
        "it",
        "de",
        "el",
        "es",
        "fr",
        "pl",
        "pt"
      ],
      "type": "string",
      "description": "Language of names, descriptions and page links. Default en."
    },
    "product_id": {
      "type": "integer",
      "minimum": 1,
      "description": "product_id from search_products."
    }
  },
  "additionalProperties": false
}

get_product_link

Link to the page of a product on sale on Roraima. The buyer chooses options and quantity, and pays, on that page.

read-only

Argument	Type	Description
country	string	Delivery country (ISO 3166-1 alpha-2) the prices refer to. Optional: without it, each price comes with the country it applies to.
language	string	Language of names, descriptions and page links. Default en.
product_id*	integer	product_id from search_products.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "country": {
      "enum": [
        "AT",
        "BE",
        "BG",
        "CY",
        "CZ",
        "DE",
        "DK",
        "EE",
        "ES",
        "FI",
        "FR",
        "GR",
        "HR",
        "HU",
        "IE",
        "IT",
        "LT",
        "LU",
        "LV",
        "MT",
        "NL",
        "PL",
        "PT",
        "RO",
        "SE",
        "SI",
        "SK"
      ],
      "type": "string",
      "description": "Delivery country (ISO 3166-1 alpha-2) the prices refer to. Optional: without it, each price comes with the country it applies to."
    },
    "language": {
      "enum": [
        "en",
        "it",
        "de",
        "el",
        "es",
        "fr",
        "pl",
        "pt"
      ],
      "type": "string",
      "description": "Language of names, descriptions and page links. Default en."
    },
    "product_id": {
      "type": "integer",
      "minimum": 1,
      "description": "product_id from search_products."
    }
  },
  "additionalProperties": false
}

get_quote

Total price of a stay (check_in and check_out) or of a time slot (date, start_time, end_time) at one listing, as its page shows it. Answers that the dates are not available when they are taken, and with the code listing_paused when bookings at the listing are paused on those dates. A quote is not a booking.

read-only

Argument	Type	Description
date	string	Day of the time slot, YYYY-MM-DD (listings booked by time slots).
guests*	integer	Number of guests.
check_in	string	Arrival date, YYYY-MM-DD (listings booked by nights).
end_time	string	Slot end, HH:MM.
language	string	Language of names, descriptions and page links. Default en.
check_out	string	Departure date, YYYY-MM-DD.
listing_id*	integer	listing_id from search_listings.
start_time	string	Slot start, HH:MM.

Input schema (JSON)

prepare_booking

Keeps a stay (check_in and check_out) or a time slot (date, start_time, end_time) at one listing, with the name and contacts of the person booking, and returns a link to a Roraima page where that person checks the booking and pays, with these details already filled in. Availability and price are checked as in get_quote. The link carries only a random code, works once and expires after two hours; the details are then deleted. This answer does not repeat the name or the contacts. The booking exists only once it is paid on the page.

Argument	Type	Description
date	string	Day of the time slot, YYYY-MM-DD (listings booked by time slots).
email*	string	Email of the person booking.
phone	string	Phone of the person booking, with the international prefix (for example +39...). Used only where the checkout of the listing asks for a phone number.
guests*	integer	Number of guests.
check_in	string	Arrival date, YYYY-MM-DD (listings booked by nights).
end_time	string	Slot end, HH:MM.
language	string	Language of names, descriptions and page links. Default en.
check_out

search_listings

Search Roraima listings by town or province, country, dates and number of guests. With check_in and check_out, only listings free on those nights are returned, each with its total price and a link to its page with dates and guests filled in. The amenity filters return only nights listings whose host has stated that amenity. accommodation_type tells whether one booking takes the whole place (private) or one place per guest in a shared room such as a dormitory (shared, priced per person).

read-only

Argument	Type	Description
limit	integer	Most results to return. Default 10.
guests	integer	Number of guests.
country	string	ISO 3166-1 alpha-2 country code, e.g. IT.
parking	boolean	true: only listings with parking, free or paid (get_listing says which).
check_in	string	Arrival date, YYYY-MM-DD.
language	string	Language of names, descriptions and page links. Default en.
location	string	Town name, or the two-letter code of an Italian province (SS for the province of Sassari). Province names are matched only as town names.

search_products

Search the Roraima catalog of products for sale, such as smart devices, smart locks and installation services, by words in their name or description. Holiday rentals are not included: they come from search_listings.

read-only

Argument	Type	Description
limit	integer	Most results to return. Default 10.
query	string	Words to look for, e.g. "smart plug" or "Shelly". Without it, the newest products.
country	string	Delivery country (ISO 3166-1 alpha-2) the prices refer to. Optional: without it, each price comes with the country it applies to.
language	string	Language of names, descriptions and page links. Default en.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Most results to return. Default 10."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Words to look for, e.g. \"smart plug\" or \"Shelly\". Without it, the newest products."
    },
    "country": {
      "enum": [
        "AT",
        "BE",
        "BG",
        "CY",
        "CZ",
        "DE",
        "DK",
        "EE",
        "ES",
        "FI",
        "FR",
        "GR",
        "HR",
        "HU",
        "IE",
        "IT",
        "LT",
        "LU",
        "LV",
        "MT",
        "NL",
        "PL",
        "PT",
        "RO",
        "SE",
        "SI",
        "SK"
      ],
      "type": "string",
      "description": "Delivery country (ISO 3166-1 alpha-2) the prices refer to. Optional: without it, each price comes with the country it applies to."
    },
    "language": {
      "enum": [
        "en",
        "it",
        "de",
        "el",
        "es",
        "fr",
        "pl",
        "pt"
      ],
      "type": "string",
      "description": "Language of names, descriptions and page links. Default en."
    }
  },
  "additionalProperties": false
}

{ "type": "object", "required": [ "listing_id", "guests", "first_name", "last_name", "email" ], "properties": { "date": { "type": "string", "format": "date", "description": "Day of the time slot, YYYY-MM-DD (listings booked by time slots)." }, "email": { "type": "string", "format": "email", "maxLength": 128, "description": "Email of the person booking." }, "phone": { "type": "string", "description": "Phone of the person booking, with the international prefix (for example +39...). Used only where the checkout of the listing asks for a phone number." }, "guests": { "type": "integer", "maximum": 20, "minimum": 1, "description": "Number of guests." }, "check_in": { "type": "string", "format": "date", "description": "Arrival date, YYYY-MM-DD (listings booked by nights)." }, "end_time": { "type": "string", "description": "Slot end, HH:MM." }, "language": { "enum": [ "en", "it", "de", "el", "es", "fr", "pl", "pt" ], "type": "string", "description": "Language of names, descriptions and page links. Default en." }, "check_out": { "type": "string", "format": "date", "description": "Departure date, YYYY-MM-DD." }, "last_name": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Last name of the person booking." }, "first_name": { "type": "string", "maxLength": 64, "minLength": 1, "description": "First name of the person booking." }, "listing_id": { "type": "integer", "minimum": 1, "description": "listing_id from search_listings." }, "start_time": { "type": "string", "description": "Slot start, HH:MM." } }, "additionalProperties": false }