Value and compare · Use case

How do I value a property in Spain from its cadastral reference?

To value a property in Spain from its cadastral reference, call comparables_get_comparables (on Casafari's Comparables MCP server) with location_boundary.circle.target_point.cadastral_reference set to country_code: ES and the reference. The tool centres the search on that property and returns comparables, statistics and estimated prices. This input is Spain only.

Products: Comparables & Valuation

#Short answer

comparables_get_comparables accepts location_boundary.circle.target_point.cadastral_reference, with country_code: ES and the cadastral_reference string, as the centre point of the search. The tool's schema says this input is, for now, available only for Spain; elsewhere you give coordinates or an address.

#Steps

#Set location_boundary.circle.target_point.cadastral_reference with country_code ES, cadastral_reference, and optionally province and municipality

1. Connect the Comparables MCP server if this is your first use of Comparables & Valuation; its tool list describes comparables_get_comparables.
2. Build the cadastral_reference object: country_code (the only accepted value is ES), cadastral_reference (required), and optionally province and municipality. Set location_boundary.circle.distance in kilometres (0.05 to 50, default 5).

#Choose operation and comparables_types

3. Set operation to sale or rent, comparables_count from 1 to 50, and comparables_types from one group, for example ["apartment"]. Add filters such as bedrooms, condition or characteristics if you want closer matches.

#Omit total_area or plot_area: with a cadastral reference they are not required

4. The schema requires total_area for hotel, industrial, office, other_commercial, restaurant, retail, warehouse and werkstatt, and plot_area for rural_plot and urban_plot, only when target_point.cadastral_reference is not provided. With the reference, you can leave them out. Then call comparables_get_comparables.

#Example: a Madrid apartment

A valuer asks their assistant: "Value cadastral reference 1234567VK4713S0001AB in Madrid." (Use the real reference of your property; this one shows the format.) The assistant calls comparables_get_comparables:

{
  "comparables_count": 20,
  "location_boundary": {
    "circle": {
      "target_point": {
        "cadastral_reference": {
          "country_code": "ES",
          "cadastral_reference": "1234567VK4713S0001AB",
          "province": "Madrid",
          "municipality": "Madrid"
        }
      },
      "distance": 1
    }
  },
  "operation": "sale",
  "comparables_types": ["apartment"]
}

Condensed response (values depend on the market when you call):

{
  "results": [ { "property_id": "...", "similarity_score": "...", "distance": "...", "sale_price": "...", "sale_price_per_sqm": "..." } ],
  "statistics": { "average_price_per_sqm": "...", "average_time_on_the_market": "..." },
  "estimated_prices": { "fast_sell_price": "...", "fair_market_price": "...", "out_of_market_price": "..." },
  "casafari_link": "...",
  "valuation_id": "..."
}

#How to read the result

#estimated_prices and statistics

estimated_prices gives fast_sell_price, fair_market_price and out_of_market_price, each with a per-m² version, computed from the comparables found. statistics adds average_price_per_sqm, average_time_on_the_market (days) and sold_or_rented_in_last_six_months. Read results by similarity_score and is_outlier, and open casafari_link for the Comparative Market Analysis page.

#Limits

Cadastral-reference valuation over comparables_get_comparables is self-serve on the Casafari API and MCP Platform, where existing Casafari clients sign up too (contract clients are set up on the Custom plan). Comparables is self-serve over REST as well as MCP: the platform's REST comparables search takes the same input as comparables_get_comparables and returns the same answer. The REST operation POST /api/v2/comparables/search also takes target_point and is for Casafari client accounts. Platform plans, tokens and limits are on Limits and usage windows; Casafari clients' quotas follow their contract, so ask Casafari.

#Only one target definition per request: coordinates, address or cadastral reference

target_point takes exactly one value. Do not send an address or coordinates alongside the cadastral reference.

#Cadastral reference input is Spain only

country_code accepts only ES. This is a limit of this input, not of the tool: see Does Casafari cover Spain and Portugal? and Does every tool cover all 16 countries?. For properties outside Spain, use an address or coordinates.

#Questions

All use cases