# How do I build my own application or agent on Casafari MCP?

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

Connect to `https://mcp.casafari.com/` over Streamable HTTP, complete OAuth 2.1 (discovery, registration, PKCE authorization, and token), then call `list_servers` and read each tool's schema in `/tools.json`.

1. Discover: the `401` response points to the protected resource metadata, which in turn points to the authorization server metadata.
2. Register once with dynamic client registration and keep the `client_id`. An unattended agent uses client credentials issued by Casafari instead.
3. Authorize with PKCE and `resource`, exchange the code, then call with `Authorization: Bearer <access_token>`. Refresh when `expires_in` runs out.
4. Call [`list_servers`](https://platform.casafari.com/docs/gateway/list_servers) before using a product. Read each tool's description and input schema, because they are the contract.

Machine-readable helpers: [/tools.json](https://platform.casafari.com/tools.json), the [MCP server card](https://platform.casafari.com/.well-known/mcp/server-card.json), and the [agent skill](https://platform.casafari.com/.well-known/agent-skills/index.json).

See [Authentication](https://platform.casafari.com/docs/authentication) and [For AI agents](https://platform.casafari.com/docs/agents).

## Where this is documented

- [list_servers](https://platform.casafari.com/docs/gateway/list_servers)
- [/tools.json](https://platform.casafari.com/tools.json)
- [/.well-known/mcp/server-card.json](https://platform.casafari.com/.well-known/mcp/server-card.json)
- [/.well-known/agent-skills/index.json](https://platform.casafari.com/.well-known/agent-skills/index.json)
- [Authentication](https://platform.casafari.com/docs/authentication)
- [For AI agents](https://platform.casafari.com/docs/agents)

## Related questions

- [How do I value a home or find comparables with Casafari MCP?](https://platform.casafari.com/docs/faq/example-valuation)
- [How do I analyse how prices in an area have moved over time?](https://platform.casafari.com/docs/faq/example-price-trend)
- [How do I see how properties are distributed by price, bedrooms or time on market, or get a heatmap?](https://platform.casafari.com/docs/faq/example-distributions-heatmap)
- [Can I build a market report with Casafari MCP?](https://platform.casafari.com/docs/faq/example-market-report)
- [How do I find agencies or agents to partner with in a German city?](https://platform.casafari.com/docs/faq/example-find-agencies-germany)

All questions: https://platform.casafari.com/docs/faq#build-on-mcp