Skip to main content

Resources

The MCP server exposes 77 read-only resources. Each is queryable through api_v3_list and api_v3_get by passing its name as the resource argument.

This page is a reference. The authoritative, always-current list is whatever api_v3_resources returns, and the per-resource attributes/filters come from api_v3_resource_schema.

Mirrors API v3

Each resource maps to its API v3 counterpart and uses the same serializer, so its attributes and response shape match the corresponding API v3 endpoint. Resource names here are the values you pass as resource.

ResourceDescription
bookingsReservations and unavailable periods. By default returns visible (non-canceled) bookings.
bookings_feesPer-booking fees attached to reservations (cleaning, tax, etc.).
bookings_paymentsPer-booking payment line items.
bookings_taxesPer-booking tax line items.
bookings_tagsBooking tags (account-level taxonomy applied to bookings).
booking_commentsInternal comments on bookings.
booking_contractsBooking rental agreement contracts.
booking_revenue_distributionsRevenue distribution breakdown per booking (host/manager/platform splits).
booking_cancelation_protection_summariesCancelation protection enrollment summary per booking.
booking_discount_codesBooking discount codes configured by the account.
booking_discount_code_usagesRecords of discount code applications on bookings.
ResourceDescription
rentalsListings/properties for the account.
rental_agreementsLocalized rental agreement contracts associated with rentals.
rental_cancelation_policiesCancelation policies attached to rentals.
rental_cancelation_policy_itemsRefund tiers belonging to rental cancelation policies.
rental_contactsContacts (cleaner, owner, manager…) linked to rentals.
rental_geolocated_addressesVerified geolocated addresses for rentals.
rental_link_groupsGroups of rental links (multi-unit, sister properties, etc.).
rental_linksMembership rows linking rentals to a rental link group.
rental_price_modifier_mapsPer-rental price modifier maps used for dynamic pricing.
rental_urlsExternal URLs (channel listings, websites) associated with rentals.
rentals_amenitiesPer-rental amenity availability + notes.
rentals_contents_overridesPer-application content overrides for rentals (channel-specific descriptions).
rentals_facilitiesPer-rental facility availability.
rentals_feesPer-rental fee configuration.
rentals_taxesPer-rental tax configuration.
rentals_tagsAccount-level tags applied to rentals.
bathroomsBathroom layout/features per rental.
bedroomsBedroom layout/features per rental.
living_roomsLiving room layout/features per rental.
videosVideos attached to rentals.
photosPhotos attached to rentals.
photo_taggingsTag assignments on photos.
photo_tagsGlobal photo tag taxonomy (room types, features, etc.).

Availability, calendar & rates

ResourceDescription
availabilitiesAvailability windows per rental (used to compute calendar).
change_oversChange-over (turnover) days per rental.
ratesNightly rates per rental/season.
rates_rulesPricing rules (min-stay, weekly discount, last-minute, etc.).
rates_tablesRate tables (named pricing strategies) for the account.
seasonsPricing seasons for the account.
periodsDate ranges (periods) belonging to seasons.
los_recordsLength-of-stay (LOS) pre-computed rate records per rental. See the LOS records guide.
mid_term_rate_mapsMid-term (monthly) rate maps per rental. See the midterm pricing guide.
nightly_rate_mapsNightly rate maps per rental.
special_offersPromotional offers attached to rentals (active/non-expired only).

People

ResourceDescription
clientsGuests/customers stored at the account level.
guestsPer-booking guest records (separate from clients).
hostsHosts (greeters, on-site staff) for the account.
host_reviewsReviews written by hosts about guests.
contactsAddress book of contacts (cleaners, maintenance, owners, etc.).
usersUsers with access to the account.
accounts_usersAccount membership records (joins accounts to users with a role).
account_companiesCompany/legal-entity details for the account.

Reviews

ResourceDescription
reviewsGuest reviews of rentals. See the reviews guide.
review_repliesReplies posted to guest reviews.

Inquiries & inbox

ResourceDescription
inquiriesPre-booking inquiries from guests.
inbox_conversationsInbox conversation threads. See the inbox messaging guide.
inbox_messagesInbox messages within conversations.
inbox_attachmentsFile attachments on inbox messages.
inbox_participantsParticipants (members) in inbox conversations.

Task management

ResourceDescription
task_management_tasksOperational tasks (cleaning, maintenance, check-in).
task_management_task_commentsComments on operational tasks.
task_management_attachmentsAttachments on operational tasks.
task_management_templatesReusable task templates.

Payments & finance

ResourceDescription
paymentsTop-level payment transactions.
payment_gatewaysConfigured payment gateways for the account.
sourcesBooking sources / channels (Airbnb, Booking.com, direct, etc.).
damage_protection_enrollmentsDamage protection enrollments per rental.

Fees & taxes

ResourceDescription
feesFee catalog defined at the account level.
fees_taxesJoins between fees and the taxes that apply to them.
taxesTax catalog defined at the account level.
tax_rulesRules controlling when taxes apply (per rental, per fee, etc.).

Reference & catalog data

ResourceDescription
amenitiesGlobal amenity catalog (pool, wifi, parking, etc.).
facilitiesGlobal facility catalog (gym, sauna, conference room, etc.).
destinationsDestinations (cities, regions) associated with the account's rentals.
preferences_general_settingsAccount-level general preferences (locales, etc.).
webhooksConfigured outbound webhooks for the account. See the webhook subscriptions guide.