Use cases and worked examples · FAQ
How do I turn a place name into a location id?
Use ma_get_location_typeahead to turn an English place name into location ids. Most Casafari tools take a location as ids, a circle or a polygon rather than a name.
- Over MCP,
ma_get_location_typeaheadreturns each match with itslocation_id, administrative level and breadcrumbs. If several places share a name, add more detail to the request. The ids it returns work with the Area Insights tools. - For Germany,
agentgraph_find_locationfinds cities, districts and states. The AgentGraph AI tools also accept a name or a postcode directly. - Over REST,
POST /api/v1/references/locations/typeaheadis scoped to ES or PT.GET /api/v1/references/locations/by-coordinatesresolves a point, andPOST /api/v1/references/locationsreads the location tree.
comps_get-comparables doesn't need an id. It takes coordinates, an address or a cadastral reference.
See: Area Insights and References.
Where this is documented
- ma_get_location_typeahead
- agentgraph_find_location
- Get locations typeahead suggestions scoped by country code (v1)
- Get location by passed coordinates (v1)
- Get locations (v1)
- Area Insights
- References
Related questions
- How do I value a home or find comparables with Casafari MCP?
- How do I analyse how prices in an area have moved over time?
- How do I see how properties are distributed by price, bedrooms or time on market, or get a heatmap?
- Can I build a market report with Casafari MCP?
- How do I find agencies or agents to partner with in a German city?