Tervezett MCP-eszközök

Olvasó eszközök

Ezek az eszközök semmit nem módosítanak, és minden érvényes MCP-kapcsolat hívhatja őket.

• properties_list, properties_get, units_list, szálláshelyek és kiadható egységek
• calendar_get, éjszakánként és egységenként eladható szoba, foglalások, zárolások
• availability_get, szabad éjszakák és összefüggő szabad időszakok
• rates_get, éjszakai árak és tartózkodási korlátozások
• reservations_list, reservations_get, foglalások szűrve, illetve tételesen
• guests_get, egy vendég azonosító alapján vagy keresés név, e-mail szerint
• channels_status, az OTA-kapcsolatok állapota, utolsó szinkron, utolsó hiba
• analytics_summary, mai érkezések, havi kihasználtság, bevétel, direkt/OTA arány
• website_get, a saját foglalási weboldal állapota és tartalma

Író eszközök

Az író eszközökhöz a kapcsolatnak pms:write hatókörre van szüksége. Ez alapértelmezetten nincs megadva: egy frissen létrehozott MCP-kulcs csak olvasni tud, amíg a munkaterület tulajdonosa külön meg nem adja az írási jogot. Írási jog nélkül a hívás elutasításra kerül, és semmi nem változik.

• calendar_block, calendar_unblock, éjszakák kivétele és visszaengedése az értékesítésbe
• rates_set, egy ár beállítása időszakra
• rates_adjust, meglévő árak mozgatása százalékkal vagy fix összeggel, legfeljebb ±50%
• restrictions_set, minimum és maximum éjszaka, érkezés- és távozászárás, értékesítés leállítása
• reservation_create, direkt vagy kézi foglalás rögzítése
• reservation_cancel, foglalás lemondása
• message_draft, vendégüzenet előkészítése; nem küld el semmit

Védőkorlátok

Néhány szabály magában az eszközben van kikényszerítve, nem csak leírva.

• Megerősített vagy bejelentkezett foglalás csak a konkrét foglalás kifejezett megerősítésével mondható le.
• Saját használatra zárolt éjszakák csak külön megerősítéssel nyithatók vissza.
• Egyetlen ár sem mozdítható 50%-nál nagyobb mértékben egyik irányba sem.
• OTA-ról érkezett foglalás nem rögzíthető kézzel: az a csatornán keresztül érkezik meg.
• A message_draft nem küld és nem tárol üzenetet, a szöveget a szállásadó küldi el a NaptárAI postaládájából.

Még nem elérhető

A PRD §22 további eszközöket is felsorol. Ezek szándékosan nem léteznek, nem pedig hibát adnak vissza: egy létező, de mindig elutasító eszközre az AI hiába tervez.

• payments.list
• availability.set, reservation.modify
• message.send, website.update
• task.create, tasks.list, promo.create

Státusz

A ténylegesen kiadott szerver önleíró eszközlistája a végleges szerződés. A fenti nevek a /.well-known/mcp.json manifesztben is szerepelnek, és egy build-teszt tartja őket szinkronban a szerver saját eszközregiszterével.