Fulcra Context MCP Server

Retrieve an array of all moment annotations the user recorded during a period of time. Each item contains the value (except for moment annotations) and the metadata (name, original spec, etc.) describing the annotation. Args: ann_type: annotation type (moment, duration, boolean, numeric, scale, etc.) start_time: The starting time of the period. Must include tz (ISO8601). end_time: the ending time of the period. Must include tz (ISO8601).

Get details about the workouts that the user has done during a period of time. Result timestamps will include time zones. Always translate timestamps to the user's local time zone when this is known. Args: start_time: The starting time of the period. Must include tz (ISO8601). end_time: the ending time of the period. Must include tz (ISO8601).

Get the list of all annotations the user has defined. This does not get the actual values the user has recorded; for that, use the `get_annotations` tool. Use this tool to get the IDs and types to pass to `get_annotations`.

Get the catalog of available metrics that can be used in time-series API calls (`metric_time_series` and `metric_samples`).

Get user's time-series data for a single Fulcra metric. Covers the time starting at start_time (inclusive) until end_time (exclusive). Result timestamps will include tz. Always translate timestamps to the user's local tz when this is known. Args: metric_name: The name of the time-series metric to retrieve. Use `get_metrics_catalog` to find available metrics. start_time: The starting time period (inclusive). Must include tz (ISO8601). end_time: The ending time (exclusive). Must include tz (ISO8601). sample_rate: Optional. The number of seconds per sample. Default is 60. Can be smaller than 1. replace_nulls: Optional. When true, replace all NA with 0. Default is False. calculations: Optional. A list of additional calculations to perform for each time slice. Not supported on cumulative metrics. Options: "max", "min", "delta", "mean", "uniques", "allpoints", "rollingmean". Returns: A JSON string representing a list of data points for the metric. For time ranges where data is missing, the values will be NA unless replace_nulls is true.