Get Location
get_locationRead-only
Retrieve the user's location at a specific time or across a time range sampled at a set interval, optionally returning addresses. Use it to reconstruct where someone was during a moment or period.
Instructions
Get where the user was: at one moment (time), or over a range
(start_time and end_time) as one location per sample_rate seconds.
Result timestamps include time zones. Always translate them to the user's local time zone when this is known.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_location"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | No | The moment to locate the user at. Must include tz (ISO8601). Without a sample at that exact time, the closest one within window_size seconds before or after is used. | |
| end_time | No | Range end (exclusive). Must include tz (ISO8601). | |
| start_time | No | Range start (inclusive). Must include tz (ISO8601). | |
| sample_rate | No | Range only: seconds per sample (default 900). | |
| window_size | No | Moment only: seconds around `time` to search for a sample (default 14400). | |
| change_meters | No | Range only: drop samples fewer than this many meters from the previous one. | |
| fulcra_userid | No | Retrieve data for another Fulcra user (if shared). | |
| include_after | No | Moment only: allow the closest sample to be after `time` (default true); false finds where the user last was at or before it. | |
| reverse_geocode | No | Include the address (default: true for a moment, false for a range). |