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

> flatin.pt — Portuguese homes: new-builds, places, taxes is a free MCP server for maps and travel. Portuguese new-builds, municipality figures and purchase taxes as machine-readable data. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI
- **Website:** https://flatin.pt/en/tools/api-and-data/
- **Repository:** https://gitlab.com/flatin-pt-group/mcp
- **MCP Registry name:** pt.flatin/property-taxes
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel), [analytics and data](https://ai-powered.com/categories/analytics-and-data), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

The flatin.pt data layer behind this server is a free, keyless set of Portuguese housing data. It covers new-build developments with prices per typology and delivery dates, key figures per municipality from INE, a building-permit barometer, and IMI rates for all 308 municipalities.

A calculator endpoint works out what a purchase costs on top of the price (IMT and stamp duty), another covers mortgage payment, minimum income and cash at the deed, and municipalities can be compared two to five at a time. Where-to-live guides and a glossary of home-buying terms with law references are included, along with CSV, GeoJSON and monthly 'Obra nova' report exports. The operator is a licensed estate agency, and a consultation request endpoint sends a request to it. The registry entry shows both npm (flatin-mcp) and hosted options.

## Features

- **New-build search:** Projects with prices per typology, status and delivery dates.
- **Purchase tax calculation:** IMT and stamp duty on top of the price.
- **IMI rates:** Rates for all 308 municipalities, with history and GeoJSON.
- **Municipality comparison:** Compare 2 to 5 municipalities side by side.
- **Mortgage calculator:** Payment, minimum income and cash at the deed.
- **Open data exports:** CSV and JSON series for barometer, funnel and reports.

## Good for

- Estimate the full cost of buying a home in Portugal
- Compare municipalities for relocation
- Find new-build projects by price and delivery date
- Look up property tax rates for a municipality
- Explain a Portuguese home-buying term with its law reference

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://flatin.pt/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "property-taxes": {
      "type": "http",
      "url": "https://flatin.pt/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "property-taxes": {
      "serverUrl": "https://flatin.pt/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://flatin.pt/mcp
```

Enter a Name (for example "flatin.pt — Portuguese homes: new-builds, places, taxes"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "property-taxes": {
      "type": "http",
      "url": "https://flatin.pt/mcp"
    }
  }
}
```

## FAQ

### Does it need authentication?

The HTTP API is JSON over HTTPS with no authentication.

### How many municipalities have IMI rates?

All 308.

### Who runs it?

flatin.pt, which describes itself as a licensed estate agency.

### Can I install it locally?

The registry lists an npm package, flatin-mcp, as well as a hosted endpoint.

### Is flatin.pt — Portuguese homes: new-builds, places, taxes free?

Yes. flatin.pt — Portuguese homes: new-builds, places, taxes is free to use.

### How do I add flatin.pt — Portuguese homes: new-builds, places, taxes to Claude Code?

Run this command in your terminal: claude mcp add --transport http property-taxes https://flatin.pt/mcp

### What are the best alternatives to flatin.pt — Portuguese homes: new-builds, places, taxes?

The closest alternatives to flatin.pt — Portuguese homes: new-builds, places, taxes are Portugal (public data), Brazil Real Estate Transactions (ITBI), MCP, Deweloperuch MCP and NewHomeSearch.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Portugal (public data)](https://ai-powered.com/mcp/portugal-public-data): Portugal (public data) is a free MCP server for legal and government.
- [Brazil Real Estate Transactions (ITBI)](https://ai-powered.com/mcp/brazil-real-estate-transactions-itbi): Brazil Real Estate Transactions (ITBI) is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwep1jv4): MCP is an open-source MCP server for e-commerce.
- [Deweloperuch MCP](https://ai-powered.com/mcp/deweloperuch-mcp): Deweloperuch MCP is a free MCP server for analytics and data.
- [NewHomeSearch](https://ai-powered.com/mcp/newhomesearch): NewHomeSearch is a free MCP server for maps and travel.
- [A Corrida dos Bairros: preço do m² por bairro](https://ai-powered.com/mcp/a-corrida-dos-bairros-preco-do-m2-por-bairro): A Corrida dos Bairros: preço do m² por bairro is a free MCP server for analytics and data.
- [Prices, property, cars, movies, events and sports data (FR, ES, IT, AR, AU)](https://ai-powered.com/mcp/prices-property-cars-movies-events-and-sports-data-fr-es-it): Prices, property, cars, movies, events and sports data (FR, ES, IT, AR, AU) is a paid MCP server for finance and payments.
- [Imóveis à venda em São Paulo · itbisp.com](https://ai-powered.com/mcp/imoveis-a-venda-em-sao-paulo-itbisp-com): Imóveis à venda em São Paulo · itbisp.com is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/flatin-pt-portuguese-homes-new-builds-places-taxes
