PropertyList: Spanish Property MLS

Get property details

get_property

Read-onlyIdempotent

Fetch the full record for one PropertyList listing by its reference code (the human-readable id like 'PLE-12345'). Use this once the user has settled on a listing from search_properties or find_properties_by_description and wants details or photos. To contact the listing agency, use submit_enquiry - direct phone or email details are not part of the payload.

Works without an API key up to a daily allowance of listings, counted per IP address, or per account for an app linked to a PropertyList account; an API key raises that allowance. The free allowance is for an assistant answering a person's questions: reading listings in bulk, or showing them on a website, needs MCP Pro or the agency's website feed. When the day's allowance is used the result carries error and limits instead of property.

photos holds the listing's first photos on the free tier and all of them with MCP Pro; photos_total says how many the listing has.

location.city is whatever tier the listing was filed under and may be a municipality OR a locality inside one. To place a listing administratively use location.municipality (with its INE municipality_code); it is null, never guessed, when we cannot resolve it.

Commercial premises (commercial true) carry no bedrooms: read commercial_facts (usable area, licence, price per m², a letting's terms, a traspaso's rent and years left) and tenure (freehold, or traspaso for a sale of the lease and the business).

location.latitude / location.longitude are present whenever we can place the listing; the fields are absent otherwise, and are never 0,0. location.coordinates_precision says what the point is: exact or street is the property itself, approximate is a pin the agent keeps private, rounded to about 1 km, locality or administrative_area is an area centroid (accurate to the town or neighbourhood, not the building: a listing whose agent placed no map pin carries the centre of its area, shared by its neighbours), unknown is a pin we hold no precision record for.

Input Schema

Name	Required	Description	Default
`language`	No		en
`reference`	Yes	PropertyList reference, e.g. 'PLE-12345'.

Output Schema

Name	Required	Description	Default
`error`	No
`limits`	No
`property`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 9, 2026

addedOutput schema / properties / property / properties / rent_to_buy

Added value: +{
+  "description": "Rent to buy (alquiler con opcion a compra) terms, null without the option: years (rental duration), down_payment_percent and down_payment_amount (the share of the sale price paid up front), sale_price, monthly_rent.",
+  "type": [
+    "object",
+    "null"
+  ]
+}

Changed2 schema fields changedOct 30, 2026

addedOutput schema / properties / property / properties / description_machine_translated

Added value: +{
+  "description": "True when PropertyList translated the description automatically from the listing's main language; false when it is the agency's own text.",
+  "type": "boolean"
+}

addedOutput schema / properties / property / properties / description_translated_from

Added value: +{
+  "description": "The language the description was translated from, when it was.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed1 schema field changedOct 30, 2026

addedOutput schema / properties / property / properties / url

Added value: +{
+  "description": "The listing's page on PropertyList, in the language asked for. null when the listing is not shown on the portal.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed1 schema field changedOct 28, 2026

addedOutput schema / properties / property / properties / buildable_sqm

Added value: +{
+  "description": "Land only: how many m² may be built on the plot (edificabilidad), when the listing says. Null when it does not.",
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Changed3 schema fields changedOct 16, 2026

addedOutput schema / properties / property / properties / commercial

Added value: +{
+  "description": "Commercial premises rather than a home.",
+  "type": "boolean"
+}

addedOutput schema / properties / property / properties / commercial_facts

Added value: +{
+  "description": "Commercial premises only: the facts a buyer or tenant of premises reads first, only those the listing has.",
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / property / properties / tenure

Added value: +{
+  "description": "How a commercial sale is sold: freehold, or traspaso (the lease and the business taken over). null for homes and lettings.",
+  "enum": [
+    "freehold",
+    "traspaso",
+    null
+  ],
+  "type": [
+    "string",
+    "null"
+  ]
+}

Changed4 schema fields changedOct 13, 2026

addedOutput schema / properties / error

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / limits

Added value: +{
+  "type": [
+    "object",
+    "null"
+  ]
+}

addedOutput schema / properties / property / properties / photos_total

Added value: +{
+  "description": "How many photos the listing has. `photos` holds the first few on the free tier, all of them with MCP Pro.",
+  "type": "integer"
+}

removedOutput schema / required
```
Removed value: -[
-  "property"
-]
```

Changed2 schema fields changedAug 23, 2026

changedInput schema / properties / language / enum

Previous value: -[
-  "en",
-  "es",
-  "de",
-  "fr",
-  "it",
-  "nl",
-  "pt",
-  "bg",
-  "el",
-  "da",
-  "sv",
-  "no",
-  "fi"
-]New value: +[
+  "en",
+  "es",
+  "de",
+  "fr",
+  "it",
+  "nl",
+  "pt",
+  "bg",
+  "el",
+  "da",
+  "sv",
+  "no",
+  "fi",
+  "pl",
+  "ru"
+]

addedOutput schema / properties / property / properties / features_language
```
Added value: +{
+  "type": "string"
+}
```

First observedJul 27, 2026

TDQS

Score is being calculated.

All PropertyList: Spanish Property MLS tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?