Score Premises with Your Own Agent
For AI Agent Builder. Use search_premises with a brief to retrieve and score premises, then paginate using next_cursor to ensure comprehensive data collection for your agent.
MCP tool: search_premises (REST: POST /v1/claro/search)
The Problem
Agents need to score premises based on dynamic requirements without manual intervention.
How it works
- Call
search_premiseswith yourbriefandcheck: trueto retrieve results which includefitverdicts andlocation_sources. - If your results exceed 50, pagination is required. Use
next_cursorfrom the response and send it ascursorto retrieve subsequent pages.
Example
POST https://platform.casafari.com/v1/claro/search
Authorization: Bearer $CASAFARI_API_KEY
{
"brief": "Burger restaurant with smoke outlet, Madrid, under 8000 EUR",
"check": true,
"limit": 50
}What you get
A scored set of premises with fit verdicts, location figures, and agency details.
Limites
check is forced off above 50 results.