get_location_time_series

Retrieve a time series of user locations within a specified time range, with optional parameters like distance filtering, sampling rate, and reverse geocoding. Results include timestamps adjusted to the user's local time zone.

Instructions

Retrieve a time series of locations that the user was at. Result timestamps will include time zones. Always translate timestamps to the user's local tz when this is known.

Args: start_time: The start of the time range (inclusive), as an ISO 8601 string or datetime object. end_time: The end of the range (exclusive), as an ISO 8601 string or datetime object. change_meters: Optional. When specified, subsequent samples that are fewer than this many meters away will not be included. sample_rate: Optional. The length (in seconds) of each sample. Default is 900. reverse_geocode: Optional. When true, Fulcra will attempt to reverse geocode the locations and include the details in the results. Default is False. Returns: A JSON string representing a list of location data points.

Input Schema

Name	Required	Description	Default
`change_meters`	No
`end_time`	Yes
`reverse_geocode`	No
`sample_rate`	No
`start_time`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "change_meters": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Change Meters"
    },
    "end_time": {
      "format": "date-time",
      "title": "End Time",
      "type": "string"
    },
    "reverse_geocode": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": false,
      "title": "Reverse Geocode"
    },
    "sample_rate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 900,
      "title": "Sample Rate"
    },
    "start_time": {
      "format": "date-time",
      "title": "Start Time",
      "type": "string"
    }
  },
  "required": [
    "start_time",
    "end_time"
  ],
  "type": "object"
}

Fulcra Context MCP