MCP Server

Metastate · Imóveis em Portugal

pt.metastate/imoveis
Finance & Investing Real Estate Public & reachable MCP 2026-07-28

What this MCP does

Searches Portuguese property listings, provides market prices and buying guidance, calculates purchase costs, and supports valuations and viewing requests.

calcular_custos_compra
Home purchase costs in Portugal / Custos de comprar casa
Calculates the taxes and fees of buying a home in mainland Portugal with the official 2026 rates: IMT transfer tax (primary residence, second home, or under-35 exemption), stamp duty 0.8% and land registry (Casa Pronta). / Calcula IMT, imposto do selo e registo com as tabelas de 2026.
Read only
Input schema
{'type': 'object', 'required': ['preco_eur'], 'properties': {'preco_eur': {'type': 'number', 'description': 'Purchase price in euros'}, 'finalidade': {'enum': ['habitacao_propria', 'secundaria'], 'type': 'string', 'description': "habitacao_propria = buyer's permanent home; secundaria = second home, investment or rental"}, 'com_credito': {'type': 'boolean', 'description': 'true if financed with a mortgage (registry fee is higher)'}, 'comprador_ate_35': {'type': 'boolean', 'description': 'true if all buyers are 35 or younger and it is their permanent home (IMT exemption up to 330,539 €)'}}}
Output schema
{'type': 'object', 'properties': {'fonte': {'type': 'string'}, 'imt_eur': {'type': 'number'}, 'total_eur': {'type': 'number'}, 'registo_eur': {'type': 'number'}, 'imposto_selo_eur': {'type': 'number'}}}
consultar_guia_estrangeiro
Buying property in Portugal as a foreigner / Comprar sendo estrangeiro
Step-by-step guide for foreigners buying property in Portugal: NIF tax number, bank account, promissory contract (CPCV), taxes, deed, and the current Golden Visa rules (real estate no longer qualifies since Law 56/2023). / Passos para um estrangeiro comprar casa em Portugal.
Read only
Input schema
{'type': 'object', 'properties': {'idioma': {'enum': ['en', 'pt'], 'type': 'string', 'description': 'Answer language (default en)'}}}
Output schema
{'type': 'object', 'properties': {'link': {'type': 'string'}, 'passos': {'type': 'array', 'items': {'type': 'string'}}, 'golden_visa': {'type': 'string'}}}
consultar_precos_mercado
Official house prices per m² / Preços de mercado (INE)
Official median sale price per m² of homes sold, from Statistics Portugal (INE), for Lisbon, Cascais, Oeiras, Lisbon parishes and Portugal, plus buyer-origin and new-vs-existing splits. / Preço mediano por m² das casas vendidas, segundo o INE.
Read only
Input schema
{'type': 'object', 'properties': {'zona': {'type': 'string', 'description': 'Municipality or Lisbon parish, e.g. Cascais, Oeiras, Lisboa, Avenidas Novas, Parque das Nações. Empty = overview'}}}
Output schema
{'type': 'object', 'properties': {'zona': {'type': ['string', 'null']}, 'dados': {'type': 'array', 'items': {'type': 'object'}}, 'fonte': {'type': 'string'}, 'eur_m2': {'type': ['number', 'null']}, 'periodo': {'type': 'string'}}}
falar_com_consultor
Talk to a consultant / Falar com um consultor
Leaves a contact request for a Metastate consultant (buy, sell, rent or other), in Portuguese, English, Spanish or French. / Deixa um pedido de contacto para um consultor.
Open world
Input schema
{'type': 'object', 'required': ['nome', 'mensagem', 'consentimento_rgpd'], 'properties': {'nome': {'type': 'string', 'description': "User's name"}, 'email': {'type': 'string', 'description': "User's email"}, 'mensagem': {'type': 'string', 'description': 'What the user is looking for or wants to know'}, 'telefone': {'type': 'string', 'description': "User's phone with country code"}, 'interesse': {'enum': ['comprar', 'vender', 'arrendar', 'outro'], 'type': 'string', 'description': 'comprar = buy, vender = sell, arrendar = rent, outro = other'}, 'assistente': {'type': 'string', 'description': 'Name of the assistant/agent (optional)'}, 'referencia': {'type': 'string', 'description': 'Related property reference (optional)'}, 'consentimento_rgpd': {'type': 'boolean', 'description': "Required. true only if the user agreed to Metastate's privacy policy (https://metastate.pt/privacidade) to be contacted; ask them first. / Obrigatório: true só se o utilizador aceitou a Política de Privacidade para ser contactado."}}}
Output schema
{'type': 'object', 'properties': {'imovel': {'type': ['string', 'null']}, 'consultor': {'type': 'string'}, 'registado': {'type': 'boolean'}}}
fetch
Fetch a Metastate property or guide
Full content of a search result by id (property listing details or guide text), with its canonical URL for citation.
Read only
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Id returned by search, e.g. imovel:t3-quinta-dos-alcoutins-venda or guia:custos'}}}
Output schema
{'type': 'object', 'required': ['id', 'title', 'text', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object'}}}
marcar_visita
Request a viewing / Pedir visita
Registers a viewing request for a property. The property's consultant contacts the user to confirm date and time (the viewing is not confirmed automatically). / Regista um pedido de visita; o consultor confirma com o cliente.
Open world
Input schema
{'type': 'object', 'required': ['referencia', 'nome', 'consentimento_rgpd'], 'properties': {'nome': {'type': 'string', 'description': "User's name (the person to be contacted)"}, 'email': {'type': 'string', 'description': "User's email (phone or email required)"}, 'mensagem': {'type': 'string', 'description': 'Anything the consultant should know'}, 'telefone': {'type': 'string', 'description': "User's phone with country code (phone or email required)"}, 'assistente': {'type': 'string', 'description': 'Name of the assistant/agent making the request (optional)'}, 'referencia': {'type': 'string', 'description': 'Property reference (META-…) or slug'}, 'dia_preferido': {'type': 'string', 'description': 'Preferred date, YYYY-MM-DD'}, 'hora_preferida': {'type': 'string', 'description': 'Preferred time, HH:MM (optional)'}, 'consentimento_rgpd': {'type': 'boolean', 'description': "Required. true only if the user agreed to Metastate's privacy policy (https://metastate.pt/privacidade) to be contacted; ask them first. / Obrigatório: true só se o utilizador aceitou a Política de Privacidade para ser contactado."}}}
Output schema
{'type': 'object', 'properties': {'imovel': {'type': ['string', 'null']}, 'consultor': {'type': 'string'}, 'registado': {'type': 'boolean'}}}
pedir_avaliacao
Property valuation / Avaliar um imóvel
Indicative sale value range for a property in Portugal from comparable listings in Metastate's portfolio, and a follow-up from a consultant for a full valuation with a visit. / Estimativa de valor e contacto de um consultor.
Open world
Input schema
{'type': 'object', 'required': ['zona', 'area_m2', 'nome', 'contacto', 'consentimento_rgpd'], 'properties': {'nome': {'type': 'string', 'description': "Owner's name"}, 'zona': {'type': 'string', 'description': 'Municipality or area, e.g. Cascais'}, 'estado': {'type': 'string', 'description': 'Condition: new, renovated, good, needs work'}, 'extras': {'type': 'string', 'description': 'e.g. balcony, garage, sea view, pool'}, 'area_m2': {'type': 'number', 'description': 'Gross private area in m²'}, 'contacto': {'type': 'string', 'description': "Owner's phone or email"}, 'tipologia': {'type': 'string', 'description': 'Layout code, e.g. T3, V4'}, 'consentimento_rgpd': {'type': 'boolean', 'description': "Required. true only if the user agreed to Metastate's privacy policy (https://metastate.pt/privacidade) to be contacted; ask them first. / Obrigatório: true só se o utilizador aceitou a Política de Privacidade para ser contactado."}}}
Output schema
{'type': 'object', 'properties': {'registado': {'type': 'boolean'}, 'amostra_zona': {'type': ['number', 'null']}, 'estimativa_max_eur': {'type': 'number'}, 'estimativa_min_eur': {'type': 'number'}}}
pesquisar_imoveis
Search Metastate properties / Pesquisar imóveis
Search available homes and commercial properties in Metastate's live portfolio in Portugal (Lisbon, Cascais, Sintra, Oeiras…), for sale or rent. Returns reference, title, operation, price (or monthly rent), type, size, area and listing link. / Procura imóveis disponíveis na carteira da Metastate, para venda ou arrendamento.
Read only
Input schema
{'type': 'object', 'properties': {'zona': {'type': 'string', 'description': 'Municipality, area or neighbourhood, e.g. Lisboa, Cascais, Oeiras, Sintra, Estoril'}, 'texto': {'type': 'string', 'description': 'Free keywords, e.g. river view, golf, office'}, 'idioma': {'enum': ['en', 'pt'], 'type': 'string', 'description': 'Language of the text answer and listing links: en (default) or pt'}, 'jardim': {'type': 'boolean', 'description': 'true = only properties with garden or outdoor space'}, 'limite': {'type': 'number', 'description': 'Max results (1-20, default 10)'}, 'garagem': {'type': 'boolean', 'description': 'true = only properties with garage or parking'}, 'piscina': {'type': 'boolean', 'description': 'true = only properties with a pool'}, 'area_min': {'type': 'number', 'description': 'Minimum gross private area in m²'}, 'operacao': {'enum': ['venda', 'arrendamento'], 'type': 'string', 'description': 'venda = buy, arrendamento = rent'}, 'preco_max': {'type': 'number', 'description': 'Maximum price in euros (monthly rent for rentals)'}, 'preco_min': {'type': 'number', 'description': 'Minimum price in euros (monthly rent for rentals)'}, 'tipologia': {'type': 'string', 'description': 'Portuguese layout code: T2 = 2-bedroom flat, T3, V4 = 4-bedroom house'}, 'quartos_min': {'type': 'number', 'description': 'Minimum number of bedrooms'}}}
Output schema
{'type': 'object', 'properties': {'total': {'type': 'number'}, 'imoveis': {'type': 'array', 'items': {'type': 'object'}}}}
search
Search Metastate (properties and guides)
Free-text search over Metastate's live property portfolio in Portugal and its guides (INE house prices, purchase costs, buying as a foreigner). Returns ids, titles and canonical URLs; use fetch with an id for the full content. Standard search/fetch interface for ChatGPT deep research.
Read only
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Natural-language query, e.g. '3 bedroom for sale in Lisbon with garage' or 'IMT costs'"}}}
Output schema
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}}}}}}
ver_imovel
Property details / Ficha do imóvel
Full details of one Metastate property by reference (e.g. META-003) or slug: price, size, rooms, energy class, features, description, consultant and link. / Ficha completa de um imóvel pela referência ou slug.
Read only
Input schema
{'type': 'object', 'required': ['referencia'], 'properties': {'referencia': {'type': 'string', 'description': 'Reference (META-…) or slug returned by pesquisar_imoveis'}}}
Output schema
{'type': 'object', 'properties': {'url': {'type': 'string'}, 'titulo': {'type': 'string'}, 'operacao': {'type': 'string'}, 'preco_eur': {'type': ['number', 'null']}, 'referencia': {'type': 'string'}, 'preco_texto': {'type': 'string'}}}
Added
falar_com_consultor
Sept. 30, 2026, 2:40 a.m.
Added
pedir_avaliacao
Sept. 30, 2026, 2:40 a.m.
Added
marcar_visita
Sept. 30, 2026, 2:40 a.m.
Added
consultar_guia_estrangeiro
Sept. 30, 2026, 2:40 a.m.
Added
consultar_precos_mercado
Sept. 30, 2026, 2:40 a.m.
Added
calcular_custos_compra
Sept. 30, 2026, 2:40 a.m.
Added
ver_imovel
Sept. 30, 2026, 2:40 a.m.
Added
pesquisar_imoveis
Sept. 30, 2026, 2:40 a.m.
Added
fetch
Sept. 30, 2026, 2:40 a.m.
Added
search
Sept. 30, 2026, 2:40 a.m.

Superlógica Condomínios

io.github.mcp-dir/superlogica-mcp

Connects to a condominium ERP for billing, collections, agreements, expenses, bank movements, statements, files, communications, …

DFX Real Estate Intelligence

io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt

Provides US commercial real estate, parcel, debt maturity, bank CRE exposure, private capital, investor, ownership, occupancy, an…

RateAPI — live US mortgage, auto, HELOC, personal & deposit rates

dev.rateapi/mcp

Supplies live US lending and deposit rates, financing comparisons, affordability and amortization calculations, eligibility check…

Rafid Intelligence Network

io.github.iabdullahm/rafid-agent-api

Analyzes Oman properties using rental comparables, yields, costs, and payback metrics, and supports Oman company search, profilin…

Housing Intel

io.github.pipeworx-io/housing-intel

Analyzes housing markets, affordability, mortgage rates, rental yields, property data, employment, metro demand, and investment s…

OpenLMNP

io.github.manganate006/openlmnp

Manages French LMNP furnished-rental accounting, including income, expenses, depreciation, loans, VAT, fiscal calculations, FEC f…

Antevo Wealth

ch.antevo/wealth

Aggregates household wealth data across investments, liabilities, credit facilities, real assets, markets, risk, exposure, and fi…

DataPorium

tech.dataporium/mcp

Provides market and company data covering stocks, ETFs, crypto, forex, commodities, economic indicators, housing, property listin…