ownerrez
Manage OwnerRez properties, bookings, guests, quotes and inquiries.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~5,515Tokens (definiciones de herramientas)
~1.9 KBTamaño de respuesta típico
Impacto significativo en la atención (4.31% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ownerrez": {
"url": "https://ownerrez.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://ownerrez.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (25)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢get_me
Return the authenticated OwnerRez user (verifies your credentials). OwnerRez API: GET /v2/users/me.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_properties(active, availability_start_date, availability_end_date, payment_method_id, include_tags, ...)
List rental properties. OwnerRez API: GET /v2/properties. Returns the pageable envelope { items, count, limit, offset, next_page_url }.
Esquema de entrada
{
"type": "object",
"properties": {
"active": {
"description": "Filter by active status (true = only active properties).",
"type": "boolean"
},
"availability_start_date": {
"description": "Filter by availability start date (ISO-8601, e.g. 2026-07-01).",
"type": "string"
},
"availability_end_date": {
"description": "Filter by availability end date (ISO-8601).",
"type": "string"
},
"payment_method_id": {
"description": "Filter by applicable payment method id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"include_tags": {
"description": "Include the tags collection on each property.",
"type": "boolean"
},
"include_fields": {
"description": "Include the custom-fields collection on each property.",
"type": "boolean"
},
"include_listing_numbers": {
"description": "Include channel listing numbers on each property.",
"type": "boolean"
},
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_property(id)
Fetch a single property by id (includes time_zone). OwnerRez API: GET /v2/properties/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The property id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_bookings(property_ids, from, to, since_utc, status, ...)
List bookings (reservations). OwnerRez API: GET /v2/bookings. Filter by property, date range, changed-since, and status; opt into embedded charges/guest/tags. Returns { items, count, limit, offset, next_page_url }.
Esquema de entrada
{
"type": "object",
"properties": {
"property_ids": {
"description": "Comma-separated property id(s) to filter by, e.g. \"123\" or \"123,456\".",
"type": "string"
},
"from": {
"description": "Start of the arrival/stay date window (ISO-8601, e.g. 2026-07-01).",
"type": "string"
},
"to": {
"description": "End of the arrival/stay date window (ISO-8601).",
"type": "string"
},
"since_utc": {
"description": "Only bookings created/updated on or after this UTC timestamp (ISO-8601).",
"type": "string"
},
"status": {
"description": "Filter by booking status.",
"type": "string",
"enum": [
"active",
"canceled",
"pending"
]
},
"include_charges": {
"description": "Include the charges breakdown on each booking.",
"type": "boolean"
},
"include_guest": {
"description": "Include the embedded guest object on each booking.",
"type": "boolean"
},
"include_tags": {
"description": "Include the tags collection on each booking.",
"type": "boolean"
},
"include_fields": {
"description": "Include the custom-fields collection on each booking.",
"type": "boolean"
},
"include_cancellation_policy": {
"description": "Include the cancellation-policy detail.",
"type": "boolean"
},
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_booking(id, include_charges, include_guest, include_tags)
Fetch a single booking by id. OwnerRez API: GET /v2/bookings/{id}. Opt into embedded charges/guest/tags.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The booking id."
},
"include_charges": {
"description": "Include the charges breakdown.",
"type": "boolean"
},
"include_guest": {
"description": "Include the embedded guest object.",
"type": "boolean"
},
"include_tags": {
"description": "Include the tags collection.",
"type": "boolean"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_guests(q, created_since_utc, from, to, include_tags, ...)
List guests (contacts). OwnerRez API: GET /v2/guests. NOTE: OwnerRez REQUIRES either `q` (search) or `created_since_utc` on this endpoint. Returns { items, count, limit, offset, next_page_url }.
Esquema de entrada
{
"type": "object",
"properties": {
"q": {
"description": "Search query across guest name/email (required unless created_since_utc is set).",
"type": "string"
},
"created_since_utc": {
"description": "Only guests created on or after this UTC timestamp (ISO-8601). Required unless q is set.",
"type": "string"
},
"from": {
"description": "Filter to guests departing on or after this date (ISO-8601).",
"type": "string"
},
"to": {
"description": "Filter to guests arriving on or before this date (ISO-8601).",
"type": "string"
},
"include_tags": {
"description": "Include the tags collection on each guest.",
"type": "boolean"
},
"include_fields": {
"description": "Include the custom-fields collection on each guest.",
"type": "boolean"
},
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_guest(id)
Fetch a single guest (contact) by id. OwnerRez API: GET /v2/guests/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The guest id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_quotes(limit, offset, params)
List quotes. OwnerRez API: GET /v2/quotes. Returns { items, count, limit, offset, next_page_url }. Use the `params` passthrough for documented filters (e.g. property_id, guest_id).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_quote(id)
Fetch a single quote by id. OwnerRez API: GET /v2/quotes/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The quote id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_listings(limit, offset, params)
List channel listings (a property's presence on a listing site such as Airbnb/Vrbo). OwnerRez API: GET /v2/listings. Returns { items, count, limit, offset, next_page_url }.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_listing(id)
Fetch a single channel listing by id. OwnerRez API: GET /v2/listings/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The listing id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_listing_sites(limit, offset, params)
List the listing sites (channels, e.g. Airbnb, Vrbo) known to OwnerRez. OwnerRez API: GET /v2/listingsites.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_owners(limit, offset, params)
List property owners. OwnerRez API: GET /v2/owners. Returns { items, count, limit, offset, next_page_url }.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_inquiries(limit, offset, params)
List guest inquiries (pre-booking leads). OwnerRez API: GET /v2/inquiries. Use `params` for documented filters.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_messages(limit, offset, params)
List messages from guest-communication threads. OwnerRez API: GET /v2/messages. Use `params` for documented filters (e.g. booking_id).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_payments(limit, offset, params)
List payments. OwnerRez API: GET /v2/payments. Use `params` for documented filters (e.g. booking_id, since_utc).
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_payment(id)
Fetch a single payment by id. OwnerRez API: GET /v2/payments/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The payment id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_field_definitions(limit, offset, params)
List custom-field definitions available in the account (the schema for custom fields on properties/bookings/guests). OwnerRez API: GET /v2/fielddefinitions.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max items to return per page (default set by OwnerRez, typically 10).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Number of items to skip (for paging; combine with limit).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"params": {
"description": "Additional documented query-string filters to send verbatim (merged with the typed params above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ownerrez_request(path)
Power-user escape hatch: GET any OwnerRez API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Pass the FULL API path after the host, starting with a slash, INCLUDING any query string, e.g. "/v2/propertysearch?query=beach" or "/v2/bookings/123". Returns the parsed JSON.
Esquema de entrada
{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Full API path after the host, starting with \"/\", e.g. \"/v2/properties?limit=1\"."
}
},
"required": [
"path"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴create_guest(first_name, last_name, notes, opt_out_marketing_email, opt_out_marketing_sms, ...)
MUTATES OwnerRez data: creates a new guest (contact). OwnerRez API: POST /v2/guests (JSON). Emails/phones/addresses are arrays of objects — pass them via the `fields` passthrough (e.g. email_addresses:[{address:"[email protected]"}]). Returns the created guest.
Esquema de entrada
{
"type": "object",
"properties": {
"first_name": {
"description": "Guest first name.",
"type": "string"
},
"last_name": {
"description": "Guest last name.",
"type": "string"
},
"notes": {
"description": "Free-text notes on the guest.",
"type": "string"
},
"opt_out_marketing_email": {
"description": "Opt this guest out of marketing email.",
"type": "boolean"
},
"opt_out_marketing_sms": {
"description": "Opt this guest out of marketing SMS.",
"type": "boolean"
},
"fields": {
"description": "Additional documented OwnerRez fields to send in the JSON write body (merged with the typed fields above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴update_guest(id, first_name, last_name, notes, opt_out_marketing_email, ...)
MUTATES OwnerRez data: updates an existing guest. OwnerRez API: PATCH /v2/guests/{id} (JSON — only included fields change). Use the `fields` passthrough for arrays (email_addresses/phones/addresses) and any other documented field.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The guest id to update (required)."
},
"first_name": {
"description": "New first name.",
"type": "string"
},
"last_name": {
"description": "New last name.",
"type": "string"
},
"notes": {
"description": "New notes value.",
"type": "string"
},
"opt_out_marketing_email": {
"description": "Opt-out flag for marketing email.",
"type": "boolean"
},
"opt_out_marketing_sms": {
"description": "Opt-out flag for marketing SMS.",
"type": "boolean"
},
"fields": {
"description": "Additional documented OwnerRez fields to send in the JSON write body (merged with the typed fields above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴create_booking(property_id, guest_id, arrival, departure, adults, ...)
MUTATES OwnerRez data: creates a new booking (reservation). OwnerRez API: POST /v2/bookings (JSON). A booking ties a guest to a property for a date range; the exact charge/quote shape is account-specific, so pass extra documented fields via `fields`. Returns the created booking.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The property being booked (required)."
},
"guest_id": {
"description": "The guest id for the reservation.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"arrival": {
"description": "Arrival/check-in date (ISO-8601, e.g. 2026-08-01).",
"type": "string"
},
"departure": {
"description": "Departure/check-out date (ISO-8601).",
"type": "string"
},
"adults": {
"description": "Number of adults.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"children": {
"description": "Number of children.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"notes": {
"description": "Notes on the booking.",
"type": "string"
},
"fields": {
"description": "Additional documented OwnerRez fields to send in the JSON write body (merged with the typed fields above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴update_booking(id, arrival, departure, adults, children, ...)
MUTATES OwnerRez data: updates an existing booking. OwnerRez API: PATCH /v2/bookings/{id} (JSON — only included fields change). Use the `fields` passthrough for any documented field (dates, guest counts, notes, status).
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The booking id to update (required)."
},
"arrival": {
"description": "New arrival date (ISO-8601).",
"type": "string"
},
"departure": {
"description": "New departure date (ISO-8601).",
"type": "string"
},
"adults": {
"description": "New adult count.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"children": {
"description": "New child count.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"notes": {
"description": "New notes value.",
"type": "string"
},
"fields": {
"description": "Additional documented OwnerRez fields to send in the JSON write body (merged with the typed fields above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴create_quote(property_id, arrival, departure, adults, children, ...)
MUTATES OwnerRez data: creates a quote for a property + date range (the pre-booking pricing document). OwnerRez API: POST /v2/quotes (JSON). The full quote/charge shape is account-specific — pass extra documented fields via `fields`. Returns the created quote.
Esquema de entrada
{
"type": "object",
"properties": {
"property_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The property to quote (required)."
},
"arrival": {
"description": "Arrival/check-in date (ISO-8601).",
"type": "string"
},
"departure": {
"description": "Departure/check-out date (ISO-8601).",
"type": "string"
},
"adults": {
"description": "Number of adults.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"children": {
"description": "Number of children.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"guest_id": {
"description": "The guest id, if quoting for an existing guest.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"fields": {
"description": "Additional documented OwnerRez fields to send in the JSON write body (merged with the typed fields above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴create_message(body, booking_id, fields)
MUTATES OwnerRez data: posts a message into a guest-communication thread. OwnerRez API: POST /v2/messages (JSON). The exact thread/booking linkage is account-specific — pass extra documented fields (e.g. thread_id, booking_id) via `fields`. Returns the created message.
Esquema de entrada
{
"type": "object",
"properties": {
"body": {
"type": "string",
"description": "The message text/body (required)."
},
"booking_id": {
"description": "The booking this message relates to.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"fields": {
"description": "Additional documented OwnerRez fields to send in the JSON write body (merged with the typed fields above).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"body"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada25 herramientas