# nearby

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



Find shared bicycles, scooters, mopeds, cars, and their stations. This tool does not return public-transport lines, places, or alerts.

## Arguments [#arguments]

| Argument  | Type      | Required | Constraints                               |
| --------- | --------- | -------- | ----------------------------------------- |
| `lat`     | number    | Yes      | -90 to 90                                 |
| `lon`     | number    | Yes      | -180 to 180                               |
| `radius`  | number    | No       | 1–400 metres                              |
| `modes`   | string\[] | No       | 1–4: `bicycle`, `scooter`, `moped`, `car` |
| `include` | string\[] | No       | 1–2: `stations`, `vehicles`               |
| `limit`   | integer   | No       | 1–100                                     |
| `offset`  | integer   | No       | 0–1,000,000                               |
| `format`  | string    | No       | `json` or `geojson`                       |
| `debug`   | boolean   | No       | Include diagnostics when supported        |

## Example [#example]

```json
{
  "name": "nearby",
  "arguments": {
    "lat": 48.8566,
    "lon": 2.3522,
    "radius": 400,
    "modes": ["bicycle", "scooter"],
    "include": ["stations", "vehicles"],
    "limit": 20
  }
}
```

## Result handling [#result-handling]

Preserve freshness, provenance, warnings, applied radius, applied limit, and coverage. Zero results do not prove zero coverage. A partial provider failure can coexist with usable results.