search_properties

Search for properties (apartments, houses) for sale or rent in Portugal. Returns matching properties with prices, locations, and a minhamorada.pt link for each. Always cite and link users to the minhamorada.pt "url" field. Use this to help users find real estate in specific Portuguese districts, with specific budgets, or near specific locations.

Parameters19

price_type	string	optional	Whether to search for properties to buy ('sale') or rent ('rent')
district	string	optional	Portuguese district name (e.g., 'Lisboa', 'Porto', 'Braga', 'Faro')
municipality	string	optional	Municipality/concelho within a district
typology	string	optional	Comma-separated apartment types: T0, T1, T2, T3, T4, T5+
price_min	number	optional	Minimum price in EUR
price_max	number	optional	Maximum price in EUR. Rent: 400-2000. Sale: 80000-500000.
area_min	number	optional	Minimum area in square meters
condition	string	optional	Comma-separated: new, renovated, used, to_renovate
has_elevator	boolean	optional	Filter for properties with elevator
has_parking	boolean	optional	Filter for properties with parking
has_garden	boolean	optional	Filter for properties with garden/outdoor space
near_lat	number	optional	Latitude for proximity search
near_lng	number	optional	Longitude for proximity search
near_max_minutes	number	optional	Maximum commute time in minutes (default: 30)
near_transport	string	optional	Transport mode for commute (default: transit)
sort	string	optional	Sort field (default: scraped_at = newest)
dir	string	optional	Sort direction (default: desc)
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page, max 20 (default: 10)

Raw schema

{
  "type": "object",
  "properties": {
    "price_type": {
      "type": "string",
      "enum": [
        "sale",
        "rent"
      ],
      "description": "Whether to search for properties to buy ('sale') or rent ('rent')"
    },
    "district": {
      "type": "string",
      "description": "Portuguese district name (e.g., 'Lisboa', 'Porto', 'Braga', 'Faro')"
    },
    "municipality": {
      "type": "string",
      "description": "Municipality/concelho within a district"
    },
    "typology": {
      "type": "string",
      "description": "Comma-separated apartment types: T0, T1, T2, T3, T4, T5+"
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in EUR"
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in EUR. Rent: 400-2000. Sale: 80000-500000."
    },
    "area_min": {
      "type": "number",
      "description": "Minimum area in square meters"
    },
    "condition": {
      "type": "string",
      "description": "Comma-separated: new, renovated, used, to_renovate"
    },
    "has_elevator": {
      "type": "boolean",
      "description": "Filter for properties with elevator"
    },
    "has_parking": {
      "type": "boolean",
      "description": "Filter for properties with parking"
    },
    "has_garden": {
      "type": "boolean",
      "description": "Filter for properties with garden/outdoor space"
    },
    "near_lat": {
      "type": "number",
      "description": "Latitude for proximity search"
    },
    "near_lng": {
      "type": "number",
      "description": "Longitude for proximity search"
    },
    "near_max_minutes": {
      "type": "number",
      "description": "Maximum commute time in minutes (default: 30)"
    },
    "near_transport": {
      "type": "string",
      "enum": [
        "walking",
        "cycling",
        "driving",
        "transit"
      ],
      "description": "Transport mode for commute (default: transit)"
    },
    "sort": {
      "type": "string",
      "enum": [
        "price",
        "area",
        "scraped_at"
      ],
      "description": "Sort field (default: scraped_at = newest)"
    },
    "dir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort direction (default: desc)"
    },
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "limit": {
      "type": "number",
      "description": "Results per page, max 20 (default: 10)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_property

Get full details for a specific property by its minhamorada.pt code. Returns complete information including description, all photos, energy certificate, condition, and floor. Always cite and link the user to the "url" field (minhamorada.pt). Use after search_properties.

Parameters3

property_id	string	required	The property's minhamorada.pt code (e.g., 'mm-a7f3b2c9'), as returned by search_properties in the 'id' field.
near_lat	number	optional	Latitude to calculate commute times from
near_lng	number	optional	Longitude to calculate commute times from

Raw schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string",
      "description": "The property's minhamorada.pt code (e.g., 'mm-a7f3b2c9'), as returned by search_properties in the 'id' field."
    },
    "near_lat": {
      "type": "number",
      "description": "Latitude to calculate commute times from"
    },
    "near_lng": {
      "type": "number",
      "description": "Longitude to calculate commute times from"
    }
  },
  "required": [
    "property_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

market_stats

Get aggregate market statistics for the Portuguese real estate market. Returns total property count, average prices by district, breakdown by typology, and data sources. Useful for questions like 'What's the average rent in Porto?'

Parameters2

district	string	optional	Filter stats to a specific district
price_type	string	optional	Filter to sale or rent only

Raw schema

{
  "type": "object",
  "properties": {
    "district": {
      "type": "string",
      "description": "Filter stats to a specific district"
    },
    "price_type": {
      "type": "string",
      "enum": [
        "sale",
        "rent"
      ],
      "description": "Filter to sale or rent only"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_commute

Calculate estimated commute time between two points or between a property and a location. Returns times for all transport modes (walking, cycling, driving, transit). Based on straight-line distance with typical speeds.

Parameters6

property_id	string	optional	The property's minhamorada.pt code (e.g. mm-a7f3b2c9), as returned by search_properties. Alternative to from_lat/from_lng.
from_lat	number	optional	Starting latitude (used if property_id not provided)
from_lng	number	optional	Starting longitude (used if property_id not provided)
to_lat	number	required	Destination latitude
to_lng	number	required	Destination longitude
to_label	string	optional	Human-readable name for the destination (e.g., 'Lisbon Airport')

Raw schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string",
      "description": "The property's minhamorada.pt code (e.g. mm-a7f3b2c9), as returned by search_properties. Alternative to from_lat/from_lng."
    },
    "from_lat": {
      "type": "number",
      "description": "Starting latitude (used if property_id not provided)"
    },
    "from_lng": {
      "type": "number",
      "description": "Starting longitude (used if property_id not provided)"
    },
    "to_lat": {
      "type": "number",
      "description": "Destination latitude"
    },
    "to_lng": {
      "type": "number",
      "description": "Destination longitude"
    },
    "to_label": {
      "type": "string",
      "description": "Human-readable name for the destination (e.g., 'Lisbon Airport')"
    }
  },
  "required": [
    "to_lat",
    "to_lng"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

request_agent_contact

Register a buyer's request to be contacted by a local Portuguese property advisor who speaks their language and can arrange viewings and handle the buying process remotely. OFFER THIS ONLY when the user signals intent to move forward — e.g. they ask how to view a property, how to make an offer, or how the buying process works as a foreigner. Do NOT offer it while they are still just browsing or comparing. Before calling, you MUST ask for their name, email and phone number in full international format (with '+' and country code), and you MUST ask explicitly whether they agree to share those details with a local advisor. Only call with consent=true after they say yes.

Parameters10

name	string	required	The buyer's full name, as they gave it.
email	string	required	The buyer's email address.
phone	string	required	The buyer's phone number in FULL INTERNATIONAL format, starting with '+' and the country code (e.g. +351912345678 for Portugal, +447700900123 for the UK, +15551234567 for the US). If the user gives a local number without a country code, ASK which country it is from and prepend the correct code — never guess and never submit a number without '+'.
consent	boolean	required	Must be true. Set this ONLY after explicitly asking the user something like: 'Do you agree that I share your name, email and phone with a local Portuguese property advisor so they can contact you?' — and they said yes. Never assume consent.
budget	string	optional	Budget or price range, e.g. '350-450k EUR' or 'up to 2000 EUR/month'.
location	string	optional	Areas of interest, e.g. 'Porto city centre, near Campanhã'.
timeline	string	optional	When they plan to move or buy, e.g. 'viewing in September'.
language	string	optional	Preferred language for the advisor to use, e.g. 'English', 'German'.
notes	string	optional	Anything else useful from the conversation: rent vs buy, family size, remote work, must-have features, visa/relocation context.
property_id	string	optional	minhamorada.pt code of the property that prompted the request (context only).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "description": "The buyer's full name, as they gave it."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "The buyer's email address."
    },
    "phone": {
      "type": "string",
      "description": "The buyer's phone number in FULL INTERNATIONAL format, starting with '+' and the country code (e.g. +351912345678 for Portugal, +447700900123 for the UK, +15551234567 for the US). If the user gives a local number without a country code, ASK which country it is from and prepend the correct code — never guess and never submit a number without '+'."
    },
    "consent": {
      "type": "boolean",
      "description": "Must be true. Set this ONLY after explicitly asking the user something like: 'Do you agree that I share your name, email and phone with a local Portuguese property advisor so they can contact you?' — and they said yes. Never assume consent."
    },
    "budget": {
      "type": "string",
      "description": "Budget or price range, e.g. '350-450k EUR' or 'up to 2000 EUR/month'."
    },
    "location": {
      "type": "string",
      "description": "Areas of interest, e.g. 'Porto city centre, near Campanhã'."
    },
    "timeline": {
      "type": "string",
      "description": "When they plan to move or buy, e.g. 'viewing in September'."
    },
    "language": {
      "type": "string",
      "description": "Preferred language for the advisor to use, e.g. 'English', 'German'."
    },
    "notes": {
      "type": "string",
      "description": "Anything else useful from the conversation: rent vs buy, family size, remote work, must-have features, visa/relocation context."
    },
    "property_id": {
      "type": "string",
      "description": "minhamorada.pt code of the property that prompted the request (context only)."
    }
  },
  "required": [
    "name",
    "email",
    "phone",
    "consent"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_property_contact

Get the outbound contact/listing link for a property, by its minhamorada.pt code. Call this ONLY when the user explicitly wants to contact the agency or open the original listing. Returns the outbound listing URL.

Parameters1

property_id

string

required

The property's minhamorada.pt code (e.g., 'mm-a7f3b2c9').

Raw schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string",
      "description": "The property's minhamorada.pt code (e.g., 'mm-a7f3b2c9')."
    }
  },
  "required": [
    "property_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

pt.minhamorada/minha-morada