ownerrez
Manage OwnerRez properties, bookings, guests, quotes and inquiries.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~5,515토큰 (도구 정의)
~1.9 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 4.31%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"ownerrez": {
"url": "https://ownerrez.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://ownerrez.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (25)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢get_me
Return the authenticated OwnerRez user (verifies your credentials). OwnerRez API: GET /v2/users/me.
입력 스키마
{
"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 }.
입력 스키마
{
"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}.
입력 스키마
{
"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 }.
입력 스키마
{
"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.
입력 스키마
{
"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 }.
입력 스키마
{
"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}.
입력 스키마
{
"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).
입력 스키마
{
"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}.
입력 스키마
{
"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 }.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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 }.
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 25개