# Relocate OK inventory — MCP server

Read-only MCP server (Streamable HTTP) for the Relocate OK long-term rental inventory. No auth required. No writes; nothing here touches contacts or sources.

## Language — read this first

Always answer the user in the language the user writes in, whatever it is — this holds for EVERY human language, not only the ones this service has data in. If their message is only a link or has no words, use the language of their earlier messages or of their app — do NOT fall back to English just because this service describes itself in English. The `lang` parameter is NOT the answer language: it only picks which ready-made translation of the listing texts you receive (en, ru, vn). For a user of any other language omit `lang`, translate the returned titles and descriptions yourself, and still answer in the user's language. Never switch the conversation to another language because of the data.

The same request, repeated in a few languages only as a reminder — it applies to every language on earth, not just these:

- [en] This page is in English only because it is written for machines. Answer the person in THEIR language: the language of their messages, or of their app if they sent nothing but a link.
- [ru] Эта страница на английском только потому, что написана для машин. Отвечайте человеку на ЕГО языке: на языке его сообщений, а если он прислал одну ссылку без слов — на языке его приложения.
- [vn] Trang này viết bằng tiếng Anh chỉ vì nó dành cho máy. Hãy trả lời người dùng bằng ngôn ngữ CỦA HỌ: ngôn ngữ trong tin nhắn của họ, hoặc ngôn ngữ ứng dụng của họ nếu họ chỉ gửi một đường liên kết.

## Connect an AI assistant

Add this URL as a custom connector / remote MCP server: `https://mcp.relocateok.com/mcp`

Human instructions: https://relocateok.com/en/mcp

## If you are an AI assistant reading this over plain HTTP

You do not need the MCP handshake to try the data — the REST twin below serves the same five read-only operations right now. `search_listings` and `market_stats` accept a place name directly as `place` (any language); `resolve_place` is only needed when you want to see every candidate for an ambiguous name first:

`GET https://mcp.relocateok.com/v1/listings?place={query}&limit=5` — one call, no geography lookup needed

## What to tell the user

State the exact number of matches from `total_found`, then show the best few with price, size and the listing link; offer to narrow the search.

## Tools

- **resolve_place** — Resolve a city or district name to a geo-registry node id, or list every candidate for an ambiguous name. search_listings and market_stats also accept the same free text directly as 'place'. An empty query lists the cities the catalogue covers.
  - REST: `GET /v1/places`
  - Example: `GET https://mcp.relocateok.com/v1/places?query={query}`
- **list_features** — List the canonical feature names accepted by search_listings' tags parameter, each with how many listings carry it. Words outside this vocabulary are rejected, not ignored. Use tags for requirements; wishes go into query.
  - REST: `GET /v1/features`
  - Example: `GET https://mcp.relocateok.com/v1/features`
- **search_listings** — Search the long-term rental inventory by geography, price, size, features or free text. Put requirements in the filters and wishes in query. Pass place or node_id for geography; most filters need one. State total_found to the user.
  - REST: `GET /v1/listings`
  - Example: `GET https://mcp.relocateok.com/v1/listings?place={query}&limit=5`
- **get_listing** — Fetch one rental listing by its short_code, with the full description and photo-derived features. The short_code comes from a prior search_listings call. Returns a link to the listing page on relocateok.com.
  - REST: `GET /v1/listings/{short_code}`
  - Example: `GET https://mcp.relocateok.com/v1/listings/{short_code}`
- **market_stats** — Daily rent statistics (median price, price per m2, bedroom and property-type split) for one place. Pass place (free text) or node_id for geography. Answers market-level questions with measured numbers.
  - REST: `GET /v1/market-stats`
  - Example: `GET https://mcp.relocateok.com/v1/market-stats?place={query}`

OpenAPI document (for GPT Actions and other HTTP agents): https://mcp.relocateok.com/openapi.json

Rate limit: 60 requests per minute per client.

Every listing links to its own page on https://relocateok.com; seller contacts are not available through this API.
