# Comparables & Valuation

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

Comparable properties and estimated prices for a home: properties on the market, past sales and rentals, and official registry records, matched around a point, an address or a cadastral reference.

1 MCP tool · 4 REST operations.

## MCP tools

| Tool | Title | What it does |
|---|---|---|
| [`comps_get-comparables`](/docs/comparables-valuation/get-comparables) | Get Comparables | Retrieves comparable real estate properties and AI-powered market valuations using the Casafari Comparables Engine. |

## REST API

4 operations in the public OpenAPI description, all under `https://api.casafari.com` with a bearer token ([how to get one](/docs/rest#get-a-token)). The same list with more detail: [Comparables & Valuation REST API](/docs/rest/comparables-valuation).

### Comparables

Paths under `/api`.

- [`POST /api/v1/comparables/search`](/docs/rest/comparables-valuation/search-comparables-v1): Search comparables (v1). Returns comparable properties by the given parameters.
- [`POST /api/v2/comparables/ai-builder`](/docs/rest/comparables-valuation/initialize-an-ai-builder-session-v2): Initialize an AI Builder session (v2). Initializes an AI Builder session from a saved CMA (valuation) and returns the generated report ID along with the URL of the AI Builder session.
- [`POST /api/v2/comparables/search`](/docs/rest/comparables-valuation/search-comparables-v2): Search comparables (v2). Returns comparable properties by the given parameters.

### Valuation

- [`POST /api/v1/valuation/comparables-prices`](/docs/rest/comparables-valuation/search-estimated-prices-v1): Search estimated prices (v1). Returns estimated prices by the given parameters.

## MCP and REST compared

Over MCP: 1 tool. Over REST: 4 operations. Available over both.

- Equivalent: [`comps_get-comparables`](/docs/comparables-valuation/get-comparables) and [`POST /api/v2/comparables/search`](/docs/rest/comparables-valuation/search-comparables-v2).
- Related: [`comps_get-comparables`](/docs/comparables-valuation/get-comparables) and [`POST /api/v1/comparables/search`](/docs/rest/comparables-valuation/search-comparables-v1).
- Related: [`comps_get-comparables`](/docs/comparables-valuation/get-comparables) and [`POST /api/v1/valuation/comparables-prices`](/docs/rest/comparables-valuation/search-estimated-prices-v1).

Only over REST: [`POST /api/v2/comparables/ai-builder`](/docs/rest/comparables-valuation/initialize-an-ai-builder-session-v2).

Details: [MCP and REST compared](/docs/parity#comparables-valuation).

## Ask your assistant

> What is a 3-bedroom flat near Avenida da Liberdade, Lisbon worth? Use comparables within 1 km.

## Questions about this

- [What is Casafari MCP?](/docs/faq/what-is-casafari-mcp)
- [Which countries does Casafari cover?](/docs/faq/which-countries)
- [Does Casafari cover Spain and Portugal?](/docs/faq/coverage-spain-portugal)
- [Which products does Casafari MCP offer, and how many tools are there?](/docs/faq/which-products)
- [What does Comparables & Valuation do?](/docs/faq/what-is-comparables-valuation)