# Connect to the Casafari Platform

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

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](/docs/moving-from-existing-api).

## Which way in

| You are connecting | Use | Sign-in |
|---|---|---|
| An AI assistant or agent (Claude, ChatGPT, Cursor, VS Code, any MCP client) | The product's MCP server | OAuth 2.1 in the browser; no key |
| Your own software, a script or a backend | The 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?](/docs/parity).

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](/docs/connect).
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](/legal/platform-terms) 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](/docs/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](/legal/platform-terms) and personal data is handled under the [Platform Privacy Notice](/legal/platform-privacy).

## Questions about this

- [Which AI assistants and MCP clients work with Casafari MCP?](/docs/faq/supported-clients)
- [How do I connect Casafari MCP to Claude?](/docs/faq/connect-claude)
- [How do I connect Casafari MCP to ChatGPT?](/docs/faq/connect-chatgpt)
- [How do I add Casafari MCP to Claude Code?](/docs/faq/connect-claude-code)
- [How do I connect any other MCP client, or build my own agent on Casafari MCP?](/docs/faq/connect-other-client)