Start free trial

CASAFARI API and MCP Platform: European Property Data for AI Agents

Discover how the CASAFARI API and MCP Platform connects AI agents to real estate data across 16 countries (US: entering now, selected states, commercial real estate only, via Claro AI) with OAuth sign-in, read-only tools by default, and unified token management.

Create a free accountSee agent use cases

A real estate analyst in London or a valuer in Lisbon pastes a single URL into Claude, completes a quick OAuth sign-in in the browser, and immediately retrieves property valuation data without copying API keys or filing an IT ticket. The CASAFARI API and MCP Platform provides self-service property and location intelligence for AI agents and human users through five dedicated MCP servers—Location Lookup, Area Insights, Comparables, AgentGraph AI, and Claro AI—alongside two REST APIs, powered by a deduplicated property graph spanning 16 countries.

AI clients connect through OAuth 2.1 or an API key to platform.casafari.com, which serves five MCP servers and the REST API from one property graph covering 16 countries.

What is the CASAFARI API and MCP Platform?

The CASAFARI API and MCP Platform connects artificial intelligence tools directly to European real estate intelligence. A single account managed in the console gives both human professionals and autonomous agents access to our comprehensive database using one API key and a unified token balance.

Depending on your technical workflow, you can interact with our dataset using two distinct entry points:

  • MCP Servers (Streamable HTTP, OAuth 2.1): Built for conversational assistants like Claude, ChatGPT, Cursor, and code editors. Agents connect using browser-based sign-in without manual credential handling.
  • REST APIs: Designed for traditional software pipelines and automated background scripts using a standard API key (cf_sk_...) passed in the Authorization: Bearer header.

Both entry points connect directly to the CASAFARI property graph. This deduplicated index covers residential and commercial real estate across 16 countries, tracking every price adjustment, listing status update, and market delisting as a single historical record (source: CASAFARI developer hub, October 2026). Readers reviewing regional coverage details can consult our guide on the 16 countries CASAFARI covers. To explore specific product capabilities, view the CASAFARI MCP product page or read about CASAFARI Property Data APIs.

Why CASAFARI is AI-agent native

Rather than adapting legacy REST architecture with simple wrappers, the platform is engineered explicitly around model context protocol standards:

  • Zero Key Copying: Humans authenticate agents securely in the browser using OAuth 2.1. The AI client never receives or stores your main account password.
  • Safe Tools: 19 of the 21 documented MCP tools are strictly read-only (readOnlyHint). The two tools capable of modifying data ask for explicit user confirmation before executing.
  • Predictable Usage: Each tool description lists its exact token consumption. Note that access tokens are the OAuth credentials used for session authorization, distinct from the usage tokens that pay for tool executions.
  • Machine-Readable Documentation: AI agents can discover system capabilities autonomously via llms.txt files on both domains, an OpenAPI spec at https://platform.casafari.com/v1/openapi.json, an auth.md reference guide, and pure Markdown documentation pages (machine-readable entry points for agents).
  • Directory Availability: Claro AI is accessible directly inside Claude's Connectors Directory, CASAFARI is indexed in the Cursor Directory, and our global integration is listed as com.casafari in the open-source MCP Registry (launched September 2025).
  • Human control: If your account token balance reaches zero, active tool calls pause automatically. Only human users can authorize credit refills or modify billing settings.

The MCP servers, one per product

Each product operates its own dedicated server endpoint under https://platform.casafari.com/mcp/<product>. This structure allows development teams to grant AI agents precise, granular access only to the datasets required for their specific workflow.

Location Lookup

Resolves natural language place names into standard CASAFARI location identifiers. This endpoint is free to call and remains free after the initial 30-day trial period ends. Located at https://platform.casafari.com/mcp/locations, it serves as the foundational discovery query agents perform before invoking market analytics or valuation tools.

Area Insights

Includes 7 tools for analysing local real estate markets, including price time series, distribution breakdowns by asking price, bedroom count, and time on market, alongside metric operations like CAGR, price volatility, and district heatmaps. Investment teams use it to query neighbourhood trends directly within chat tools. To learn more, visit Area Insights for market analysis or read the Area Insights API docs.

Comparables

Identifies comparable properties and generates real-time valuation estimates for residential properties. It is frequently the primary integration point for valuers and real estate professionals working in cities like Lisbon, Madrid, or Milan. Technical implementation details are available in the Comparables and valuation API docs.

AgentGraph AI

Contains 13 tools designed to analyze estate agencies and individual real estate agents in Germany. Users can evaluate market players against custom partner profiles, territory coverage maps, client briefs, and watchlists. Coverage is limited strictly to verified businesses operating in Germany. The watchlist tools on this server represent the platform's only write operations and require manual user confirmation before updating. See the AgentGraph AI docs for full tool definitions.

Claro AI

Evaluates commercial premises for lease or sale in Spain alongside commercial development plots in Germany. Queries accept natural language briefs and integrate Location Intelligence metrics such as footfall traffic, resident counts, and sociodemographic breakdowns. For site-selection frameworks, review CASAFARI for Business Expansion and the Claro AI documentation.

In a recorded test on 16 October 2026, Claude evaluated an expansion search for specialty coffee locations in Valencia (40–120 m², monthly lease under €3,500). Claro AI screened 546 matching spaces, allowing Claude to rank and present the top 6 properties. Similar automated screenings evaluated 483 candidate locations down to 7 sites for a multi-city fitness network in Madrid and Barcelona, and narrowed 1,279 commercial plots (1,500–6,000 m²) to 6 shortlisted options for a German vehicle inspection facility.

REST-only products on the same account

Certain high-volume data feeds operate exclusively via standard REST endpoints while drawing from the same underlying token balance:

  • Property Sourcing: Search the property graph, retrieve full listing histories with historical price changes, or resolve an external portal link directly to its canonical property profile.
  • High Potential Seller Leads: Pinpoints residential properties with repeated asking-price reductions around target price thresholds. Returns strictly property-level metadata without personal names, phone numbers, or email contact details, ensuring client contact workflows remain entirely under human management.

Both REST resources operate at https://platform.casafari.com/v1/<product> using standard Bearer API keys (cf_sk_...) created in your console dashboard.

Sign up, plans and tokens: who pays, and how much a call costs

Setting up an account requires no upfront payment details:

  1. Console Sign-Up: Create an account at the CASAFARI console without providing a credit card.
  2. Free Allocation: New accounts receive 1,000 tokens valid for 30 days. Location Lookup queries remain free after this initial period.
  3. Subscription Options: Teams can transition to the Agent plan monthly subscription or arrange a Custom plan contract for enterprise integrations. Additional token volume can be purchased via prepaid tokens. View complete pricing models in the plans and prices in the developer FAQ. Existing clients can request a Custom plan from the platform, as the plans FAQ explains.
  4. Fixed Token Charges: Every MCP tool call and REST request consumes a fixed token count detailed plainly in its schema documentation. One balance covers all activated tools across your workspace.

Financial control remains strictly with account owners; AI agents cannot auto-purchase tokens or alter subscription tiers.

How to connect Claude, ChatGPT, Claude Code, Gemini CLI, Cursor or VS Code

Connecting an AI assistant to CASAFARI endpoints requires only a few configuration steps:

  • Claude (claude.ai, Claude Desktop, Mobile): Navigate to Customize → Connectors → Add custom connector, enter the target server URL (e.g., https://platform.casafari.com/mcp/comparables), and authorize via the browser window. Per Anthropic's guide to custom connectors, remote MCP connectors run from Anthropic's cloud, meaning a connector configured once instantly syncs across web, desktop, and mobile sessions. Organisation owners on Team or Enterprise plans can deploy connectors across all workspace members simultaneously.
  • ChatGPT: Turn on Developer mode, select create new connector, paste the MCP server URL, and complete the OAuth authorization prompt (OpenAI Developer mode, September 2025).
  • Claude Code & Gemini CLI: Add endpoints directly from your command terminal:
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables

gemini mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables

For Gemini CLI, run /mcp auth to authenticate your session. Developers can also review pre-built setup plugins in the casafari-mcp repository on GitHub.

  • IDE & Coding Assistants: Cursor, VS Code, Codex CLI, Zed, Cline, JetBrains Junie, Kiro, Warp, and goose connect seamlessly using standard HTTP transport settings. Follow the step-by-step connection guide for every MCP client for environment specifics.

How the platform keeps agents safe: OAuth 2.1, read-only tools, prompt injection

Security architecture on the platform is configured around explicit delegation controls (source: the platform's security model in detail):

  • OAuth 2.1 Protocols: OAuth 2.1 with PKCE and dynamic client registration keeps primary user credentials fully isolated from LLM clients. Short-lived access tokens expire after 15 minutes and are bound to individual resource servers (RFC 8707), while refresh tokens rotate on every use.
  • Server Authentication: Server-to-server scripts use restricted API keys or confidential client configurations generated in the console, with credentials passed exclusively inside HTTP headers.
  • Permission Validation: User privileges, plan status, and token balances are verified on every call.
  • Read-Only Defaults: 19 of 21 documented tools operate strictly in read-only mode, with write tools requiring explicit human authorization.
  • Prompt Injection Defense: Data returned from tool calls is isolated as structured data payloads rather than system instructions, helping prevent prompt injection vulnerabilities.

Where to go next

Frequently asked questions

What is the CASAFARI API and MCP Platform?

The CASAFARI API and MCP Platform at platform.casafari.com is a self-service platform providing AI agents and human users direct access to European real estate intelligence. A single account provides access to five MCP servers (Location Lookup, Area Insights, Comparables, AgentGraph AI, and Claro AI) alongside two REST APIs on one unified token balance. Data is drawn from a deduplicated property graph covering 16 countries (source: CASAFARI developer hub, October 2026).

How do I connect Claude or ChatGPT to CASAFARI property data?

To connect Claude, go to Customize → Connectors → Add custom connector, paste the target server URL (such as https://platform.casafari.com/mcp/comparables), and sign in using OAuth in your browser. For ChatGPT, enable Developer mode and add a connector with the MCP URL and OAuth. No API keys need to be copied manually in either application; complete setup steps are provided in the connection guide on developers.casafari.com (October 2026).

Is there a free plan, and do I need a card?

Yes, users can register for a Free plan at platform.casafari.com/console/ without entering a credit card. The Free plan provides 1,000 tokens for the first 30 days, and queries using the Location Lookup server remain free permanently. Paid options include the Agent plan monthly subscription and Custom contract plans for enterprise clients, supported by prepaid token top-ups; details are available on the plans FAQ on developers.casafari.com (October 2026).

Can an AI agent spend money on my CASAFARI account?

No, AI agents cannot spend money or purchase tokens autonomously. Every tool call consumes a fixed number of tokens specified in its description, which is checked against your account balance, and when tokens run out, only a human user can top up credits through the console. Furthermore, 19 of the 21 documented MCP tools are strictly read-only, and the two write tools in AgentGraph AI prompt the user for manual confirmation before executing (source: CASAFARI developer hub, Security page, October 2026).

Which countries and property types does the CASAFARI API cover?

The property graph indexes residential and commercial real estate, for both sale and rent, across 16 countries (US: entering now, selected states, commercial real estate only, via Claro AI) (source: CASAFARI developer hub, October 2026). AgentGraph AI focuses exclusively on verified businesses in Germany, while Claro AI covers commercial premises in Spain and commercial plots in Germany.

How secure is the CASAFARI MCP server for a company using it with Claude or ChatGPT?

Sign-in relies on OAuth 2.1 with PKCE and dynamic client registration, ensuring client applications never see or store account passwords. Access tokens are bound to specific resource servers (RFC 8707), remain valid for 15 minutes, and use rotating refresh tokens, while background agents use API keys passed securely in the Authorization header. In addition, tool outputs are parsed strictly as data rather than instructions, mitigating prompt injection risks (source: CASAFARI developer hub, Security page, October 2026).