Koskamo

Voxhouses MCP

An official MCP server provided by Voxhouses that enables AI agents to search real estate listings, retrieve property details, access market statistics, find similar properties, explore neighborhood guides, and search editorial articles in real-time without authentication.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Voxhouses MCP logo, by VoxhousesVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-06Operated by Voxhouses
MCP endpoint (Streamable HTTP)
https://www.voxhouses.pt/api/mcp
Vendor documentation

What its tools do

7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (7)

7 of 7 have a description · 7 of 7 declare behavior hints · 7 of 7 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to voxs.eu ·
  • Passed Endpoint and vendor documentation share a domain
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search for properties for sale or rent using filters
  • Retrieve detailed information about specific properties
  • Access market statistics and neighborhood guides
  • Find similar properties based on description

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: eu.voxs/voxhouses-pt@1.0.0Project website

Protocol and capabilities

Server
voxhouses-pt 1.0.0
MCP protocol negotiated in check
2024-11-05
Tools
7 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Tools

7 advertised

search_properties
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search current residential, rural and commercial real-estate listings for sale or rent in Portugal. Use this whenever the user wants to find, compare or explore properties — by location, budget, typology, property type, condition or energy rating. Returns price, price per m², typology, areas, neighbourhood, source and a citable listing URL, plus `total`: the exact number of listings matching the filters, which makes this tool usable to answer 'how many' questions. Listings are aggregated from portals and agency sites and refreshed continuously; each result carries the date it was last checked at the source. Sources publish uneven detail: filtering on an attribute silently excludes listings that omit it, so prefer the broadest filters that answer the question and report `total` as a floor, not a census.

search_properties input schema
{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "1-based page number. Use it with `total` to walk through a large result set."
    },
    "sort": {
      "enum": [
        "recent",
        "price_asc",
        "price_desc"
      ],
      "type": "string",
      "description": "Result order. Default `recent` (most recently published first)."
    },
    "limit": {
      "type": "number",
      "description": "Results per page (default 10, max 20)."
    },
    "minArea": {
      "type": "number",
      "description": "Minimum floor area in m². Matches either the gross or the useful area, whichever the source published. Only matches listings that published an area."
    },
    "location": {
      "type": "string",
      "description": "Location: district, municipality, neighbourhood, town or postal-code prefix (e.g. Lisbon, Cascais, Chiado, 2750). Not a free-text keyword search — words that are not places (e.g. 'sea view') will not match."
    },
    "priceMax": {
      "type": "number",
      "description": "Maximum price, in the market currency. Note: listings advertised 'price on request' have no price and are excluded by either price bound."
    },
    "priceMin": {
      "type": "number",
      "description": "Minimum price, in the market currency."
    },
    "typology": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "Normalised typology code (T0, T1, T2, T3…), where the number is the count of bedrooms. Used in every market, including the German and Polish ones. Matched exactly; pass an array to match several. The buckets `T0–T1` and `T4+` are also accepted."
    },
    "condition": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "enum": [
          "new",
          "used",
          "to_renovate",
          "under_construction"
        ],
        "type": "string"
      },
      "description": "State of repair, or an array of states. Only matches listings whose source published it."
    },
    "operation": {
      "enum": [
        "buy",
        "rent"
      ],
      "type": "string",
      "description": "buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both."
    },
    "energyClass": {
      "enum": [
        "A++",
        "A+",
        "A",
        "B",
        "B-",
        "C",
        "D",
        "E",
        "F",
        "G",
        "H"
      ],
      "type": "string",
      "description": "Energy certificate class. Selects the whole band the class belongs to: A+/A, B/B-, C, or D-and-below. Only matches listings that carry a certificate."
    },
    "minBathrooms": {
      "type": "number",
      "description": "Minimum number of bathrooms. Only matches listings whose source published a bathroom count."
    },
    "propertyType": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "enum": [
          "apartment",
          "house",
          "land",
          "shop",
          "office",
          "warehouse",
          "garage",
          "farm",
          "building"
        ],
        "type": "string"
      },
      "description": "Property type, or an array of types. Omit to search all types. `farm` covers rural estates (quintas); `building` is a whole apartment block."
    }
  }
}
search_properties output schema
{
  "type": "object",
  "required": [
    "market",
    "total",
    "page",
    "hasMore",
    "properties"
  ],
  "properties": {
    "page": {
      "type": "number"
    },
    "shown": {
      "type": "number",
      "description": "Listings returned on this page."
    },
    "total": {
      "type": "number",
      "description": "Exact number of listings in this market matching the filters, across all pages."
    },
    "market": {
      "type": "string",
      "description": "ISO country code of this market."
    },
    "hasMore": {
      "type": "boolean",
      "description": "true when further pages are available."
    },
    "currency": {
      "type": "string"
    },
    "pageSize": {
      "type": "number"
    },
    "operation": {
      "enum": [
        "comprar",
        "arrendar"
      ],
      "type": "string",
      "description": "The operation actually searched (comprar = for sale, arrendar = to let)."
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "slug",
          "url",
          "title",
          "operation",
          "sourceUrl",
          "firstSeen",
          "lastSeen"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Canonical listing page on this market's domain."
          },
          "slug": {
            "type": "string",
            "description": "Stable identifier; use it in get_property_detail."
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "null means the source does not publish a price (on request)."
          },
          "title": {
            "type": "string"
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Portal or agency site the listing came from; null when published directly with us."
          },
          "bedrooms": {
            "type": "number"
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code of this market."
          },
          "district": {
            "type": "string",
            "description": "District or region."
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Amenities as published by the source (Portuguese labels)."
          },
          "landArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Plot area in m²; relevant for houses, land and farms."
          },
          "lastSeen": {
            "type": "string",
            "description": "ISO 8601 date we last confirmed the listing at the source."
          },
          "typology": {
            "type": "string",
            "description": "T-notation typology (T0…T6+); empty when unknown."
          },
          "verified": {
            "type": "boolean",
            "description": "Advertiser identity verified by us."
          },
          "bathrooms": {
            "type": "number"
          },
          "firstSeen": {
            "type": "string",
            "description": "ISO 8601 date the listing was first published."
          },
          "houseArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Gross floor area in m²."
          },
          "operation": {
            "enum": [
              "comprar",
              "arrendar"
            ],
            "type": "string",
            "description": "comprar = for sale, arrendar = to let."
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original listing URL at the source. Cite this alongside url."
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 date the record last changed on our side."
          },
          "priceLabel": {
            "type": "string",
            "description": "Formatted price for display; empty when price is null."
          },
          "pricePerM2": {
            "type": [
              "number",
              "null"
            ]
          },
          "usefulArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Net/usable floor area in m²."
          },
          "energyClass": {
            "type": [
              "string",
              "null"
            ]
          },
          "municipality": {
            "type": [
              "string",
              "null"
            ],
            "description": "Municipality (LAU) name."
          },
          "propertyType": {
            "enum": [
              "apartment",
              "house",
              "land",
              "shop",
              "office",
              "warehouse",
              "garage",
              "farm",
              "building",
              null
            ],
            "type": [
              "string",
              "null"
            ],
            "description": "Property type; the same token accepted by the propertyType filter."
          },
          "neighbourhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Neighbourhood, when the source located the listing precisely enough."
          }
        }
      }
    }
  }
}
search_properties annotations
{
  "title": "Search properties in Portugal",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_properties_by_description
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search Portugal listings by describing the property in plain language, matched against listing text by meaning rather than keywords. Use this for wants that are not filter fields — 'a renovated loft with exposed brick', 'quiet, lots of natural light, close to a school', 'a ruin to restore with a sea view'. Prefer search_properties when the request is entirely structural (typology, budget, location), and this tool when it is descriptive; combine both by passing structural filters here too, which are applied as hard constraints while the description only ranks. Results are ordered by relevance, so `total` is the number matching the structural filters, not the number that fit the description.

search_properties_by_description input schema
{
  "type": "object",
  "required": [
    "description"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 10, max 20)."
    },
    "minArea": {
      "type": "number",
      "description": "Minimum floor area in m². Matches either the gross or the useful area, whichever the source published. Only matches listings that published an area."
    },
    "location": {
      "type": "string",
      "description": "Location: district, municipality, neighbourhood, town or postal-code prefix (e.g. Lisbon, Cascais, Chiado, 2750). Not a free-text keyword search — words that are not places (e.g. 'sea view') will not match."
    },
    "priceMax": {
      "type": "number",
      "description": "Maximum price, in the market currency. Note: listings advertised 'price on request' have no price and are excluded by either price bound."
    },
    "priceMin": {
      "type": "number",
      "description": "Minimum price, in the market currency."
    },
    "typology": {
      "type": "string",
      "description": "A single exact typology code (T0, T1, T2…), where the number is the count of bedrooms. Buckets are not accepted here."
    },
    "operation": {
      "enum": [
        "buy",
        "rent"
      ],
      "type": "string",
      "description": "buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both."
    },
    "description": {
      "type": "string",
      "description": "What the user is looking for, in their own words. Full phrases work better than keywords. Pass the qualities here and the hard limits in the other arguments."
    },
    "propertyType": {
      "enum": [
        "apartment",
        "house",
        "land",
        "shop",
        "office",
        "warehouse",
        "garage",
        "farm",
        "building"
      ],
      "type": "string",
      "description": "A single property type. Unlike search_properties, this tool takes one, not a list."
    }
  }
}
search_properties_by_description output schema
{
  "type": "object",
  "required": [
    "market",
    "total",
    "shown",
    "properties"
  ],
  "properties": {
    "shown": {
      "type": "number"
    },
    "total": {
      "type": "number",
      "description": "Listings matching the structural filters. The description narrows the ranking, not this count."
    },
    "market": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "slug",
          "url",
          "title",
          "operation",
          "sourceUrl",
          "firstSeen",
          "lastSeen"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Canonical listing page on this market's domain."
          },
          "slug": {
            "type": "string",
            "description": "Stable identifier; use it in get_property_detail."
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "null means the source does not publish a price (on request)."
          },
          "title": {
            "type": "string"
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Portal or agency site the listing came from; null when published directly with us."
          },
          "bedrooms": {
            "type": "number"
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code of this market."
          },
          "district": {
            "type": "string",
            "description": "District or region."
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Amenities as published by the source (Portuguese labels)."
          },
          "landArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Plot area in m²; relevant for houses, land and farms."
          },
          "lastSeen": {
            "type": "string",
            "description": "ISO 8601 date we last confirmed the listing at the source."
          },
          "typology": {
            "type": "string",
            "description": "T-notation typology (T0…T6+); empty when unknown."
          },
          "verified": {
            "type": "boolean",
            "description": "Advertiser identity verified by us."
          },
          "bathrooms": {
            "type": "number"
          },
          "firstSeen": {
            "type": "string",
            "description": "ISO 8601 date the listing was first published."
          },
          "houseArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Gross floor area in m²."
          },
          "operation": {
            "enum": [
              "comprar",
              "arrendar"
            ],
            "type": "string",
            "description": "comprar = for sale, arrendar = to let."
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original listing URL at the source. Cite this alongside url."
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 date the record last changed on our side."
          },
          "priceLabel": {
            "type": "string",
            "description": "Formatted price for display; empty when price is null."
          },
          "pricePerM2": {
            "type": [
              "number",
              "null"
            ]
          },
          "usefulArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Net/usable floor area in m²."
          },
          "energyClass": {
            "type": [
              "string",
              "null"
            ]
          },
          "municipality": {
            "type": [
              "string",
              "null"
            ],
            "description": "Municipality (LAU) name."
          },
          "propertyType": {
            "enum": [
              "apartment",
              "house",
              "land",
              "shop",
              "office",
              "warehouse",
              "garage",
              "farm",
              "building",
              null
            ],
            "type": [
              "string",
              "null"
            ],
            "description": "Property type; the same token accepted by the propertyType filter."
          },
          "neighbourhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Neighbourhood, when the source located the listing precisely enough."
          }
        }
      },
      "description": "Ordered by relevance to the description, most relevant first."
    }
  }
}
search_properties_by_description annotations
{
  "title": "Search properties by description in Portugal",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_market_stats
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get price statistics for a slice of the Portugal property market: how many listings match, the median price, the p25–p75 range, the median price per m² and a breakdown by typology. Use this when the user asks what something costs, whether an asking price is fair, or how two areas compare — instead of listing individual properties. Takes the same filters as search_properties and describes exactly the set that tool would return, so the two never disagree. Reports medians and quartiles rather than averages, because property prices have a long right tail and a single luxury listing moves an average. Call once per area to compare areas.

get_market_stats input schema
{
  "type": "object",
  "properties": {
    "minArea": {
      "type": "number",
      "description": "Minimum floor area in m². Matches either the gross or the useful area, whichever the source published. Only matches listings that published an area."
    },
    "location": {
      "type": "string",
      "description": "Location: district, municipality, neighbourhood, town or postal-code prefix (e.g. Lisbon, Cascais, Chiado, 2750). Not a free-text keyword search — words that are not places (e.g. 'sea view') will not match."
    },
    "priceMax": {
      "type": "number",
      "description": "Maximum price, in the market currency. Note: listings advertised 'price on request' have no price and are excluded by either price bound."
    },
    "priceMin": {
      "type": "number",
      "description": "Minimum price, in the market currency."
    },
    "typology": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "Normalised typology code (T0, T1, T2, T3…), where the number is the count of bedrooms. Used in every market, including the German and Polish ones. Matched exactly; pass an array to match several. The buckets `T0–T1` and `T4+` are also accepted."
    },
    "condition": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "enum": [
          "new",
          "used",
          "to_renovate",
          "under_construction"
        ],
        "type": "string"
      },
      "description": "State of repair, or an array of states. Only matches listings whose source published it."
    },
    "operation": {
      "enum": [
        "buy",
        "rent"
      ],
      "type": "string",
      "description": "buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both."
    },
    "energyClass": {
      "enum": [
        "A++",
        "A+",
        "A",
        "B",
        "B-",
        "C",
        "D",
        "E",
        "F",
        "G",
        "H"
      ],
      "type": "string",
      "description": "Energy certificate class. Selects the whole band the class belongs to: A+/A, B/B-, C, or D-and-below. Only matches listings that carry a certificate."
    },
    "minBathrooms": {
      "type": "number",
      "description": "Minimum number of bathrooms. Only matches listings whose source published a bathroom count."
    },
    "propertyType": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "enum": [
          "apartment",
          "house",
          "land",
          "shop",
          "office",
          "warehouse",
          "garage",
          "farm",
          "building"
        ],
        "type": "string"
      },
      "description": "Property type, or an array of types. Omit to search all types. `farm` covers rural estates (quintas); `building` is a whole apartment block."
    }
  }
}
get_market_stats output schema
{
  "type": "object",
  "required": [
    "market",
    "currency",
    "operation",
    "count",
    "priced",
    "byTypology"
  ],
  "properties": {
    "count": {
      "type": "number",
      "description": "Listings matching the filters, with or without a published price."
    },
    "price": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "p10": {
          "type": "number",
          "description": "The bottom of the market: 10% of listings are cheaper."
        },
        "p25": {
          "type": "number",
          "description": "A quarter of listings are priced below this."
        },
        "p75": {
          "type": "number",
          "description": "A quarter of listings are priced above this."
        },
        "p90": {
          "type": "number",
          "description": "The top of the market: 10% of listings are dearer."
        },
        "median": {
          "type": "number",
          "description": "The typical price — use this one to answer 'how much'."
        }
      },
      "description": "Price distribution, in percentiles. null when no matching listing publishes a price. There is deliberately no min or max: listings come from third-party sources and the extremes are set by data errors, not by the market."
    },
    "market": {
      "type": "string"
    },
    "priced": {
      "type": "number",
      "description": "Subset with a published price — the base of every figure below. A large gap to `count` means many listings in this slice are 'price on request'."
    },
    "currency": {
      "type": "string"
    },
    "operation": {
      "enum": [
        "comprar",
        "arrendar"
      ],
      "type": "string"
    },
    "byTypology": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "typology",
          "count"
        ],
        "properties": {
          "count": {
            "type": "number"
          },
          "typology": {
            "type": "string"
          },
          "medianPrice": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      },
      "description": "Up to 6 most represented typologies, each with its own median."
    },
    "pricePerM2Median": {
      "type": [
        "number",
        "null"
      ],
      "description": "Median price per m² among listings that published both a price and an area. Best figure for comparing areas."
    }
  }
}
get_market_stats annotations
{
  "title": "Property price statistics for Portugal",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
find_similar_properties
Advertised by the server during the last successful anonymous check.
Advertised read-only

Given one listing, find comparable ones: same operation and area, similar typology, floor area and price. Use this when the user likes a property but wants alternatives — 'find me something similar', 'the same but cheaper', 'what else is there in this area'. Pass `maxPrice` for the cheaper case; without it, comparables are drawn from a band around the reference price. Comparability is by location, typology, area and price, not by text similarity: it answers 'is this well priced for what it is', which a keyword search cannot.

find_similar_properties input schema
{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug of the reference listing, as returned by search_properties or get_property_detail."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of comparables (default 6, max 20)."
    },
    "maxPrice": {
      "type": "number",
      "description": "Optional budget ceiling, in the market currency. Use it for 'similar but cheaper'; it overrides the default band around the reference price."
    }
  }
}
find_similar_properties output schema
{
  "type": "object",
  "required": [
    "market",
    "reference",
    "total",
    "properties"
  ],
  "properties": {
    "total": {
      "type": "number",
      "description": "Comparables returned."
    },
    "market": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "reference": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "description": "Canonical listing page on this market's domain."
        },
        "slug": {
          "type": "string",
          "description": "Stable identifier; use it in get_property_detail."
        },
        "price": {
          "type": [
            "number",
            "null"
          ],
          "description": "null means the source does not publish a price (on request)."
        },
        "title": {
          "type": "string"
        },
        "source": {
          "type": [
            "string",
            "null"
          ],
          "description": "Portal or agency site the listing came from; null when published directly with us."
        },
        "bedrooms": {
          "type": "number"
        },
        "currency": {
          "type": "string",
          "description": "ISO 4217 code of this market."
        },
        "district": {
          "type": "string",
          "description": "District or region."
        },
        "features": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Amenities as published by the source (Portuguese labels)."
        },
        "landArea": {
          "type": [
            "number",
            "null"
          ],
          "description": "Plot area in m²; relevant for houses, land and farms."
        },
        "lastSeen": {
          "type": "string",
          "description": "ISO 8601 date we last confirmed the listing at the source."
        },
        "typology": {
          "type": "string",
          "description": "T-notation typology (T0…T6+); empty when unknown."
        },
        "verified": {
          "type": "boolean",
          "description": "Advertiser identity verified by us."
        },
        "bathrooms": {
          "type": "number"
        },
        "firstSeen": {
          "type": "string",
          "description": "ISO 8601 date the listing was first published."
        },
        "houseArea": {
          "type": [
            "number",
            "null"
          ],
          "description": "Gross floor area in m²."
        },
        "operation": {
          "enum": [
            "comprar",
            "arrendar"
          ],
          "type": "string",
          "description": "comprar = for sale, arrendar = to let."
        },
        "sourceUrl": {
          "type": [
            "string",
            "null"
          ],
          "description": "Original listing URL at the source. Cite this alongside url."
        },
        "updatedAt": {
          "type": "string",
          "description": "ISO 8601 date the record last changed on our side."
        },
        "priceLabel": {
          "type": "string",
          "description": "Formatted price for display; empty when price is null."
        },
        "pricePerM2": {
          "type": [
            "number",
            "null"
          ]
        },
        "usefulArea": {
          "type": [
            "number",
            "null"
          ],
          "description": "Net/usable floor area in m²."
        },
        "energyClass": {
          "type": [
            "string",
            "null"
          ]
        },
        "municipality": {
          "type": [
            "string",
            "null"
          ],
          "description": "Municipality (LAU) name."
        },
        "propertyType": {
          "enum": [
            "apartment",
            "house",
            "land",
            "shop",
            "office",
            "warehouse",
            "garage",
            "farm",
            "building",
            null
          ],
          "type": [
            "string",
            "null"
          ],
          "description": "Property type; the same token accepted by the propertyType filter."
        },
        "neighbourhood": {
          "type": [
            "string",
            "null"
          ],
          "description": "Neighbourhood, when the source located the listing precisely enough."
        }
      },
      "description": "The listing the comparables are measured against, echoed back for the comparison."
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "slug",
          "url",
          "title",
          "operation",
          "sourceUrl",
          "firstSeen",
          "lastSeen"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Canonical listing page on this market's domain."
          },
          "slug": {
            "type": "string",
            "description": "Stable identifier; use it in get_property_detail."
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "null means the source does not publish a price (on request)."
          },
          "title": {
            "type": "string"
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Portal or agency site the listing came from; null when published directly with us."
          },
          "bedrooms": {
            "type": "number"
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code of this market."
          },
          "district": {
            "type": "string",
            "description": "District or region."
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Amenities as published by the source (Portuguese labels)."
          },
          "landArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Plot area in m²; relevant for houses, land and farms."
          },
          "lastSeen": {
            "type": "string",
            "description": "ISO 8601 date we last confirmed the listing at the source."
          },
          "typology": {
            "type": "string",
            "description": "T-notation typology (T0…T6+); empty when unknown."
          },
          "verified": {
            "type": "boolean",
            "description": "Advertiser identity verified by us."
          },
          "bathrooms": {
            "type": "number"
          },
          "firstSeen": {
            "type": "string",
            "description": "ISO 8601 date the listing was first published."
          },
          "houseArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Gross floor area in m²."
          },
          "operation": {
            "enum": [
              "comprar",
              "arrendar"
            ],
            "type": "string",
            "description": "comprar = for sale, arrendar = to let."
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original listing URL at the source. Cite this alongside url."
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 date the record last changed on our side."
          },
          "priceLabel": {
            "type": "string",
            "description": "Formatted price for display; empty when price is null."
          },
          "pricePerM2": {
            "type": [
              "number",
              "null"
            ]
          },
          "usefulArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Net/usable floor area in m²."
          },
          "energyClass": {
            "type": [
              "string",
              "null"
            ]
          },
          "municipality": {
            "type": [
              "string",
              "null"
            ],
            "description": "Municipality (LAU) name."
          },
          "propertyType": {
            "enum": [
              "apartment",
              "house",
              "land",
              "shop",
              "office",
              "warehouse",
              "garage",
              "farm",
              "building",
              null
            ],
            "type": [
              "string",
              "null"
            ],
            "description": "Property type; the same token accepted by the propertyType filter."
          },
          "neighbourhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Neighbourhood, when the source located the listing precisely enough."
          }
        }
      }
    }
  }
}
find_similar_properties annotations
{
  "title": "Find comparable properties",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_property_detail
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get the complete record of one listing in Portugal by its slug. Use this after search_properties when the user asks about a specific property: full description, features, photos, energy rating, condition, floor, year built, seller and the original source URL to cite.

get_property_detail input schema
{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Unique listing slug, as returned by search_properties."
    }
  }
}
get_property_detail output schema
{
  "type": "object",
  "required": [
    "slug",
    "url",
    "title",
    "operation",
    "sourceUrl",
    "firstSeen",
    "lastSeen"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Canonical listing page on this market's domain."
    },
    "slug": {
      "type": "string",
      "description": "Stable identifier; use it in get_property_detail."
    },
    "floor": {
      "type": [
        "string",
        "null"
      ]
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Advertiser phone when published at the source."
    },
    "price": {
      "type": [
        "number",
        "null"
      ],
      "description": "null means the source does not publish a price (on request)."
    },
    "title": {
      "type": "string"
    },
    "photos": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 5 image URLs."
    },
    "source": {
      "type": [
        "string",
        "null"
      ],
      "description": "Portal or agency site the listing came from; null when published directly with us."
    },
    "bedrooms": {
      "type": "number"
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 code of this market."
    },
    "district": {
      "type": "string",
      "description": "District or region."
    },
    "elevator": {
      "type": [
        "string",
        "null"
      ]
    },
    "features": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Amenities as published by the source (Portuguese labels)."
    },
    "landArea": {
      "type": [
        "number",
        "null"
      ],
      "description": "Plot area in m²; relevant for houses, land and farms."
    },
    "lastSeen": {
      "type": "string",
      "description": "ISO 8601 date we last confirmed the listing at the source."
    },
    "typology": {
      "type": "string",
      "description": "T-notation typology (T0…T6+); empty when unknown."
    },
    "verified": {
      "type": "boolean",
      "description": "Advertiser identity verified by us."
    },
    "bathrooms": {
      "type": "number"
    },
    "condition": {
      "type": [
        "string",
        "null"
      ]
    },
    "firstSeen": {
      "type": "string",
      "description": "ISO 8601 date the listing was first published."
    },
    "houseArea": {
      "type": [
        "number",
        "null"
      ],
      "description": "Gross floor area in m²."
    },
    "operation": {
      "enum": [
        "comprar",
        "arrendar"
      ],
      "type": "string",
      "description": "comprar = for sale, arrendar = to let."
    },
    "sourceUrl": {
      "type": [
        "string",
        "null"
      ],
      "description": "Original listing URL at the source. Cite this alongside url."
    },
    "updatedAt": {
      "type": "string",
      "description": "ISO 8601 date the record last changed on our side."
    },
    "yearBuilt": {
      "type": [
        "string",
        "null"
      ]
    },
    "priceLabel": {
      "type": "string",
      "description": "Formatted price for display; empty when price is null."
    },
    "pricePerM2": {
      "type": [
        "number",
        "null"
      ]
    },
    "sellerName": {
      "type": [
        "string",
        "null"
      ]
    },
    "usefulArea": {
      "type": [
        "number",
        "null"
      ],
      "description": "Net/usable floor area in m²."
    },
    "description": {
      "type": "string"
    },
    "energyClass": {
      "type": [
        "string",
        "null"
      ]
    },
    "orientation": {
      "type": [
        "string",
        "null"
      ]
    },
    "municipality": {
      "type": [
        "string",
        "null"
      ],
      "description": "Municipality (LAU) name."
    },
    "propertyType": {
      "enum": [
        "apartment",
        "house",
        "land",
        "shop",
        "office",
        "warehouse",
        "garage",
        "farm",
        "building",
        null
      ],
      "type": [
        "string",
        "null"
      ],
      "description": "Property type; the same token accepted by the propertyType filter."
    },
    "neighbourhood": {
      "type": [
        "string",
        "null"
      ],
      "description": "Neighbourhood, when the source located the listing precisely enough."
    }
  }
}
get_property_detail annotations
{
  "title": "Get property detail",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_neighbourhoods
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search neighbourhood and municipality guides for Portugal, with median price per m² for buying and renting, price trend and an editorial summary. Use this when the user asks where to live or where to buy, or wants to compare areas, instead of asking for individual listings.

search_neighbourhoods input schema
{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 8, max 20)."
    },
    "query": {
      "type": "string",
      "description": "Neighbourhood, municipality or district (e.g. Cascais, Príncipe Real). Omit to list all."
    }
  }
}
search_neighbourhoods output schema
{
  "type": "object",
  "required": [
    "market",
    "total",
    "neighbourhoods"
  ],
  "properties": {
    "total": {
      "type": "number"
    },
    "market": {
      "type": "string"
    },
    "neighbourhoods": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "slug",
          "name",
          "url"
        ],
        "properties": {
          "url": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "blurb": {
            "type": "string",
            "description": "Editorial summary of the area."
          },
          "trend": {
            "type": [
              "string",
              "null"
            ],
            "description": "Recent price direction."
          },
          "concelho": {
            "type": "string",
            "description": "Municipality."
          },
          "distrito": {
            "type": "string",
            "description": "District or region."
          },
          "pricePerM2Buy": {
            "type": [
              "number",
              "null"
            ]
          },
          "pricePerM2Rent": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  }
}
search_neighbourhoods annotations
{
  "title": "Search neighbourhoods in Portugal",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_articles
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search editorial articles about the property market in Portugal: buying and renting guides, market analysis and practical advice. Use this when the user asks how something works — mortgages, contracts, taxes, the buying process — rather than asking for listings.

search_articles input schema
{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 5, max 10)."
    }
  }
}
search_articles output schema
{
  "type": "object",
  "required": [
    "articles"
  ],
  "properties": {
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "slug",
          "title",
          "url"
        ],
        "properties": {
          "url": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "excerpt": {
            "type": "string"
          },
          "category": {
            "type": "string"
          }
        }
      }
    }
  }
}
search_articles annotations
{
  "title": "Search articles",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1039 ms
95th percentile latency
1039 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1039 ms · metadata changed · 7 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http voxhouses-mcp https://www.voxhouses.pt/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add voxhouses-mcp --url https://www.voxhouses.pt/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable voxhouses-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "voxhouses-mcp": {
      "url": "https://www.voxhouses.pt/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "voxhouses-mcp": {
      "type": "streamableHttp",
      "url": "https://www.voxhouses.pt/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start voxhouses-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "voxhouses-mcp": {
      "type": "http",
      "url": "https://www.voxhouses.pt/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http voxhouses-mcp https://www.voxhouses.pt/api/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://www.voxhouses.pt/api/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "voxhouses-mcp": {
      "serverUrl": "https://www.voxhouses.pt/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Voxhouses MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,258

Do you run Voxhouses MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing