flatin.pt — Portuguese homes: new-builds, places, taxes

Connect it to your AI

Claude Code

claude mcp add --transport http property-taxes https://flatin.pt/mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://flatin.pt/mcp

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "property-taxes": {
      "url": "https://flatin.pt/mcp"
    }
  }
}

Tools it offers

15 tools, as the server itself reported during our check on Oct 31, 2026.

• imt_calculateUse this when asked what a home purchase in Portugal costs on top of the price: IMT, stamp duty and Casa Pronta registration, by the 2026 tables. Do not use it for the yearly property tax (`imi_annual_cost`) or to define
• required_incomeUse this when asked what net monthly income and savings it takes to buy a home in Portugal at a given price, under the Banco de Portugal rules. Do not use it for the purchase taxes alone (`imt_calculate`).
• imi_rateUse this when only the yearly IMI (municipal property tax) rate of one Portuguese municipality is needed, by name or code, with its history by year. Do not use it for the yearly amount on a VPT (`imi_annual_cost`) or for
• imi_annual_costUse this when the yearly IMI amount on an urban property (prédio urbano) is needed, from its taxable value (VPT) and its municipality's urban rate. Do not use it for the rate alone (`imi_rate`) or for the one-off purchas
• request_consultationUse this when the person wants flatin.pt (licensed estate agency, AMI 28163) to contact them about buying a new-build apartment in Portugal. Do not use it to send the request (`submit_consultation`) or for emails about n
• submit_consultationUse this when the person has read the summary and consent text from `request_consultation` mode=prepare and explicitly agreed to send the request. Do not use it before that (`request_consultation`). Pass the same details
• subscribe_digestUse this when the person asks to be emailed about new-build projects matching a filter (daily) or new construction licensed in one municipality (weekly). Do not use it to have flatin.pt contact them (`request_consultatio
• where_to_liveUse this when the person is choosing a neighbourhood: a flatin.pt city guide's verdict area by area, with the reason, who each area suits and the sources. Do not use it for one municipality's figures (`municipality_stats
• municipality_statsUse this when the key figures of one of Portugal's 308 municipalities are needed, each with its source and date. They are the IMI rate and history, INE sale price per m² (actual sales), purchasing power, population, lice
• compare_municipalitiesUse this when the person is choosing between two to five Portuguese municipalities, with the same figures for each as `municipality_stats`. Do not use it for a single municipality (`municipality_stats`) or for the areas
• construction_barometerUse this when the question is how much is being built in Portuguese municipalities. It gives our monthly count of building-works cases entering licensing, where we collect them, and INE's yearly licensed buildings and ne
• municipality_housing_pipelineUse this when one municipality's housing pipeline from licence to completion is needed: cases, INE licences and completions, units for sale. Do not use it for monthly building activity (`construction_barometer`). Periods
• glossary_lookupUse this when asked what a Portuguese home-buying or tax term means (CPCV, escritura, VPT…), with where it comes up and the article of law with a link. Do not use it to calculate anything: purchase taxes are `imt_calcula
• search_newbuildsUse this when the person wants to find published new-build projects (empreendimentos) in Portugal on flatin.pt. Do not use it for one project's details (`get_newbuild` with its slug) or for how much is being built (`cons
• get_newbuildUse this when one new-build project in Portugal is needed in detail, by slug (from `search_newbuilds`) or page URL. It gives units and prices per typology, price history, delivery promises and how often they moved, build

Questions