Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@pt.flatin/property-taxes I'm buying a 250k flat in Lisbon. What are the purchase costs and annual IMI?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that answers the questions people ask before buying a home in Portugal: how much IMT and stamp duty on top of the price, and what yearly IMI rate a municipality sets — for all 308 municipalities, with the source and the year of every number.
It is run by flatin.pt and listed in the official MCP Registry as pt.flatin/property-taxes.
You: I'm buying a flat in Matosinhos for 280 000 €. What do I pay on top, and what's the IMI there?
Claude: [imt_calculate value="280000"] [imi_rate municipality="Matosinhos"]
IMT 9 142,04 €, stamp duty 2 240,00 €, deed and registration about 900 € —
12 282,04 € on top of the price.
IMI in Matosinhos (Porto): 0,37 % a year on the taxable value (VPT), 2025 table.
Source: Autoridade Tributária tables, computed by flatin.pt.Tool | What it answers |
| What a purchase costs on top of the price: IMT (transfer tax), Imposto do Selo (stamp duty) and an estimate for the deed and registration. Official 2026 tables, including the reduced IMT table and the stamp duty deduction for buyers aged 35 or under. |
| The yearly property tax (IMI) rate of one municipality, by name or four-digit code, with its history since 2023. Where a municipality sets no single rate (it is set per parish), the answer says so instead of returning zero. |
| Yearly IMI for an urban property with a given taxable value (VPT). VPT is the tax authority's valuation, not the purchase price. |
| How to reach a licensed real estate agency (AMI): the form link and the GDPR consent text in the user's language. The request is sent by the person, never on their behalf. |
Every successful answer carries an attribution field — who computed it, from which table and year, and a link to the primary source. Please show it to the user: numbers without a source cannot be checked.
Related MCP server: Portuguese Law MCP Server
The server is remote — nothing to install. Point your client at:
https://flatin.pt/mcpClaude Code
claude mcp add --transport http flatin https://flatin.pt/mcpClients that can only start a local process (stdio) — use the bridge in this repository. It needs Node.js 18.17 or newer and has no dependencies:
claude mcp add flatin -- npx -y github:devflatinpt/mcp{
"mcpServers": {
"flatin": {
"command": "npx",
"args": ["-y", "github:devflatinpt/mcp"]
}
}
}The bridge forwards each JSON-RPC message to https://flatin.pt/mcp and writes the answer back. It stores nothing and sends nothing except what your client sends. Set FLATIN_MCP_URL to point it elsewhere.
Docker
docker build -t flatin-mcp . && docker run -i --rm flatin-mcpIMI rates, all 308 municipalities, checked line by line against the Autoridade Tributária portal — open data page, CSV, licence CC BY 4.0.
IMT and stamp duty from the official 2026 tables — the same numbers as the IMT calculator.
REST API with the same functions: API and data · OpenAPI schema.
The MCP server, the API and the website call the same code, so the three never disagree by a cent.
In Portuguese: Comprar casa: custos e impostos · Calculadora de IMT
node --testThis repository is published from the flatin.pt codebase; issues and suggestions are welcome here.
MIT — see LICENSE. The data returned by the server is licensed separately under CC BY 4.0.
This server cannot be deployed
Portuguese property taxes: IMT on purchase and IMI rates for all 308 municipalities
Portugal PDM zoning with official sources. One free query per account; no purchases.
Property listings in Portugal: search, market stats, comparables, neighbourhoods.
Portugal real estate search — 224,000+ listings, commute times and market prices