flatin.pt — Portuguese homes: taxes, construction, new-builds
Server Details
An open MCP server for the Portuguese housing market, run by flatin.pt. No API key, no registration, no rate-limit negotiation.
Twelve tools:
• imt_calculate — IMT and Imposto do Selo on a purchase, 2026 tables, including the reduced table, the relief for buyers aged 35 or under and the flat rate for non-residents • imi_rate / imi_annual_cost — the IMI rate of any of the 308 municipalities for 2023–2025, and the annual bill for a given VPT • construction_barometer — how many building-permit cases enter a town hall each month (our own indicator: monthly for three municipalities, annual for eight, method and revision policy published) • search_newbuilds / get_newbuild — 250 new developments, 53 municipalities, 71 developers, with stage and, where published, price • where_to_live / municipality_stats / compare_municipalities — municipal comparisons • glossary_lookup — Portuguese property and tax terms • request_consultation / subscribe_digest — reaching a human
The data behind the tax tools is published as open data under CC BY 4.0 on the Portuguese national portal (dados.gov.pt) and archived on Zenodo with a permanent DOI. Anyone may reuse it.
Humans, not bots, answer the people who get in touch: a home purchase involves personal data under the GDPR and decisions that cannot be refunded.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Server Listing
- flatin
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 15 tools
Descriptions are unusually explicit about boundaries, with each tool naming the sibling tools it must not be used for (municipality_stats vs compare_municipalities vs where_to_live, imi_rate vs imi_annual_cost, request_consultation vs submit_consultation). There is residual overlap — municipality_stats already returns IMI rates and building cases that imi_rate and construction_barometer/municipality_housing_pipeline also serve — but the guidance reliably resolves it.
Uniform snake_case with no style drift, and most names are verb_noun or clean noun phrases (compare_municipalities, get_newbuild, search_newbuilds, glossary_lookup). A few names are bare noun phrases whose action is implicit (municipality_stats, construction_barometer, required_income, where_to_live), which is a minor deviation rather than an inconsistency.
Fifteen tools map cleanly onto distinct jobs in a rich domain: search/detail for new builds, three tax calculators plus income, four municipality data views, glossary, guide, and a two-step consultation plus digest. Every tool has a stated reason to exist and nothing appears redundant.
The surface covers discovery, detail, taxation, affordability, local data, and consent-gated contact/subscription flows without obvious dead ends. Gaps are minor but real: there is no unsubscribe/manage-digest operation and no way to retrieve or cancel a previously submitted consultation.
Publisher details
- Operator
- HOLY CHAOS, UNIPESSOAL LDA
- Operator website
- https://flatin.pt
- Vendor relationship
- Unknown
- Documentation
- https://flatin.pt/en/tools/api-and-data/
- Privacy policy
- Not provided
- Trust center
- Unknown
- Restrictions
- No API key, no account, no paid plan, no regional limits. Public rate limit: 120 requests per minute per IP address.
Available Tools
15 toolscompare_municipalitiesCompare 2 to 5 Portuguese municipalitiesARead-onlyIdempotentInspect
Use 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 inside one city (where_to_live). Names that point at the same municipality count once, and fewer than two distinct ones are refused (bad_count). One unknown or ambiguous name refuses the whole comparison.
Inputs: municipalities (required), language. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
construction_barometerConstruction activity by municipality (barometer)ARead-onlyIdempotentInspect
Use 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 new dwellings for all 308. Do not use it for other figures (municipality_stats). Without municipality it returns every municipality we collect and the panel index. measure and granularity change only our own series. A case is not a granted licence or a building.
Inputs: measure, language, granularity, municipality. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
get_newbuildGet one new-build project: prices, cost, nearbyARead-onlyIdempotentInspect
Use 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, building permits, the developer, the purchase cost and what is nearby. Do not use it to search (search_newbuilds) or for taxes at another price or for a non-resident (imt_calculate). The purchase cost is at the cheapest available unit or the developer's from-price, for a buyer tax resident in Portugal. primary_home and buyer_is_young change only the purchase cost. An unknown slug is refused (not_found). Cite the page URL, given in all seven site languages.
Inputs: slug (required), language, primary_home, buyer_is_young. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
glossary_lookupExplain a Portuguese home-buying termARead-onlyIdempotentInspect
Use 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_calculate, the yearly tax imi_annual_cost. Without term it lists all terms. A term without a translation comes in English; an unknown one is refused with close spellings, if any.
Inputs: term, language. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
imi_annual_costCalculate the yearly IMI from the taxable valueARead-onlyIdempotentInspect
Use 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 purchase taxes (imt_calculate). The VPT is the Tax Authority's valuation on the caderneta predial, not the price: ask the user for it. Only the urban rate is applied; rural property, AIMI and surcharges on vacant homes are not calculated. A municipality whose rate is set per parish is refused (rate_by_freguesia).
Inputs: vpt (required), municipality (required). Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
imi_rateLook up the IMI rate of a municipalityARead-onlyIdempotentInspect
Use 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 several municipalities side by side (compare_municipalities). Rates: Autoridade Tributária portal, all 308 municipalities. Where the rate is set per parish, the answer says so instead of giving a number.
Inputs: municipality (required). Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
imt_calculateCalculate IMT and stamp duty on a home purchaseARead-onlyIdempotentInspect
Use 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 a term such as VPT (glossary_lookup). Both taxes are charged on the higher of value and vpt: pass the VPT when known. tax_haven_company takes precedence over non_resident. buyer_is_young applies only when primary_home is true. For a non-resident buyer the answer says what the Tax Authority annuls later on request.
Inputs: value (required), vpt, territory, non_resident, +3 more. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
municipality_housing_pipelineHousing pipeline of one municipality: cases to completionsARead-onlyIdempotentInspect
Use 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 differ by stage; unknown is null, not 0.
Inputs: municipality (required), language. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
municipality_statsKey figures for one Portuguese municipalityARead-onlyIdempotentInspect
Use 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, licensed dwellings, building cases, new builds. Do not use it to compare places (compare_municipalities), inside a city (where_to_live) or for monthly building (construction_barometer). A figure that is not published is null, not estimated. A name matching two municipalities is refused with candidates.
Inputs: municipality (required), language. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
request_consultationPrepare a request to flatin.pt, a licensed estate agencyARead-onlyIdempotentInspect
Use 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 new projects (subscribe_digest). mode=link returns the form link and the consent text; mode=prepare checks the details and returns a summary, the GDPR (RGPD) consent text and a confirmation_token. Nothing is sent.
Inputs: city, mode, name, email, +16 more. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
required_incomeIncome and savings needed to buy a home at a priceARead-onlyIdempotentInspect
Use 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).
Inputs: price (required), territory. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
search_newbuildsSearch new-build projects in PortugalARead-onlyIdempotentInspect
Use 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 (construction_barometer). With typology, the budget applies to those typologies' prices; projects without a published price drop out when a budget is given. Pass next_offset as offset for the next page. A misspelt filter is refused, not ignored. Prices are as checked on developers' pages or agency listings, dated.
Inputs: sort, limit, stage, offset, +9 more. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
submit_consultationSend a prepared request to flatin.ptADestructiveIdempotentInspect
Use 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, the token, consent=true and consent_text_version; never set consent=true on your own. Changed details, a token under 5 seconds or over 30 minutes old, or an outdated consent version are refused.
Inputs: consent (required), confirmation_token (required), consent_text_version (required), city, +18 more. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
subscribe_digestSubscribe an email to new developments or constructionAIdempotentInspect
Use 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_consultation) or to see what is on sale now (search_newbuilds). Ask the person first; nothing is active until they click the confirmation email. city is required for construction and parish works only there; typology, the prices and on_sale work only with new_developments. The answer is the same whether or not the address was already subscribed: never say it was.
Inputs: email (required), city, what, client, +6 more. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
where_to_liveWhere to live in a Portuguese city, area by areaARead-onlyIdempotentInspect
Use 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) or for new homes there (search_newbuilds). Without city it lists the cities and regions that have a guide. profile narrows the areas but never hides the ones we advise against. Noise and safety come as dated, sourced facts: a place's reputation, never a claim about its people. Show the guide's link to the user.
Inputs: city, include, profile, verdict, +1 more. Returns: Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euro…
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Free MCP server with Bulgarian property prices, rental yields, deal costs and neighbourhood profiles
Unofficial MCP server for the public PortlandMaps property/permit/zoning API. Not city-affiliated.
Portugal PDM zoning with official sources. One free query per account; no purchases.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables users to calculate Portuguese property purchase costs (IMT, stamp duty, deed/registration) and query annual IMI rates and costs for all 308 municipalities, with sourced figures.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for accessing BPstat (Banco de Portugal) statistics API without API keys. Enables querying Portuguese central bank data through natural language.90 npmMIT
- AlicenseNot gradedqualityDmaintenanceUK property data MCP server for AI hosts (Claude, ChatGPT). Wraps Land Registry, Rightmove, EPC, rental yields, stamp duty, and Companies House into 13 tools.2MIT
- AlicenseAqualityBmaintenanceUK property data MCP server — Land Registry comps, EPC, Rightmove, rental yields, stamp duty, Companies House. 13 tools.1318MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.