# For AI agents

> **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).

This site is written for people and for agents alike. Everything on it is available in machine-readable form, and none of it needs a key.

## Read any page as Markdown

Add `.md` to a page's URL, or send `Accept: text/markdown` with a normal `GET`. The response is `text/markdown` with an `x-markdown-tokens` header estimating its size.

```bash
curl -H "Accept: text/markdown" https://platform.casafari.com/docs/area-insights/get_time_series_data
```

## Entry points

| What | Where |
|---|---|
| Index of every page and tool | [/llms.txt](/llms.txt) |
| The whole reference in one file | [/llms-full.txt](/llms-full.txt) |
| One tool's reference | `/docs/<product>/<tool>.md`, e.g. [/docs/comparables-valuation/get-comparables.md](/docs/comparables-valuation/get-comparables.md) |
| One REST operation's reference | `/docs/rest/<product>/<operation>.md`, e.g. [/docs/rest/properties/search-properties-v2.md](/docs/rest/properties/search-properties-v2.md) |
| The REST API, and how it compares with MCP | [/docs/rest.md](/docs/rest.md), [/docs/parity.md](/docs/parity.md) |
| REST API description (OpenAPI) | [https://docs.api.casafari.com/openapi.json](https://docs.api.casafari.com/openapi.json) |
| All tools as JSON (name, title, input and output schema) | [/tools.json](/tools.json) |
| The same tools as OpenAPI (one POST path per tool) | [/mcp/openapi.json](/mcp/openapi.json) |
| Data Export: bulk delivery and every entity's fields | [/docs/data-export.md](/docs/data-export.md) |
| API catalog (RFC 9727) | [/.well-known/api-catalog](/.well-known/api-catalog) |
| MCP server card | [/.well-known/mcp/server-card.json](/.well-known/mcp/server-card.json), the same card as [mcp.casafari.com's](https://mcp.casafari.com/.well-known/mcp/server-card.json) |
| Agent skill: how to use Casafari MCP well | [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json) |
| Agentic resource manifest (ARD) | [/.well-known/ai-catalog.json](/.well-known/ai-catalog.json) |
| How to obtain a credential | [casafari.com/auth.md](https://www.casafari.com/auth.md) |
| Sitemap | [/sitemap.xml](/sitemap.xml) |

## In the browser (WebMCP)

Pages register WebMCP tools where the browser supports `navigator.modelContext`: `search_casafari_mcp_docs`, `get_casafari_tool_reference`, `get_casafari_rest_operation`, `get_casafari_connection_config` and `open_casafari_docs_page`.

## Using the server well

- Call [`list_servers`](/docs/gateway/list_servers) before using a product for the first time.
- Count properties, not advertisements: each property in the graph already merges every source that advertises it. See [The property graph](/docs/property-graph).
- Resolve place names to location ids with [`ma_get_location_typeahead`](/docs/area-insights/get_location_typeahead); most tools take ids, a circle or a polygon, not names.
- The REST API has 39 operations and no gateway: sign in with `POST /login` ([REST API](/docs/rest#get-a-token)). Not everything is in both: [MCP and REST compared](/docs/parity) lists what exists where.
- Read each tool's description and input schema before calling it: they are the contract, and these pages are generated from them.

## Questions about this

- [How do I build my own application or agent on Casafari MCP?](/docs/faq/build-on-mcp)
- [Why does Casafari count properties and not advertisements?](/docs/faq/count-properties-not-advertisements)
- [Can I read these docs as Markdown, and is there an llms.txt?](/docs/faq/machine-readable-docs)