thryve-mcp-server 0.0.1

package/src/index.ts

@@ -0,0 +1,859 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import express, { type Request } from "express";
+import { z } from "zod";
+
+// Import schemas
+import {
+  GetAvailableDataTypesSchema,
+  ListConnectedSourcesSchema,
+  ListDevicesSchema,
+  GetActivitySchema,
+  GetHeartRateSchema,
+  GetSleepSchema,
+  GetWorkoutsSchema,
+  GetStressAndHRVSchema,
+  GetRespiratorySchema,
+  GetBloodGlucoseSchema,
+  GetBodyCompositionSchema,
+  GetWomensHealthSchema,
+  GetNutritionSchema,
+  GetCardiovascularSchema,
+  GetWellnessSchema,
+  GetAudioAndHearingSchema,
+  GetMicrobiomeSchema,
+  GetLocationSchema,
+  GetMovementAnalysisSchema,
+  SearchKeywordSchema,
+  SearchFiltersSchema,
+} from "./schemas.js";
+
+// Import tool handlers
+import {
+  getAvailableDataTypes,
+  listConnectedSources,
+  listDevices,
+  getActivity,
+  getHeartRate,
+  getSleep,
+  getWorkouts,
+  getStressAndHRV,
+  getRespiratory,
+  getBloodGlucose,
+  getBodyComposition,
+  getWomensHealth,
+  getNutrition,
+  getCardiovascular,
+  getWellness,
+  getAudioAndHearing,
+  getMicrobiome,
+  getLocation,
+  getMovementAnalysis,
+  searchKeyword,
+  searchFilters,
+} from "./tools/index.js";
+
+// Create MCP server
+const server = new Server(
+  {
+    name: "thryve-mcp-server",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Register tool handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      // PRIMARY CATEGORY-SPECIFIC TOOLS
+      {
+        name: "GetActivityData",
+        description:
+          "Get Activity data including steps, distance, floors climbed, elevation, calories burned, and general activity metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Activity.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: {
+              type: "string",
+              enum: ["daily", "epoch"],
+              description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')",
+            },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format (e.g., '2025-10-28T00:00:00Z'). Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format (e.g., '2025-10-28T23:59:59Z'). Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs (e.g., [1, 2] for Fitbit and Garmin)" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Activity'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetHeartRateData",
+        description:
+          "Get Heart Rate data including resting heart rate, average heart rate, heart rate zones, and heart rate variability. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Heart Rate.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Heart Rate'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetSleepData",
+        description:
+          "Get Sleep data including sleep duration, sleep stages (deep, light, REM), sleep efficiency, sleep quality, and sleep-related metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Sleep.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Sleep'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetWorkoutsData",
+        description:
+          "Get Workouts data including exercise sessions, workout types, duration, intensity, performance metrics (cadence, speed, pace, power), and biomechanics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Workouts.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Workouts'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetStressAndHRVData",
+        description:
+          "Get Stress & HRV data including stress levels, heart rate variability (HRV) metrics like RMSSD and SDNN, frequency power analysis, and recovery metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Stress & HRV.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Stress & HRV'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetRespiratoryData",
+        description:
+          "Get Respiratory data including breathing rate, SpO2 (blood oxygen), respiratory rate variability, and lung function metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Respiratory & Breathing.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Respiratory & Breathing'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetBloodGlucoseData",
+        description:
+          "Get Blood Glucose data including glucose levels, CGM (continuous glucose monitoring) data, and HbA1c measurements. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Blood Glucose.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Blood Glucose'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetBodyCompositionData",
+        description:
+          "Get Body Composition data including weight, height, BMI, body fat percentage, muscle mass, bone mass, and body measurements. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Body Composition & Measurements.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Body Composition & Measurements'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetWomensHealthData",
+        description:
+          "Get Women's Health data including menstrual cycle tracking, ovulation, fertility prediction, symptoms, and reproductive health metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Women's Health.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Women\\'s Health'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetNutritionData",
+        description:
+          "Get Nutrition data including calories, macros (protein, carbs, fats), micronutrients (vitamins, minerals), hydration, and meal consumption data. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Detailed Nutrition.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Detailed Nutrition'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetCardiovascularData",
+        description:
+          "Get Cardiovascular data including blood pressure, VO2 max, cardiac analysis, arrhythmia detection, and ECG data. Aggregates both cardiovascular health metrics and advanced cardiac analysis. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Cardiovascular Health, Advanced Cardiac Analysis.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Cardiovascular Health', 'Advanced Cardiac Analysis'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude (e.g., ['Advanced Cardiac Analysis'])" },
+          },
+        },
+      },
+      {
+        name: "GetWellnessData",
+        description:
+          "Get Wellness data including mood, energy levels, self-reported health data, lifestyle events, and general wellness metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Self-Reported Wellness.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Self-Reported Wellness'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetAudioAndHearingData",
+        description:
+          "Get Audio & Hearing data including hearing health, audio exposure levels (headphone and ambient), and environmental sound measurements. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Audio & Hearing Health.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Audio & Hearing Health'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetMicrobiomeData",
+        description:
+          "Get Microbiome data including gut health metrics, microbiome composition across different bacterial species, and digestive metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Microbiome & Gut Health.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Microbiome & Gut Health'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetLocationData",
+        description:
+          "Get Location data including GPS coordinates (latitude, longitude), routes, and location tracking data. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Location & GPS.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Location & GPS'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+      {
+        name: "GetMovementAnalysisData",
+        description:
+          "Get Movement Analysis data including movement patterns, gait analysis, stride length, ground contact time, vertical oscillation, and biomechanics metrics. Supports both daily aggregated data and intraday time-series data via the 'resolution' parameter. Sub-categories available for filtering with includeFields/excludeFields: Movement Analysis.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: { type: "string", enum: ["daily", "epoch"], description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data (default: 'daily')" },
+            startTimestamp: { type: "string", description: "Start time in ISO 8601 format. Defaults to 7 days ago" },
+            endTimestamp: { type: "string", description: "End time in ISO 8601 format. Defaults to now" },
+            dataSources: { type: "array", items: { type: "number" }, description: "Filter by data source IDs" },
+            limit: { type: "number", description: "Maximum records to return" },
+            includeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to include (e.g., ['Movement Analysis'])" },
+            excludeFields: { type: "array", items: { type: "string" }, description: "Sub-categories to exclude" },
+          },
+        },
+      },
+
+      // REFERENCE TOOLS
+      {
+        name: "getAvailableDataTypes",
+        description:
+          "Get comprehensive catalog of 250+ available health data types organized by the 16 high-level health categories (Activity, Heart Rate, Sleep, etc.). Returns category descriptions, data type details, units, and which wearables support each type. Use this to understand what data is available in each category before making data requests.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            category: {
+              type: "string",
+              enum: [
+                "Activity",
+                "Heart Rate",
+                "Sleep",
+                "Workouts",
+                "Stress & HRV",
+                "Respiratory",
+                "Blood Glucose",
+                "Body Composition",
+                "Womens Health",
+                "Nutrition",
+                "Cardiovascular",
+                "Wellness",
+                "Audio & Hearing",
+                "Microbiome",
+                "Location",
+                "Movement Analysis",
+              ],
+              description: "Filter by high-level health category to see available data types in that category",
+            },
+            search: {
+              type: "string",
+              description: "Search for data types by keyword (e.g., 'calories', 'steps', 'heart'). Results will be grouped by category.",
+            },
+            dataSource: {
+              type: "string",
+              description: "Filter by wearable brand (e.g., 'Fitbit', 'Garmin', 'Whoop', 'Oura'). Results will be grouped by category.",
+            },
+          },
+        },
+      },
+
+      // SEARCH AND RETRIEVAL TOOLS
+      {
+        name: "searchKeyword",
+        description:
+          "Search for health data by property name. Searches for data types matching the property name (e.g., 'SleepBinary', 'Steps', 'HeartRate') and returns matching records within the specified time range.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "Property name to search for (e.g., 'SleepBinary', 'Steps', 'HeartRate'). Searches for exact or partial matches in data type property names"
+            },
+            startDate: { type: "string", description: "Start date in YYYY-MM-DD format" },
+            endDate: { type: "string", description: "End date in YYYY-MM-DD format" },
+            dataType: { type: "string", description: "Filter by data type category (e.g., 'Activity', 'Sleep')" },
+            dataSource: { type: "string", description: "Filter by data source ID" },
+            page: { type: "number", description: "Page number for pagination (default: 1)" },
+            pageSize: { type: "number", description: "Results per page (default: 50, max: 200)" },
+            sortBy: {
+              type: "string",
+              enum: ["timestamp", "day", "value", "dataType", "dataSource"],
+              description: "Field to sort by (default: 'timestamp')"
+            },
+            sortOrder: {
+              type: "string",
+              enum: ["asc", "desc"],
+              description: "Sort order (default: 'desc')"
+            },
+          },
+          required: ["query"],
+        },
+      },
+      {
+        name: "searchFilters",
+        description:
+          "Advanced search with comprehensive filtering options. Supports filtering by data types, categories, data sources, value ranges, and time ranges. Can group results by category or return flat paginated results. Replaces the legacy getDailyData and getEpochData tools with unified functionality.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            resolution: {
+              type: "string",
+              enum: ["daily", "epoch", "both"],
+              description: "Data resolution: 'daily' for daily aggregated data, 'epoch' for intraday time-series data, 'both' for combined (default: 'both')"
+            },
+            dataTypes: {
+              type: "array",
+              items: { type: "number" },
+              description: "Filter by specific data type IDs (e.g., [1000, 3000] for Steps and HeartRate)"
+            },
+            dataSources: {
+              type: "array",
+              items: { type: "number" },
+              description: "Filter by data source IDs (e.g., [1, 2] for Fitbit and Garmin)"
+            },
+            categories: {
+              type: "array",
+              items: {
+                type: "string",
+                enum: [
+                  "Activity", "Heart Rate", "Sleep", "Workouts", "Stress & HRV",
+                  "Respiratory", "Blood Glucose", "Body Composition", "Womens Health",
+                  "Nutrition", "Cardiovascular", "Wellness", "Audio & Hearing",
+                  "Microbiome", "Location", "Movement Analysis"
+                ]
+              },
+              description: "Filter by high-level health categories"
+            },
+            groupByCategory: {
+              type: "boolean",
+              description: "Group results by category (default: false). Returns { results: { Category: [...] }, metadata: {...} } format"
+            },
+            limit: { type: "number", description: "Maximum number of records to return" },
+            startDate: { type: "string", description: "Start date in YYYY-MM-DD format" },
+            endDate: { type: "string", description: "End date in YYYY-MM-DD format" },
+            startTimestamp: { type: "string", description: "Start timestamp in ISO 8601 format" },
+            endTimestamp: { type: "string", description: "End timestamp in ISO 8601 format" },
+            valueMin: { type: "number", description: "Minimum value threshold" },
+            valueMax: { type: "number", description: "Maximum value threshold" },
+            page: { type: "number", description: "Page number for pagination (default: 1)" },
+            pageSize: { type: "number", description: "Results per page (default: 50, max: 200)" },
+            sortBy: {
+              type: "string",
+              enum: ["timestamp", "day", "value", "dataType", "dataSource"],
+              description: "Field to sort by (default: 'timestamp')"
+            },
+            sortOrder: {
+              type: "string",
+              enum: ["asc", "desc"],
+              description: "Sort order (default: 'desc')"
+            },
+          },
+        },
+      },
+      // END USER INFORMATION TOOLS
+      {
+        name: "listConnectedSources",
+        description:
+          "List all data sources (wearables, apps) that the user has connected to their Thryve account. Returns information about each connected source including the data source ID and when it was connected.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+      {
+        name: "listDevices",
+        description:
+          "List all devices that the user has connected through their data sources. Returns device names, associated data sources, connection times, and device configurations.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+    ],
+  };
+});
+
+// Store current request in context (set during HTTP request handling)
+let currentRequest: Request | null = null;
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (!currentRequest) {
+    throw new Error("No request context available. This server must be called via HTTP transport.");
+  }
+
+  try {
+    switch (request.params.name) {
+      // CATEGORY-SPECIFIC TOOLS
+      case "GetActivityData": {
+        const args = GetActivitySchema.parse(request.params.arguments);
+        const data = await getActivity(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetHeartRateData": {
+        const args = GetHeartRateSchema.parse(request.params.arguments);
+        const data = await getHeartRate(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetSleepData": {
+        const args = GetSleepSchema.parse(request.params.arguments);
+        const data = await getSleep(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetWorkoutsData": {
+        const args = GetWorkoutsSchema.parse(request.params.arguments);
+        const data = await getWorkouts(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetStressAndHRVData": {
+        const args = GetStressAndHRVSchema.parse(request.params.arguments);
+        const data = await getStressAndHRV(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetRespiratoryData": {
+        const args = GetRespiratorySchema.parse(request.params.arguments);
+        const data = await getRespiratory(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetBloodGlucoseData": {
+        const args = GetBloodGlucoseSchema.parse(request.params.arguments);
+        const data = await getBloodGlucose(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetBodyCompositionData": {
+        const args = GetBodyCompositionSchema.parse(request.params.arguments);
+        const data = await getBodyComposition(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetWomensHealthData": {
+        const args = GetWomensHealthSchema.parse(request.params.arguments);
+        const data = await getWomensHealth(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetNutritionData": {
+        const args = GetNutritionSchema.parse(request.params.arguments);
+        const data = await getNutrition(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetCardiovascularData": {
+        const args = GetCardiovascularSchema.parse(request.params.arguments);
+        const data = await getCardiovascular(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetWellnessData": {
+        const args = GetWellnessSchema.parse(request.params.arguments);
+        const data = await getWellness(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetAudioAndHearingData": {
+        const args = GetAudioAndHearingSchema.parse(request.params.arguments);
+        const data = await getAudioAndHearing(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetMicrobiomeData": {
+        const args = GetMicrobiomeSchema.parse(request.params.arguments);
+        const data = await getMicrobiome(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetLocationData": {
+        const args = GetLocationSchema.parse(request.params.arguments);
+        const data = await getLocation(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "GetMovementAnalysisData": {
+        const args = GetMovementAnalysisSchema.parse(request.params.arguments);
+        const data = await getMovementAnalysis(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      // SEARCH AND RETRIEVAL TOOLS
+      case "searchKeyword": {
+        const args = SearchKeywordSchema.parse(request.params.arguments);
+        const data = await searchKeyword(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "searchFilters": {
+        const args = SearchFiltersSchema.parse(request.params.arguments);
+        const data = await searchFilters(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      // REFERENCE TOOLS
+      case "getAvailableDataTypes": {
+        const args = GetAvailableDataTypesSchema.parse(request.params.arguments);
+        const data = await getAvailableDataTypes(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "listConnectedSources": {
+        const args = ListConnectedSourcesSchema.parse(request.params.arguments);
+        const data = await listConnectedSources(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "listDevices": {
+        const args = ListDevicesSchema.parse(request.params.arguments);
+        const data = await listDevices(currentRequest, args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      throw new Error(`Invalid arguments: ${error.message}`);
+    }
+    throw error;
+  }
+});
+
+// Create Express app with stateless HTTP transport
+const app = express();
+app.use(express.json());
+
+// Create stateless transport (no session management)
+const transport = new StreamableHTTPServerTransport({
+  sessionIdGenerator: undefined, // Stateless mode
+  enableJsonResponse: true,
+});
+
+// Connect server to transport
+await server.connect(transport);
+
+// Handle MCP requests
+app.post("/mcp", async (req, res) => {
+  try {
+    // Store request in context for tool handlers to access headers
+    currentRequest = req;
+    await transport.handleRequest(req, res, req.body);
+    currentRequest = null; // Clear context after request
+  } catch (error) {
+    currentRequest = null; // Clear context on error
+    console.error("Error handling MCP request:", error);
+    res.status(500).json({
+      error: "Internal server error",
+      message: error instanceof Error ? error.message : "Unknown error",
+    });
+  }
+});
+
+// Health check endpoint
+app.get("/health", (_req, res) => {
+  res.json({
+    status: "healthy",
+    server: "thryve-mcp-server",
+    version: "1.0.0",
+    stateless: true,
+  });
+});
+
+// Start server
+const PORT = process.env.PORT || 30000;
+app.listen(PORT, () => {
+  console.log(`Thryve MCP Server running on http://localhost:${PORT}`);
+  console.log(`MCP endpoint: http://localhost:${PORT}/mcp`);
+  console.log(`Health check: http://localhost:${PORT}/health`);
+  console.log("Mode: Stateless (no session management)");
+});