# Claro API and MCP use cases for developers

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

What developers, product managers and AI agent builders build with Claro AI, step by step, with the operations each step calls.

## [Score every premises with your own agent](/docs/claro/use-cases/score-premises-with-your-own-agent)

For AI agent builders who score premises with their own model. Pull every match with its raw figures, matched sentences and location_sources, treat null and not_stated as unknown, and score with your own model.

## [Load every match into a CRM or warehouse nightly](/docs/claro/use-cases/nightly-pipeline-into-crm-or-bi)

For data and BI engineers at retail, restaurant, coffee or fitness chains. Page every match 200 at a time within the search's 24 hours, key rows on pm_ ids, reconcile with matching, and refresh status and price history nightly.

## [Get location figures for any point in Spain](/docs/claro/use-cases/explain-any-point-in-spain)

For developers at proptech and site-selection vendors. Send lat and lon to POST /v1/claro/location for footfall, residents and nearby places at any point in Spain, within the live-location daily limit.

## [Keyword search from a simple form, no model](/docs/claro/use-cases/keyword-search-from-a-form)

For developers at vendors who need reproducible filters with an audit trail. Send criteria.keywords and exclude_keywords with no brief and check false: reproducible results with the matched sentence as evidence.

## [Compare a shortlist for the committee dossier](/docs/claro/use-cases/compare-a-shortlist-for-a-dossier)

For developers building expansion tools or assistants for chains. Put 2 to 10 premises side by side with compare_premises and add a site assessment, fact sources and agency links from get_premises.

## [Embed the search box with a publishable key](/docs/claro/use-cases/embed-the-search-box)

For front-end developers at a franchisor or a broker. Load /embed.js with a pub_ key for a public search box, 50 results a page, and keep every other operation on your server.

## [Turn a PDF or Word brief into a search](/docs/claro/use-cases/brief-from-a-file)

For developers at proptech vendors and chains with written requirement sheets. Send a PDF, scan or Office file to brief_from_file, show the brief and its quotes for approval, then run search_premises with it.

## [Keep candidates away from your own stores](/docs/claro/use-cases/keep-candidates-away-from-your-own-stores)

For integration engineers at a franchise or coffee chain. Upload up to 5,000 store coordinates with PUT /v1/claro/stores and exclude premises within own_stores_away_m metres of any of them.

All use cases: [Use cases](/docs/use-cases#claro).