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

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

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • 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

What data it sees

Do you need an account

No: the server works without sign-in

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

How to connect

How to connect erphome.pl — Short-Term Rental Booking API & MCP Server to Claude

The server address to paste into Claude settings:

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

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect erphome.pl — Short-Term Rental Booking API & MCP Server to ChatGPT

The server address to paste into ChatGPT settings:

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

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect erphome.pl — Short-Term Rental Booking API & MCP Server to Cursor

The server address to paste into Cursor settings:

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

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (10)

Raw names from tools/list. Only developers need these.

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.