Asystent Noclegowo — dokumentacja

Serwer MCP serwisu noclegowo.pl dla ChatGPT i Claude. Adres serwera: https://ai.noclegowo.pl/mcp

Czym jest Asystent Noclegowo

Asystent Noclegowo to zdalny serwer MCP (Model Context Protocol), który pozwala asystentowi AI wyszukiwać oferty noclegowe w Polsce z bazy noclegowo.pl: hotele, pensjonaty, apartamenty, domki, agroturystykę i inne obiekty. Asystent przekazuje serwerowi kryteria z rozmowy (miejscowość, termin, liczba osób, życzenia), a serwer zwraca oferty z oceną gości, linkiem i — gdy podasz termin — dostępnością oraz ceną za pobyt.

Tylko odczyt. Wszystkie narzędzia są oznaczone jako tylko do odczytu; serwer niczego nie rezerwuje, nie wysyła zapytań do gospodarzy ani nie zmienia danych.
Bez logowania. Nie jest potrzebne konto ani autoryzacja.
Rezerwację lub zapytanie do gospodarza wykonujesz sam(a) na stronie oferty na noclegowo.pl — każda oferta ma link.
Wyniki są sortowane według dopasowania do zapytania, dostępności, ocen gości i odległości; nie ma w nich płatnych promowań.

Jak dodać

ChatGPT

Aplikacja „Asystent Noclegowo” jest opublikowana w ChatGPT (nowa wersja czeka na recenzję OpenAI).

Otwórz katalog aplikacji w ChatGPT i wyszukaj „Asystent Noclegowo”.
Połącz aplikację (nie wymaga logowania do noclegowo.pl).
W rozmowie opisz, czego szukasz, np. „domek w Zakopanem na weekend dla 4 osób z sauną”.

Claude

Otwórz Settings → Connectors (Ustawienia → Konektory).
Wybierz Add custom connector (Dodaj konektor niestandardowy).
Jako adres URL wpisz https://ai.noclegowo.pl/mcp. Autoryzacja nie jest wymagana.
Włącz konektor w rozmowie i opisz, czego szukasz. Karty z ofertami wyświetlają klienci, które obsługują aplikacje MCP; w pozostałych dostaniesz listę z linkami.

Narzędzia

Serwer udostępnia cztery narzędzia, wszystkie tylko do odczytu. Asystent AI wybiera narzędzie sam; poniżej przykładowe pytania, które je uruchamiają.

`search_accommodations` — wyszukiwanie noclegów

Wyszukuje oferty wg kryteriów: miejscowość, termin, liczba dorosłych i dzieci (z wiekiem), zwierzęta, udogodnienia, budżet, dodatkowe oczekiwania. Zwraca do kilku ofert z oceną, linkiem oraz — przy podanym terminie i składzie grupy — dostępnością i ceną za cały pobyt. Udogodnienia wymienione w rozmowie traktowane są jako preferencje (oferty z nimi są wyżej); jako wymaganie tylko wtedy, gdy wyraźnie o to prosisz. Gdy w wybranej miejscowości jest mało wolnych ofert, serwer dopisuje oferty z okolicy, oznaczone jako takie.

Przykłady: „Szukam noclegu w Krynicy-Zdroju 21–23 listopada dla dwóch osób, najlepiej ze śniadaniem.” · „Hotel nad morzem z basenem dla rodziny z dwójką dzieci (4 i 8 lat).”

`get_offer_details` — szczegóły oferty

Zwraca opis obiektu, udogodnienia, zdjęcia, ocenę, lokalizację, zakres cen za noc i link. Po podaniu terminu i składu grupy dodaje dostępność i cenę za pobyt.

Przykład: „Opowiedz mi więcej o drugiej ofercie.”

`check_availability` — dostępność i cena

Sprawdza dostępność i cenę za pobyt dla wybranych ofert (do 10) w podanym terminie, dla podanej liczby osób. Zwraca link do oferty, gdzie możesz zarezerwować lub zapytać gospodarza.

Przykład: „Sprawdź, czy te trzy obiekty są wolne 28–31 grudnia dla 4 osób.”

`searchAccommodations` — wyszukiwanie (starsza wersja)

Wyszukiwanie z jednego zdania w języku naturalnym, zachowane dla zgodności z wcześniejszą wersją aplikacji. Nowe integracje powinny używać search_accommodations.

Dane i prywatność

Przy każdym wywołaniu narzędzia zapisujemy do analizy jakości i ruchu: nazwę narzędzia, przekazane kryteria wyszukiwania (miejscowość, termin, liczba osób, życzenia), nazwę i wersję aplikacji klienckiej, język, liczbę zwróconych ofert, czas odpowiedzi i ewentualny błąd.
Serwer nie ma pól na dane osobowe, a opisy narzędzi proszą asystenta, by ich nie przekazywał (imię, e-mail, telefon). W zapisach wywołań nie przechowujemy adresu IP ani konta użytkownika; adres IP służy do ograniczania liczby zapytań.
Linki do ofert zawierają parametry utm_source, utm_medium=ai-app, utm_campaign=mcp, utm_content (nazwa narzędzia) i mcp_ref (identyfikator wywołania), dzięki którym noclegowo.pl wie, że wejście pochodzi z asystenta AI.
Po przejściu na noclegowo.pl obowiązują polityka prywatności i regulamin serwisu.

Ograniczenia

Aplikacja tylko wyszukuje i pokazuje oferty; nie rezerwuje i nie wysyła zapytań w Twoim imieniu. Rezerwacja i kontakt z gospodarzem odbywają się na stronie oferty na noclegowo.pl.
Dostępność i cena za pobyt są podawane tylko wtedy, gdy podasz termin (a cena — także liczbę osób). Cena oznaczona jako orientacyjna („cena orientacyjna — potwierdź u gospodarza”) nie jest ceną potwierdzoną.
Serwer obejmuje oferty z bazy noclegowo.pl w Polsce; liczba i zakres ofert zależą od zawartości bazy. Dane o udogodnieniach pochodzą z opisów i formularzy gospodarzy; gdy czegoś nie potwierdzono, oferta jest oznaczona („Nie mamy potwierdzenia…”).
Serwer ogranicza liczbę zapytań z jednego adresu.

Pomoc

Centrum pomocy: pomoc.noclegowo.pl · Serwis: noclegowo.pl

Asystent Noclegowo — documentation (English)

The MCP server of noclegowo.pl for ChatGPT and Claude. Server URL: https://ai.noclegowo.pl/mcp

What it is

Asystent Noclegowo is a remote MCP (Model Context Protocol) server that lets an AI assistant search accommodation in Poland in the noclegowo.pl database: hotels, guest houses, apartments, cottages, agritourism and more. The assistant passes the criteria from the conversation (place, dates, party, wishes) and the server returns offers with a guest rating, a link and — when you give dates — availability and the price for the stay.

Read-only. Every tool is marked read-only; the server books nothing, sends no inquiries to hosts and changes no data.
No sign-in. No account or authorization is needed.
You book or ask the host yourself on the offer page on noclegowo.pl — every offer carries a link.
Results are sorted by how well they match the query, availability, guest ratings and distance; they contain no paid promotions.

How to add it

ChatGPT: the app “Asystent Noclegowo” is published in ChatGPT (a new version is awaiting OpenAI review). Open the app directory in ChatGPT, search for “Asystent Noclegowo” and connect it (no noclegowo.pl sign-in). Describe what you need, e.g. “a cottage in Zakopane for a weekend for 4 people with a sauna”.

Claude: open Settings → Connectors, choose Add custom connector, enter the URL https://ai.noclegowo.pl/mcp (no authorization), enable the connector in a conversation and describe what you need. Clients that support MCP apps show offer cards; others get a list with links.

Tools

The server exposes four tools, all read-only. The assistant picks the tool itself; example prompts are given below.

`search_accommodations` — search

Searches offers by place, dates, adults and children (with ages), pets, amenities, budget and free-text wishes. Returns a few offers with rating, link and — when dates and party are given — availability and the price for the whole stay. Amenities mentioned in the conversation are treated as preferences (offers that have them come first); they are requirements only when you insist. When few offers are available in the requested town, offers from nearby localities are appended and labelled as such.

Examples: “Find a place in Krynica-Zdrój 21–23 November for two, ideally with breakfast.” · “A seaside hotel with a pool for a family with two children (4 and 8).”

`get_offer_details` — offer details

Returns the description, amenities, photos, rating, location, nightly price range and link. With dates and party it adds availability and the price for the stay.

Example: “Tell me more about the second offer.”

`check_availability` — availability and price

Checks availability and the price for the stay for chosen offers (up to 10) for given dates and party. Returns the offer link where you can book or ask the host.

Example: “Are these three places free 28–31 December for 4 people?”

`searchAccommodations` — search (legacy)

Single-sentence natural-language search, kept for compatibility with the earlier version of the app. New integrations should use search_accommodations.

Data and privacy

On every tool call we record, for quality and traffic analytics: the tool name, the search criteria passed (place, dates, party, wishes), the client app name and version, the language, the number of offers returned, the response time and any error.
The server has no fields for personal data and the tool descriptions ask the assistant not to pass any (name, e-mail, phone). The call records do not store an IP address or a user account; the IP address is used to rate-limit requests.
Offer links carry utm_source, utm_medium=ai-app, utm_campaign=mcp, utm_content (tool name) and mcp_ref (call id), so noclegowo.pl can tell that a visit came from an AI assistant.
On noclegowo.pl the site's privacy policy and terms apply (Polish).

Limitations

The app only searches and shows offers; it does not book or send inquiries on your behalf. Booking and contact with the host happen on the offer page on noclegowo.pl.
Availability and the stay price are given only when you provide dates (and, for the price, the party). A price marked as indicative (“cena orientacyjna — potwierdź u gospodarza”, i.e. confirm with the host) is not a confirmed price.
Coverage is the noclegowo.pl database in Poland; the number and range of offers depend on its content. Amenity data comes from hosts' descriptions and forms; when something is not confirmed the offer says so (“Nie mamy potwierdzenia…” — we have no confirmation).
The server rate-limits requests per address.

Support

Help centre: pomoc.noclegowo.pl (Polish) · Site: noclegowo.pl