get_location_at_time

Retrieve a user's location at a specific time using ISO8601 timestamp. Searches for the closest available location sample within a defined window, including time zones. Ideal for analyzing movement or pinpointing past positions.

Instructions

Gets the user's location at the given time.

If no sample is available for the exact time, searches for the closest one up to window_size seconds back.

Result timestamps will include time zones. Always translate timestamps to the user's local time zone when this is known.

Args: time: The point in time to get the user's location for. Must include tz (ISO8601). window_size: Optional. The size (in seconds) to look back (and optionally forward) for samples. Defaults to 14400. include_after: Optional. When true, a sample that occurs after the requested time may be returned if it is the closest one. Defaults to False. Returns: A JSON string representing the location data.

Input Schema

Name	Required	Description	Default
`reverse_geocode`	No
`time`	Yes
`window_size`	No

Input Schema (JSON Schema)

{
  "properties": {
    "reverse_geocode": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": false,
      "title": "Reverse Geocode"
    },
    "time": {
      "format": "date-time",
      "title": "Time",
      "type": "string"
    },
    "window_size": {
      "default": 14400,
      "title": "Window Size",
      "type": "integer"
    }
  },
  "required": [
    "time"
  ],
  "type": "object"
}

Fulcra Context MCP