# `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).

## Description

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.

## Parameters

- `location_name` (string, required)

## Response

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)

## Example call

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)