erphome.pl — Short-Term Rental Booking API & MCP Server

erphome.pl is an MCP-native booking API for short-term rental owners.

От сообществаРаботаетБез входаГлобальныйБесплатноМожет изменять данные

Что умеет

  • Whoami: Identify the account behind this token. Works with any valid token regardless of scope — call it first to confirm the connection and see which account (slug, status, owner e-mail) you're talki
  • List Apartments: List the account's apartments and their ids. Call this before any tool that takes apartment_id — get_stats requires it, the rest treat it as an optional filter.
  • List Reservations: List reservations across the account's apartments, newest first, cursor-paginated. from/to filter by stay date (check-out after from, check-in before to), not by when the reservatio

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

erphome.pl is an MCP-native booking API for short-term rental owners. It exposes reservations, availability, pricing, guest reviews and monthly stats via the Model Context Protocol, so agents in Claude, ChatGPT, Cursor or any MCP-compatible client can answer questions like "how many nights are booked in August" or "what was revenue this month" without the owner writing a line of code.

MCP tools: list_apartments, list_reservations, get_reservation, get_availability, list_blocks, get_pricing, get_stats, list_reviews, list_reservation_messages, whoami.

Authentication: OAuth 2.1 with PKCE (RFC 8414 discovery, RFC 7591 dynamic client registration, RFC 9728 protected-resource metadata) or a static scoped Bearer token issued from the owner's dashboard.

Transport: Streamable HTTP (JSON-RPC 2.0). Structurally read-only — no tool can create, edit or cancel a reservation, by design.

Docs & trial: https://erphome.pl/en/api-rezerwacji-apartamentow

Как подключить

Как подключить erphome.pl — Short-Term Rental Booking API & MCP Server к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://erphome--hubert-blazniak.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить erphome.pl — Short-Term Rental Booking API & MCP Server к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://erphome--hubert-blazniak.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить erphome.pl — Short-Term Rental Booking API & MCP Server к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://erphome--hubert-blazniak.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (10)

Технические названия из tools/list. Нужны только разработчикам.

whoamiIdentify the account behind this token. Works with any valid token regardless of scope — call it first to confirm the connection and see which account (slug, status, owner e-mail) you're talking to.
list_apartmentsList the account's apartments and their ids. Call this before any tool that takes apartment_id — get_stats requires it, the rest treat it as an optional filter.
list_reservationsList reservations across the account's apartments, newest first, cursor-paginated. from/to filter by stay date (check-out after from, check-in before to), not by when the reservation was created.
get_reservationGet a single reservation by id.
list_reservation_messagesMessage history for one reservation — everything sent to the guest, automatic mail included. The same thread the panel shows.
get_availabilityOccupied check-in/check-out date ranges, no guest data. Defaults to today through +365 days; the range cannot exceed 366 days.
list_blocksOwner-created blocked date ranges (maintenance, personal use). Not reservations — no guest, no price.
get_pricingSeasonal price overrides, minimum-stay rules and extra fees — the pricing configuration, not a computed quote. The base nightly rate lives on the apartment record (see list_apartments), not here.
list_reviewsGuest reviews, including unapproved ones by default (same as the panel). Pass approved_only to match what is actually published on the booking page.
get_statsMonthly occupancy and revenue for one apartment, confirmed reservations only — the same numbers as the panel's Statystyki page. apartment_id is required: occupancy/revenue from apartments with different nightly rates can't be meaningfully summed.