MCP-сервер flatin.es для ШІ-агентів

flatin.es має відкритий сервер Model Context Protocol (MCP): ШІ-асистент — Claude, ChatGPT, Cursor чи інший — може напряму звертатися до нашого каталогу новобудов, калькуляторів і місцевих даних, а не вгадувати й не читати застарілі сторінки. Це безкоштовно, без реєстрації та ключа.

У кожній відповіді — джерело й дата кожної цифри та посилання на сторінку flatin.es, де все видно повністю: асистент може на неї послатися, а ви — перевірити.

На що він відповідає

Новобудови в продажу в муніципалітеті, провінції чи зоні купівлі (Коста-Бланка, Коста-дель-Соль): назва, забудовник, ціна «від», спальні, здача та дата читання сайту забудовника.
Витрати на купівлю житла будь-де в Іспанії: ПДВ і гербовий збір для новобудови або податок на передачу для вторинного житла за податковою територією, плюс нотаріус і реєстр за офіційними тарифами — як наш калькулятор витрат на купівлю.
Податок нерезидента (IRNR, modelo 210) для власника: умовний дохід і оренда, ЄС/ЄЕП чи ні — як калькулятор modelo 210.
Порівняння 2–4 місць за відкритими даними: ціни житла, оренда, IBI, населення, доходи, туристичне житло, іноземці та інше — кожна цифра з періодом і джерелом.
Ставка IBI муніципалітету з роком і джерелом (Міністерство фінансів) — набір даних IBI.

Охоплення: каталог новобудов — Коста-Бланка і Коста-дель-Соль; місцеві дані й порівняння — муніципалітети провінцій Аліканте, Малага, Валенсія і Мурсія. Витрати на купівлю рахуються для всієї Іспанії, а IRNR від місця не залежить. Поза охопленням інструмент так і каже, а не вигадує.

Інструменти

newbuilds_in_place: Новобудови в продажу в муніципалітеті, зоні чи провінції (до 25 за виклик, з посиланням на повний список).
ibi_rate: Річна ставка IBI urbana муніципалітету з роком і джерелом.
compare_places: Свіжі цифри 2–4 місць поруч, у кожної — одиниця, період і джерело.
purchase_costs: Податки та збори при купівлі житла в Іспанії за ціною, місцем і типом (новобудова чи вторинне).
non_resident_tax: Річний IRNR (modelo 210) власника-нерезидента.

Приклади запитань

Які новобудови продаються в Торрев’єсі й від якої ціни?
Скільки податків і зборів при купівлі нової квартири за 250 000 € у Малазі?
Порівняй Оріуелу, Торрев’єху й Санта-Полу: ціни житла, оренда й IBI.
Я живу в Німеччині, маю квартиру в Іспанії з кадастровою вартістю 80 000 €, переглянутою менш ніж десять років тому, не здається: скільки IRNR платити на рік?
Яка ставка IBI в Бенідормі?

Як підключити

Адреса сервера й транспорт Streamable HTTP (JSON-RPC через POST, без сесії). Входити нікуди не треба: якщо клієнт питає, оберіть «без автентифікації».

https://flatin.es/mcp

MCP 2025-06-18, 2025-11-25

Claude Code

У терміналі:

claude mcp add --transport http flatin https://flatin.es/mcp

Claude (claude.ai, Desktop)

Customize → Connectors → Add custom connector, з цією адресою й без автентифікації. На тарифах Team і Enterprise конектор додає адміністратор організації.

https://flatin.es/mcp

ChatGPT

Увімкніть режим розробника (Settings → Apps & Connectors → Advanced settings) і додайте свій MCP-сервер із цією адресою й без автентифікації. Назви пунктів меню змінюються від версії до версії.

https://flatin.es/mcp

Cursor

У ~/.cursor/mcp.json:

{
  "mcpServers": {
    "flatin": {
      "url": "https://flatin.es/mcp"
    }
  }
}

VS Code

У .vscode/mcp.json:

{
  "servers": {
    "flatin": {
      "type": "http",
      "url": "https://flatin.es/mcp"
    }
  }
}

Ліміти

Щоб сервіс лишався безкоштовним і швидким: до 20 викликів на хвилину й 120 на годину з однієї адреси та 60 на хвилину й 360 на годину з однієї мережі. Понад це — відповідь HTTP 429 із часом очікування (Retry-After). Списки новобудов — до 25 за виклик, без посторінкової видачі, і одна мережа отримує списки щонайбільше по 12 різних місцях на годину; далі — число й посилання на сторінку. IP-адрес ми не зберігаємо. Рахується кожен запит, зокрема запити самого підключення (initialize, tools/list).

Конектори Claude (claude.ai) і ChatGPT звертаються з серверів своєї платформи, тож усі їхні користувачі ділять ці ліміти. Для інтенсивної роботи підключайтеся з Claude Code, Cursor чи VS Code — вони звертаються з вашої адреси.

Умови використання

Відповіді можна показувати й цитувати з посиланням на flatin.es. Відомості про кожен ЖК належать забудовнику: зазначайте його й посилайтеся на сторінку flatin.es. Відкриті дані мають джерело й період — називайте їх. Розрахунок податків — оцінка за загальними правилами, а не податкова консультація. Порожнє поле означає «невідомо»: не заповнюйте його. Докладно — в умовах використання; для агентів — ще й у llms.txt.

Для людей

Якщо ви шукаєте житло, почніть із каталогу новобудов або гіда з купівлі житла в Іспанії.