NaptárAI

Showing 25 of 43 from the live probe.

• Get Workspace Context

  Get the current time and the user's timezone before you compute any post date. Call this FIRST in any conversation that mentions a time — "tomorrow at 9", "next Tuesday", "in two hours". NaptárAI stores post dates in UTC, and create_post refuses a scheduled date in the past, so a wrong timezone assumption is a failed call at best. Returns the server's current UTC instant, the user's IANA timezone as they set it in NaptárAI, and the matching local time. If "timezone" comes back null the user ha

• Properties List

  List the accommodations (properties) in this NaptárAI workspace. Call this FIRST in any conversation about a property, a calendar, prices or bookings: every other tool needs a propertyId, and ids are opaque — you cannot derive one from the name the user says. Hosts usually have one to three properties and will refer to them by name ("a balatoni lakás", "the lake house"). Match on the returned "name" and confirm the match back to the user when there is more than one property. Archived properti

• Properties Get

  Everything about one accommodation: address, timezone, currency, check-in and check-out times (checkInFrom, checkInUntil, checkOutUntil), instantBook, contact details, cancellationPolicy (FLEXIBLE, MODERATE, FIRM, STRICT or NON_REFUNDABLE), the house information the host gives guests, and its units with their rate plans. Use it when the user asks about the property itself rather than about its calendar — "what's the address", "how many rooms do we have". For instant book, check-in clocks and ho

• Properties Get Booking Settings

  Instant book, the check-in / check-out clocks and the house rules for a property, plus a row per connected channel. Use this when the host asks "is instant book on", "what time is check-in", "are pets allowed", "did Airbnb take the house rules". To change them, use properties_set_booking_settings. Do not use properties_get for channel status on these fields. instantBook true means a paid website booking confirms immediately and Airbnb Instant Book is everyone. Times are HH:mm at the property.

• Properties Get Cancellation Policy

  The cancellation policy of one property: the current kind, the generated Hungarian text guests see, any website free-text override, all five kinds with their text (options), and a row per connected channel. Use this when the host asks "what is the cancellation policy", "what does Moderate mean", "did Airbnb take it". To change the kind, use properties_set_cancellation_policy. properties_get only has the kind enum, not the channel status. kind is FLEXIBLE, MODERATE, FIRM, STRICT or NON_REFUNDAB

• Properties Get Content Status

  Whether each connected channel takes the title, description, photos and amenities edited in NaptárAI. Use this when the host asks "do my photos reach Booking.com", "can I change the Airbnb title here". Do not use this to change content. mode is push (we send it), verify (stored, honour unconfirmed), manual (edit on the OTA) or n/a. The Airbnb listing's title and photos are always edited on Airbnb. Booking.com content honour is verify until a production probe says otherwise. Szállás.hu is n/a.

• Units List

  The bookable units of one property, with their rate plans. A "unit" is what a guest books: an apartment, a house, a room type. A unit can stand for several interchangeable rooms — "countOfRooms" is how many, and it is what availability arithmetic counts down from. A six-room guesthouse is six units only if the rooms differ; three identical doubles are usually one unit with countOfRooms 3. Hungarian hosts name units in Hungarian ("Nagy apartman", "Padlásszoba"); match on the returned name and s

• Units Get Listing Settings

  The listing settings of one unit: weekend price, extra-guest fee, cleaning fee, weekly/monthly discounts, lead time, max notice, turnover days, default min/max nights, and allowed check-in/check-out weekdays, plus a row per connected channel. Use this when the host asks "what is the weekend price", "is there a cleaning fee", "which weekdays can guests check in", "did Airbnb take the extra-guest fee". To change them, use units_set_listing_settings. Money is integer minor units (HUF fillér: 4500

• Calendar Get

  The whole calendar for one property over a date range: for every unit and every night, how many rooms are still sellable, which bookings sit on it, and which nights the host has blocked. This is the operational picture. Use it for "what does September look like", "is the lake house free next weekend", "who is arriving on the 12th". Both ends of the range are INCLUSIVE and both are calendar dates in the property's own timezone. Nights, not days: a stay from the 3rd to the 5th occupies the night

• Availability Get

  Which nights are still sellable at a property, and where the free stretches are. Answers "is anything free in September", "show me the empty weekends over the next two months", "can we take a family for four nights around the 12th". Returns, per unit: every night with the number of rooms still sellable, plus "freeRuns" — the unbroken stretches of nights that have at least one room left, each with its length. A guest staying N nights needs a run of at least N nights, so read the runs, do not co

• Rates Get

  Nightly prices and stay restrictions for a property over a date range. Use it before ANY price change: rates_adjust needs to know what a night costs today, and a host asking "raise the weekend by 8%" is asking about numbers you have not seen yet. Returns one block per rate plan. Every night carries rateMinor (minor units of the property's currency — 4104000 is 41 040 Ft) and "rate", the same amount already formatted for a human. Quote the formatted string to the user and do arithmetic on the n

• Reservations List

  Bookings, filtered by property, unit, date range, status, source or guest name. Answers "who is arriving tomorrow", "how many Booking.com bookings did we take for August", "find the Kovács booking". THE DATE FILTER IS AN OVERLAP, not an arrival filter: from/to returns every stay that TOUCHES that window, which is what a host means by "September's bookings" and what the calendar shows them. To list arrivals on one day, set from and to to that day and read arrivalDate on the results. status: IN

• Reservations Get

  One booking in full: dates, unit, guest, party size, amounts, payment state, source, the guest's own comment and the host's internal notes. Always read the booking before acting on it — reservation_cancel and message_draft both change something a guest will see, and the user must be shown the dates and the guest name back before either happens. For OTA commission, net payout and VCC only, use reservations_finance (same booking, no guest dump). Amounts are minor units of the booking's currency

• Reservations Finance

  OTA commission, net payout and guarantee (including a masked Booking.com VCC) for one booking. Use this when the host asks "what did Booking.com take", "what do I actually receive", "is there a virtual card". For dates, guest and status use reservations_get instead. otaCommissionMinor is the booking's own figure when Channex sent ota_commission; null means unknown, not zero. Do not treat unknown as zero and do not invent a rate. netPayoutMinor is total minus known commission, also null when co

• Guests Get

  Look up a guest — by id, or by searching a name or e-mail address. Pass guestId for one person. Pass search to find them by surname, given name or e-mail; Hungarian names are written surname-first ("Kovács Anna"), and the search matches either part. THIS RETURNS PERSONAL DATA. Read only what the user actually asked for, quote the minimum back, and never volunteer an e-mail address, a phone number or an address that was not asked about. "notes" is a staff-only field: never read it out to a gues

• Channels Status

  The OTA connections of this workspace and the health of each one. Answers "is Booking.com connected", "why haven't my Airbnb prices updated", "which channels are live". Status values: CONNECTING (being set up), HEALTHY, SYNC_DELAYED (a push is behind), ACTION_REQUIRED (the host must do something — read lastError and say what it is), DISCONNECTED. Also returns when each channel last synced and the last error it saw. If a host says a price or a block has not reached an OTA, check here BEFORE ch

• Payments List

  Card payments recorded on one booking (direct / Stripe Connect). Use this when the host asks "did they pay", "what came in on this booking", "is there a refund". Amounts are minor units plus a formatted string. status is PENDING, SUCCEEDED, FAILED, CANCELLED, REFUNDED or PARTIALLY_REFUNDED. This is not OTA commission: for "what did Booking.com keep" use reservations_finance.

• Analytics Summary

  How the business is doing: today's arrivals, departures and in-house guests, plus this month's occupancy, revenue, average nightly rate, direct-versus-OTA split and the commission the host avoided by taking direct bookings. Answers "how is this month going", "who is arriving today", "how much have we made", "how much did we save by not going through Booking.com". THE WINDOW IS FIXED: today and the CURRENT calendar month. There is no date-range parameter. If the user asks about a past month or

• Reports Summary

  Revenue, occupancy, ADR, RevPAR, OTA commission and net payout for a date range, broken down per channel (Weboldal, Airbnb, Booking.com, Szállás.hu). Use this when the host asks "how did August go", "what did Booking.com take in commission", "net payout this year". Do NOT use analytics_summary for a past month; that tool is current-month only. from and to are inclusive calendar nights (YYYY-MM-DD). Omit both for the current month. period (month, quarter, year) is the current window in Europe/B

• Website Get

  The host's own direct-booking website. With no propertyId: every property and whether it has a site, its status and its public URL. With a propertyId: that site in full — template, content, languages, subdomain, custom domain, booking settings and publication state. Use it for "is my website live", "what does my site say about parking", "what's my booking page address". The direct site is the commission-free channel — PRD's whole point — so when a host is comparing OTA performance, the site's

• Ntak Status

  NTAK (Hungarian tourist-tax reporting) setup status for a property: registration number, tax number, whether a key and certificate are present, expiry, recent submissions and counts. Use this when the host asks if NTAK is connected, whether the certificate is expiring, or how many submissions failed. Do not use this to change identifiers or upload a certificate. The response never includes secrets (private key, certificate PEM).

• Ntak Submissions

  The NTAK submission log for a property: kind, status, createdAt, externalId, lastError. Paged. Optional filters: status, kind, from, to (createdAt, YYYY-MM-DD inclusive). Use this to list failed daily closes or to find a submission id for ntak_resend. The message payload is never returned.

• Viza Status

  VIZA (guest identity reporting to the THF) setup status for a property: adatszolgaltatasiAzonosito, THF mode (uat / own / fake), recent submissions (including bekuldetlenTipus HIBAS / NEMBEKULDOTT) and counts (including hibas and nembelkuldott). Use this when the host asks if VIZA is live, whether THF is in fake mode, or how many arrivals failed. Do not use this to send identity data. The response never includes identity documents or the encrypted payload.

• Viza Submissions

  The VIZA submission log for a property: kind, status, guest display name, createdAt, externalId, lastError, bekuldetlenTipus (HIBAS / NEMBEKULDOTT, or null). Paged. Optional filters: status, kind, from, to (createdAt, YYYY-MM-DD inclusive). Use this to list rejected arrivals or to find a submission id for viza_resend. The encrypted identity payload is never returned.

• Calendar Block

  Take nights off the market for one unit — an owner stay, or maintenance. Requires the pms:write scope. A read-only connection is refused and nothing changes. BOTH ENDS ARE INCLUSIVE and both are NIGHTS: blocking 2026-09-12 to 2026-09-14 blocks three nights and the unit is free again on the morning of the 15th. This is not the [arrival, departure) convention reservations use — say the nights back to the user in the form they used. kind: OWNER when the host or someone they know is using the pla