# `ma_get_location_typeahead`

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

Get Location Typeahead. Product: [Area Insights](/docs/area-insights). Annotations: Read-only.

Call it as `ma_get_location_typeahead` on `https://mcp.casafari.com/` (the backend's own name is `get_location_typeahead`).

Over REST: [`POST /api/v1/references/locations/typeahead`](/docs/rest/references/get-locations-typeahead-suggestions-scoped-by-country-code-v1) (related). [MCP and REST compared](/docs/parity#area-insights).

## What does Get Location Typeahead do?

Retrieve typeahead suggestions for a given location name.

Use case:
    Retrieve typeahead suggestions to get location_id for different requests.

Important notes:
- If there is more than one location with the same name, and it's not clear which one is correct - specify more
information / symbols in the request.
- The `location_name` should be a valid location name in English.

## Which parameters does ma_get_location_typeahead take?

- `location_name` (string, required)

## What does it return?

The result is returned as `result`:

- `location_id` (integer, required)
- `name` (string, required)
- `matched_name` (string, required)
- `administrative_level` (string, required)
- `breadcrumbs` (object[], required)
  - `location_id` (integer, required)
  - `name` (string, required)

## How do I call ma_get_location_typeahead?

Required arguments only, with placeholder values; see the parameters above for real ones.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ma_get_location_typeahead",
    "arguments": {
      "location_name": "…"
    }
  }
}
```

## Questions about this

- [What is Area Insights?](/docs/faq/what-is-area-insights)
- [How do I value a home or find comparables with Casafari MCP?](/docs/faq/example-valuation)
- [How do I analyse how prices in an area have moved over time?](/docs/faq/example-price-trend)
- [How do I turn a place name into a location id?](/docs/faq/location-ids)

## Related pages

- [Get Current Datetime (ma_get_current_datetime)](/docs/area-insights/get_current_datetime)
- [Get Time Series Data (ma_get_time_series_data)](/docs/area-insights/get_time_series_data)
- [Get Time Series Operations (ma_get_time_series_operations)](/docs/area-insights/get_time_series_operations)
- [Get Price Distribution (ma_get_price_distribution)](/docs/area-insights/get_price_distribution)
- [Area Insights: all its MCP tools and REST operations](/docs/area-insights)
- [Connect an MCP client](/docs/connect)
- [All Casafari MCP tools](/docs/tools)