API, MCP e dados abertos
Os mesmos números que estão no site, legíveis por máquina: IMT e Imposto do Selo na compra, taxas de IMI dos 308 municípios. Sem chave e sem registo.
Atualizado em
API HTTP
JSON sobre HTTPS, sem autenticação. O esquema OpenAPI está no fim desta lista e é lido por ferramentas.
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 |
Servidor MCP
Para assistentes que chamam ferramentas. Transporte Streamable HTTP, sem sessões: envie JSON-RPC por POST para o endereço abaixo. Um GET responde 405 — não há stream SSE aqui, e a especificação permite-o.
https://flatin.pt/mcp
Ferramentas do servidor
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.
Revisões do protocolo suportadas: 2025-06-18, 2025-11-25
Dados abertos
As taxas de IMI de todos os municípios num ficheiro, sob licença CC BY 4.0. A página do conjunto de dados explica o que está dentro e quando foi conferido.
Três regras
Os números da API são os mesmos que estão no site. Uma segunda fonte dos mesmos números acabaria por contradizer a primeira.
Cada resposta traz o campo attribution: quem calculou, por que tabela e de que ano, com ligação. Mostre-o a quem lê — um número sem fonte não é verificável.
A frequência é limitada: 120 pedidos por minuto por endereço no REST e 60 no MCP. A recusa chega com o código 429 e diz dentro de quantos segundos voltar. Todo o conjunto sai num ficheiro só — não é preciso percorrê-lo município a município.
Estado do serviço, histórico de alterações e descrições para máquinas (em inglês): Status · Changelog · Rate limits · APIs.json · llms.txt