Platform
Get started

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.The most complete property index in Europe: a deduplicated, cleaned property graph.

How the graph is built
Markdown Open in Claude Open in ChatGPT

Connect to the Casafari Platform

The self-serve Casafari API and MCP Platform at https://platform.casafari.com is for new users: you sign up on your own, start on the Free plan with 1,000 units for 30 days and no card, and pay by usage after that. This page shows the two ways in: an AI assistant over MCP, or your own software over REST. If you are already a Casafari client, you do not need anything here: see Moving from the existing Casafari API.

Which way in

You are connectingUseSign-in
An AI assistant or agent (Claude, ChatGPT, Cursor, VS Code, any MCP client)The product's MCP serverOAuth 2.1 in the browser; no key
Your own software, a script or a backendThe product's REST API at https://platform.casafari.com/v1/<product>An API key (cf_sk_...) from the console

Connect an AI assistant

Each product has its own MCP server URL. Add the ones you need:

  • Location Lookup: https://platform.casafari.com/mcp/locations
  • Area Insights: https://platform.casafari.com/mcp/area-insights
  • Comparables: https://platform.casafari.com/mcp/comparables
  • AgentGraph AI: https://platform.casafari.com/mcp/agentgraph (verified businesses only)

Alerts is REST only: it has no MCP server. Property Sourcing and High Potential Seller Leads are coming soon on the Platform, also REST only. High Potential Seller Leads will be on the Custom plan only. See MCP or REST API?.

  1. In your client, add a custom MCP connector. In Claude: Settings, Connectors, Add custom connector. In ChatGPT: a connector in developer mode. In Claude Code: claude mcp add --transport http casafari-area-insights https://platform.casafari.com/mcp/area-insights. In Cursor and VS Code: the url of an MCP server entry, as on Connect a client.
  2. Paste the product's URL.
  3. The client registers itself (OAuth 2.1 with dynamic client registration and PKCE) and opens Casafari's sign-in page. Sign in or create your account there, accept the Platform Terms of Use and approve. A new account starts on the Free plan.
  4. Ask a question. Each product is a separate connection, because each one is its own protected resource with its own token.

A client that needs the authorization server's address reads it from https://platform.casafari.com/.well-known/oauth-authorization-server.

Call it from software

  1. Open the console at https://platform.casafari.com/console, sign in and create an API key. It starts with cf_sk_ and is shown once: store it like a password.
  2. Send it as a bearer token on every request: Authorization: Bearer <api_key>. (X-API-Key: <api_key> is accepted too.)
  3. Call the product's base path, https://platform.casafari.com/v1/<product>.

First call: Location Lookup

Every other product takes places as location ids, and looking them up is free (0 units):

bash
curl "https://platform.casafari.com/v1/locations/search?query=Lisbon" \
  -H "Authorization: Bearer $CASAFARI_API_KEY"

Pass the ids it returns to Area Insights, Comparables or Alerts. Each product's operations and unit costs are in its OpenAPI description at https://platform.casafari.com/v1/<product>/openapi.json, and the whole API is at https://platform.casafari.com/v1/openapi.json.

Agents that sign up on their own

An AI agent can open a trial account for a person through the Platform's sign-up API: GET https://platform.casafari.com/v1/signups/terms returns the current terms version, POST https://platform.casafari.com/v1/signups starts the sign-up, and the person enters the code sent to their email, which accepts the terms and opens the account. The endpoints are described at https://platform.casafari.com/v1/openapi.json.

See your usage

The console at https://platform.casafari.com/console shows your usage and balance. An assistant can call the account_status tool that every product MCP server has, and software can call GET https://platform.casafari.com/v1/account. What each plan includes, the usage limits and what happens when you reach one are on Limits.

Plans and terms

Free: 1,000 units for 30 days, no card. Agent: EUR 70 a month or EUR 588 a year. Custom: for larger needs. Extra usage is bought as credits at EUR 0.04 a unit. Prices exclude VAT. Use of the Platform is governed by the Platform Terms of Use and personal data is handled under the Platform Privacy Notice.

Questions about this

Esc

Tip: add .md to any URL to read it as Markdown.