# geocode

Canonical URL: https://doc.roote.ai/roote-mcp/mcp-tools/geocode



Resolve an address or geographic expression into ordered candidates through `GET https://api.roote.ai/v1/geocode`.

## Arguments [#arguments]

| Argument   | Type   | Required | Constraints                               |
| ---------- | ------ | -------- | ----------------------------------------- |
| `q`        | string | Yes      | 1–200 characters after trimming           |
| `language` | string | No       | 1–35 characters                           |
| `country`  | string | No       | Exactly two letters; normalized uppercase |

No additional properties are accepted.

## Example [#example]

```json
{
  "name": "geocode",
  "arguments": {
    "q": "10 rue de Rivoli, Paris",
    "language": "fr",
    "country": "FR"
  }
}
```

Use `geocode` for a postal address or geographic expression. Use [`place_search`](/roote-mcp/mcp-tools/place_search) for establishments, businesses, and POI discovery.

## Result handling [#result-handling]

Preserve normalized labels, coordinates, provider provenance, and ambiguity. The first candidate is not guaranteed unique when multiple candidates are returned.