ownerrez
Manage OwnerRez properties, bookings, guests, quotes and inquiries.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"ownerrez": {
"url": "https://ownerrez.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://ownerrez.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (25)
🟢get_me
Return the authenticated OwnerRez user (verifies your credentials). OwnerRez API: GET /v2/users/me.
Eingabe-Schema
{
"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 }.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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 }.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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 }.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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).
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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 }.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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 }.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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).
Eingabe-Schema
{
"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).
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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).
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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"
}Community
Nachweis