MCP Tools Documentation

Complete reference for all 42 OwnerRez MCP server tools. Browse the catalog below and review the capabilities available to your AI assistant.

29
Read-Only
13
Write Operations
14
Categories

Policy-managed OwnerRez writes are checked by HostBridge policy before execution. Most write tools run through the shared write-command ledger, while `preview_quote` keeps its live preview path and returns a structured policy result in `dry_run` or `disabled` mode. Use `dry_run` to validate and record a command without calling OwnerRez, and expect a structured replay envelope when the same idempotent write request is reused.

This static site publishes the current MCP catalog as checked-in HTML for crawling and public reference. Use the HostBridge console after sign-in for live discovery, policy-aware execution, and the authenticated tool runner.

Agent

get_agent_invocations

Read-Only

Examine previous agent inputs and outputs (reasoning history).

API:Internal
Method:N/A
Endpoint:Internal tool
Idempotent
Parameters (2)

Bookings

list_bookings

Read-Only

Query for a pageable list of bookings. For best results, provide either property_ids or since_utc (or both). You can use "all" as the value for property_ids to fetch all properties. If neither is provided, the system will automatically fetch all properties and default to bookings from the past 365 days.

API:v2
Method:GET
Endpoint:/v2/bookings
Idempotent
Parameters (12)

get_booking

Read-Only

Fetch a single booking by ID.

API:v2
Method:GET
Endpoint:/v2/bookings/{id}
Idempotent
Parameters (6)

create_booking

Write

Create a new booking. This operation creates a new booking record in your OwnerRez account and requires user permission.

API:v2
Method:POST
Endpoint:/v2/bookings
Parameters (5)

update_booking

Write

Update an existing booking. This operation modifies an existing booking record and requires user permission.

API:v2
Method:PATCH
Endpoint:/v2/bookings/{id}
DestructiveIdempotent
Parameters (2)

Connection

check_ownerrez_connection

Read-Only

Check if the current user has connected their OwnerRez account. Returns connection status and provides instructions if not connected.

API:Internal
Method:N/A
Endpoint:Internal tool
Idempotent

connect_ownerrez

Read-Only

Get the authorization URL to connect your OwnerRez account. The user must visit this URL in their browser to authorize access to their OwnerRez data.

API:Internal
Method:N/A
Endpoint:Internal tool
Idempotent

get_oauth_url

Read-Only

DEPRECATED: Use connect_ownerrez instead. Get the OAuth authorization URL to authenticate with OwnerRez.

API:Internal
Method:N/A
Endpoint:Internal tool (deprecated)
Idempotent
Parameters (1)

Fields

list_field_definitions

Read-Only

Fetch all possible field definitions.

API:v2
Method:GET
Endpoint:/v2/fielddefinitions
Idempotent
Parameters (2)

Guests

list_guests

Read-Only

Query for a pageable list of guests. Either q or created_since_utc is required.

API:v2
Method:GET
Endpoint:/v2/guests
Idempotent
Parameters (6)

get_guest

Read-Only

Fetch a single guest by ID.

API:v2
Method:GET
Endpoint:/v2/guests/{id}
Idempotent
Parameters (1)

create_guest

Write

Create a new guest record. This operation creates a new guest in your OwnerRez account and requires user permission.

API:v2
Method:POST
Endpoint:/v2/guests
Parameters (5)

update_guest

Write

Update an existing guest. This operation modifies an existing guest record and requires user permission.

API:v2
Method:PATCH
Endpoint:/v2/guests/{id}
DestructiveIdempotent
Parameters (2)

delete_guest

Write

Delete a guest record. This operation permanently removes a guest from your OwnerRez account and requires user permission.

API:v2
Method:DELETE
Endpoint:/v2/guests/{id}
DestructiveIdempotent
Parameters (1)

Inquiries

list_inquiries

Read-Only

Fetch all inquiry records.

API:v2
Method:GET
Endpoint:/v2/inquiries
Idempotent
Parameters (4)

get_inquiry

Read-Only

Fetch a single inquiry by ID.

API:v2
Method:GET
Endpoint:/v2/inquiries/{id}
Idempotent
Parameters (1)

Listings

list_listings

Read-Only

Query for a pageable list of property listings. Requires WordPress Plugin + Integrated Websites premium feature.

API:v2
Method:GET
Endpoint:/v2/listings
Idempotent
Parameters (5)

get_listing

Read-Only

Fetch a single listing by ID. Requires WordPress Plugin + Integrated Websites premium feature.

API:v2
Method:GET
Endpoint:/v2/listings/{id}
Idempotent
Parameters (2)

Messages

list_messages

Read-Only

Fetch all message records on a single thread. Requires messaging agreements to be signed.

API:v2
Method:GET
Endpoint:/v2/messages
Idempotent
Parameters (3)

get_message

Read-Only

Fetch a single message by ID. Requires messaging agreements to be signed.

API:v2
Method:GET
Endpoint:/v2/messages/{id}
Idempotent
Parameters (1)

create_message

Write

Create a new message. Requires messaging agreements to be signed. This operation sends a new message and requires user permission.

API:v2
Method:POST
Endpoint:/v2/messages
Parameters (3)

Owners

list_owners

Read-Only

Fetch all owner records.

API:v2
Method:GET
Endpoint:/v2/owners
Idempotent
Parameters (3)

get_owner

Read-Only

Fetch a single owner by ID.

API:v2
Method:GET
Endpoint:/v2/owners/{id}
Idempotent
Parameters (1)

Properties

list_properties

Read-Only

Fetch all properties with optional filters. Supports offset-based pagination to retrieve pages beyond the first.

API:v2
Method:GET
Endpoint:/v2/properties
Idempotent
Parameters (10)

get_property

Read-Only

Fetch a single property by ID.

API:v2
Method:GET
Endpoint:/v2/properties/{id}
Idempotent
Parameters (1)

search_properties

Read-Only

Search for properties with availability and criteria filters.

API:v2
Method:GET
Endpoint:/v2/propertysearch
Idempotent
Parameters (14)

Quotes

list_quotes

Read-Only

Fetch all quote records.

API:v2
Method:GET
Endpoint:/v2/quotes
Idempotent
Parameters (4)

get_quote

Read-Only

Fetch a single quote by ID.

API:v2
Method:GET
Endpoint:/v2/quotes/{id}
Idempotent
Parameters (1)

create_quote

Write

Create a new quote. This operation modifies data and requires user permission.

API:v1.1
Method:POST
Endpoint:/v1.1/quotes
Parameters (6)

preview_quote

Read-Only

Preview a live OwnerRez quote using a narrow HostBridge request shape. This operation does not persist data, but it does call OwnerRez and is gated by the account policy layer before execution.

API:v1
Method:TEST
Endpoint:/v1/quotes
Idempotent
Parameters (11)

test_quote

Read-Only

Test a quote without creating it (preview mode). This operation does not persist data and is read-only.

API:v1.1
Method:POST
Endpoint:/v1.1/quotes/test
Idempotent
Parameters (5)

update_quote

Write

Update an existing quote (full update). This operation modifies data and requires user permission.

API:v1.1
Method:PUT
Endpoint:/v1.1/quotes/{id}
DestructiveIdempotent
Parameters (4)

patch_quote

Write

Partially update an existing quote. This operation modifies data and requires user permission.

API:v1.1
Method:PATCH
Endpoint:/v1.1/quotes/{id}
DestructiveIdempotent
Parameters (5)

send_quote

Write

Send a quote to the guest. This operation triggers email and requires user permission.

API:v1.1
Method:POST
Endpoint:/v1.1/quotes/{id}/send
Idempotent
Parameters (1)

delete_quote

Write

Delete a quote. This operation permanently removes a quote and requires user permission.

API:v1.1
Method:DELETE
Endpoint:/v1.1/quotes/{id}
DestructiveIdempotent
Parameters (1)

update_quote_charges

Write

Update charges for a quote. This operation modifies quote charges and requires user permission.

API:v1.1
Method:PATCH
Endpoint:/v1.1/quotes/{id}/charges
DestructiveIdempotent
Parameters (2)

Reviews

list_reviews

Read-Only

Get a page of reviews.

API:v2
Method:GET
Endpoint:/v2/reviews
Idempotent
Parameters (5)

get_review

Read-Only

Fetch a single review by ID.

API:v2
Method:GET
Endpoint:/v2/reviews/{id}
Idempotent
Parameters (1)

Tags

list_tag_definitions

Read-Only

Fetch a pageable list of all possible tags.

API:v2
Method:GET
Endpoint:/v2/tagdefinitions
Idempotent
Parameters (1)

get_tag_definition

Read-Only

Fetch a single tag definition by ID.

API:v2
Method:GET
Endpoint:/v2/tagdefinitions/{id}
Idempotent
Parameters (1)

create_tag_definition

Write

Create a new tag definition. This operation creates a new tag definition and requires user permission.

API:v2
Method:POST
Endpoint:/v2/tagdefinitions
Parameters (2)

Users

get_current_user

Read-Only

Fetch the user details for the currently authenticated user.

API:v2
Method:GET
Endpoint:/v2/users/me
Idempotent

About These Tools

These tools are available through the Model Context Protocol (MCP) and can be used by AI assistants like Claude and ChatGPT to interact with your OwnerRez data.

Read-Only tools retrieve data without making any changes. Write operations create, update, or delete data and require explicit user permission.

Most endpoints use API v2. Quote write operations use v1.1 for enhanced functionality.