API, MCP и открытые данные
Те же числа, что на сайте, машиночитаемо: IMT и гербовый сбор при покупке, ставки IMI по всем 308 муниципалитетам. Без ключа и без регистрации.
Обновлено
HTTP-API
JSON поверх HTTPS, без аутентификации. Схема OpenAPI — в конце списка, её и читают инструменты.
GET |
/api/v1/barometer/official.csv |
The official INE series the barometer is checked against |
GET |
/api/v1/barometer/sce.csv |
ADENE energy-certificate statistics (SCE) for new housing |
GET |
/api/v1/barometer/series |
The same barometer series as JSON, with attribution |
GET |
/api/v1/barometer/series.csv |
Building-permit barometer: monthly case counts per municipality |
GET |
/api/v1/imi/rates |
IMI rates for all municipalities |
GET |
/api/v1/imi/rates-history.csv |
Every verified year of IMI rates in one CSV file |
GET |
/api/v1/imi/rates.csv |
The same rates as one CSV file |
GET |
/api/v1/imi/rates.geojson |
IMI rates with municipality boundaries (GeoJSON) |
GET |
/api/v1/imi/rates/{codigo} |
IMI rate of one municipality |
POST |
/api/v1/imt/calculate |
What a purchase costs on top of the price |
GET |
/api/openapi.json |
OpenAPI 3.1 |
MCP-сервер
Для ассистентов, которые вызывают инструменты. Транспорт Streamable HTTP, без сессий: шлите JSON-RPC методом POST на адрес ниже. На GET приходит 405 — потока SSE здесь нет, и спецификация это разрешает.
https://flatin.pt/mcp
Инструменты сервера
imt_calculate- What buying a home in Portugal costs on top of the price: IMT (property transfer tax), Imposto do Selo (stamp duty) and the published price of the property registration. Official 2026 tables, including the reduced IMT table and the stamp duty deduction for buyers aged 35 or under. Both taxes are charged on the higher of the contract price and the VPT: pass `vpt` when it is known. Returns amounts in cents and formatted in euros, with the source of the tables.
imi_rate- The yearly property tax (IMI) rate in one Portuguese municipality, by name or four-digit code. Collected from the Autoridade Tributária portal and checked line by line for all 308 municipalities. Where a municipality sets no single rate (it is set per parish), the answer says so instead of returning zero.
imi_annual_cost- Yearly IMI for an urban property (prédio urbano) with a given taxable value (VPT) in one municipality, at the municipality's urban rate. VPT is the tax authority's valuation, not the purchase price: ask the user for it instead of using the price.
request_consultation- How to put the user in touch with a licensed real estate agency in Portugal: returns the form link and the GDPR (RGPD) consent text in the user's language. The request is submitted by the person, not on their behalf.
Поддерживаемые ревизии протокола: 2025-06-18, 2025-11-25
Открытые данные
Ставки IMI всех муниципалитетов одним файлом под лицензией CC BY 4.0. Страница набора данных рассказывает, что внутри и когда числа сверялись.
Три правила
Числа в API — те же, что на сайте. Второй источник тех же чисел однажды разошёлся бы с первым.
В каждом ответе есть поле attribution: кто посчитал, по какой таблице и какого года, со ссылкой. Показывайте его читателю — число без источника проверить нельзя.
Частота ограничена: 120 запросов в минуту с адреса в REST и 60 в MCP. Отказ приходит кодом 429 и говорит, через сколько секунд вернуться. Весь набор отдаётся одним файлом — обходить его по одному муниципалитету не нужно.
Статус сервиса, журнал изменений и описания для машин (по-английски): Status · Changelog · Rate limits · APIs.json · llms.txt