hevy-mcp 1.23.23 → 1.24.0

package/README.md

@@ -167,13 +167,15 @@ Docker-based workflows are retired. The provided `Dockerfile` now exits with a m
 
 ## 🛠️ Available MCP Tools
 
-| Category      | Tools                                                                                                        |
-| :------------ | :----------------------------------------------------------------------------------------------------------- |
-| **Workouts**  | `get-workouts`, `get-workout`, `create-workout`, `update-workout`, `get-workout-count`, `get-workout-events` |
-| **Routines**  | `get-routines`, `get-routine-by-id`, `create-routine`, `update-routine`                                      |
-| **Templates** | `get-exercise-templates`, `get-exercise-template`, `search-exercise-templates`                               |
-| **Folders**   | `get-routine-folders`, `get-routine-folder`, `create-routine-folder`                                         |
-| **Webhooks**  | `get-webhook-subscription`, `create-webhook-subscription`, `delete-webhook-subscription`                     |
+| Category              | Tools                                                                                                                              |
+| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
+| **Workouts**          | `get-workouts`, `get-workout`, `create-workout`, `update-workout`, `get-workout-count`, `get-workout-events`                       |
+| **Routines**          | `get-routines`, `get-routine`, `create-routine`, `update-routine`                                                                  |
+| **Templates**         | `get-exercise-templates`, `get-exercise-template`, `search-exercise-templates`, `create-exercise-template`, `get-exercise-history` |
+| **Folders**           | `get-routine-folders`, `get-routine-folder`, `create-routine-folder`                                                               |
+| **Body Measurements** | `get-body-measurements`, `get-body-measurement`, `create-body-measurement`, `update-body-measurement`                              |
+| **User**              | `get-user-info`                                                                                                                    |
+| **Webhooks**          | `get-webhook-subscription`, `create-webhook-subscription`, `delete-webhook-subscription`                                           |
 
 ---
 

package/dist/cli.mjs

@@ -4,12 +4,12 @@
 (function() {
 	try {
 		var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {};
-		e.SENTRY_RELEASE = { id: "1.23.22" };
+		e.SENTRY_RELEASE = { id: "1.23.24" };
 		var n = new e.Error().stack;
 		n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "03cf150f-6466-4ca3-9cf1-e423cc0e3cd2", e._sentryDebugIdIdentifier = "sentry-dbid-03cf150f-6466-4ca3-9cf1-e423cc0e3cd2");
 	} catch (e) {}
 })();
-import { r as runServer } from "./src-Cag-RZcj.mjs";
+import { r as runServer } from "./src-BVYF4gvN.mjs";
 //#region src/cli.ts
 runServer().catch((error) => {
 	console.error("Fatal error in main():", error);

package/dist/index.mjs

@@ -4,10 +4,10 @@
 (function() {
 	try {
 		var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {};
-		e.SENTRY_RELEASE = { id: "1.23.22" };
+		e.SENTRY_RELEASE = { id: "1.23.24" };
 		var n = new e.Error().stack;
 		n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a23492d3-dc93-45b6-9c01-6c2fef1c843d", e._sentryDebugIdIdentifier = "sentry-dbid-a23492d3-dc93-45b6-9c01-6c2fef1c843d");
 	} catch (e) {}
 })();
-import { n as createServer, r as runServer, t as configSchema } from "./src-Cag-RZcj.mjs";
+import { n as createServer, r as runServer, t as configSchema } from "./src-BVYF4gvN.mjs";
 export { configSchema, createServer as default, runServer };

package/dist/{src-Cag-RZcj.mjs → src-BVYF4gvN.mjs}

@@ -4,12 +4,13 @@
 (function() {
 	try {
 		var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {};
-		e.SENTRY_RELEASE = { id: "1.23.22" };
+		e.SENTRY_RELEASE = { id: "1.23.24" };
 		var n = new e.Error().stack;
-		n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "25b3bb9e-9300-46a5-a29a-f2bf244304ef", e._sentryDebugIdIdentifier = "sentry-dbid-25b3bb9e-9300-46a5-a29a-f2bf244304ef");
+		n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "257cac61-1bfb-4591-a911-cb5e1e8f1dbd", e._sentryDebugIdIdentifier = "sentry-dbid-257cac61-1bfb-4591-a911-cb5e1e8f1dbd");
 	} catch (e) {}
 })();
 import * as Sentry from "@sentry/node";
+import { createHmac } from "node:crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -294,8 +295,51 @@ function createEmptyResponse(message = "No data found") {
 	}] };
 }
 //#endregion
+//#region src/utils/tool-annotations.ts
+/** Read-only tools (get-*, search-*): no side effects. */
+function readOnlyAnnotations(title) {
+	return {
+		title,
+		readOnlyHint: true,
+		openWorldHint: false
+	};
+}
+/** Create tools (create-*): additive writes, repeating creates duplicates. */
+function createAnnotations(title) {
+	return {
+		title,
+		readOnlyHint: false,
+		destructiveHint: false,
+		idempotentHint: false,
+		openWorldHint: false
+	};
+}
+/**
+* Update tools (update-*): PUT-style overwrites that replace prior data,
+* hence destructive; repeating the same call yields the same state.
+*/
+function updateAnnotations(title) {
+	return {
+		title,
+		readOnlyHint: false,
+		destructiveHint: true,
+		idempotentHint: true,
+		openWorldHint: false
+	};
+}
+/** Delete tools (delete-*): destructive and idempotent. */
+function destructiveAnnotations(title) {
+	return {
+		title,
+		readOnlyHint: false,
+		destructiveHint: true,
+		idempotentHint: true,
+		openWorldHint: false
+	};
+}
+//#endregion
 //#region src/tools/body-measurements.ts
-const zNullableNumber = z.number().nullable().optional();
+const zNullableNumber = z.preprocess((value) => value === "" ? void 0 : value, z.coerce.number().nullable().optional());
 const bodyMeasurementFieldsSchema = {
 	weightKg: zNullableNumber.describe("Body weight in kilograms"),
 	leanMassKg: zNullableNumber.describe("Lean body mass in kilograms"),
@@ -315,33 +359,39 @@ const bodyMeasurementFieldsSchema = {
 	leftCalf: zNullableNumber.describe("Left calf circumference in centimeters"),
 	rightCalf: zNullableNumber.describe("Right calf circumference in centimeters")
 };
+const MEASUREMENT_FIELD_TO_API_KEY = {
+	weightKg: "weight_kg",
+	leanMassKg: "lean_mass_kg",
+	fatPercent: "fat_percent",
+	neckCm: "neck_cm",
+	shoulderCm: "shoulder_cm",
+	chestCm: "chest_cm",
+	leftBicepCm: "left_bicep_cm",
+	rightBicepCm: "right_bicep_cm",
+	leftForearmCm: "left_forearm_cm",
+	rightForearmCm: "right_forearm_cm",
+	abdomen: "abdomen",
+	waist: "waist",
+	hips: "hips",
+	leftThigh: "left_thigh",
+	rightThigh: "right_thigh",
+	leftCalf: "left_calf",
+	rightCalf: "right_calf"
+};
 function buildMeasurementPayload(args) {
-	return {
-		weight_kg: args.weightKg ?? null,
-		lean_mass_kg: args.leanMassKg ?? null,
-		fat_percent: args.fatPercent ?? null,
-		neck_cm: args.neckCm ?? null,
-		shoulder_cm: args.shoulderCm ?? null,
-		chest_cm: args.chestCm ?? null,
-		left_bicep_cm: args.leftBicepCm ?? null,
-		right_bicep_cm: args.rightBicepCm ?? null,
-		left_forearm_cm: args.leftForearmCm ?? null,
-		right_forearm_cm: args.rightForearmCm ?? null,
-		abdomen: args.abdomen ?? null,
-		waist: args.waist ?? null,
-		hips: args.hips ?? null,
-		left_thigh: args.leftThigh ?? null,
-		right_thigh: args.rightThigh ?? null,
-		left_calf: args.leftCalf ?? null,
-		right_calf: args.rightCalf ?? null
-	};
+	const payload = {};
+	for (const [camelKey, apiKey] of Object.entries(MEASUREMENT_FIELD_TO_API_KEY)) {
+		const value = args[camelKey];
+		if (value != null) payload[apiKey] = value;
+	}
+	return payload;
 }
 function registerBodyMeasurementTools(server, hevyClient) {
 	const getBodyMeasurementsSchema = {
 		page: z.coerce.number().int().gte(1).default(1),
 		pageSize: z.coerce.number().int().gte(1).lte(10).default(10)
 	};
-	server.tool("get-body-measurements", "Get a paginated list of body measurements for the authenticated user. Returns measurements including weight, body fat, and various circumference measurements.", getBodyMeasurementsSchema, withErrorHandling(async (args) => {
+	server.tool("get-body-measurements", "Get a paginated list of body measurements for the authenticated user. Returns measurements including weight, body fat, and various circumference measurements.", getBodyMeasurementsSchema, readOnlyAnnotations("Get Body Measurements"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { page, pageSize } = args;
 		const measurements = (await hevyClient.getBodyMeasurements({
@@ -352,7 +402,7 @@ function registerBodyMeasurementTools(server, hevyClient) {
 		return createJsonResponse(measurements);
 	}, "get-body-measurements"));
 	const getBodyMeasurementSchema = { date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format").describe("The date of the body measurement (YYYY-MM-DD)") };
-	server.tool("get-body-measurement", "Get a single body measurement by date. Returns all measurement fields for the specified date.", getBodyMeasurementSchema, withErrorHandling(async (args) => {
+	server.tool("get-body-measurement", "Get a single body measurement by date. Returns all measurement fields for the specified date.", getBodyMeasurementSchema, readOnlyAnnotations("Get Body Measurement"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { date } = args;
 		const data = await hevyClient.getBodyMeasurement(date);
@@ -363,7 +413,7 @@ function registerBodyMeasurementTools(server, hevyClient) {
 		date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format").describe("The date of the body measurement (YYYY-MM-DD). Must be unique — returns 409 if an entry already exists for this date."),
 		...bodyMeasurementFieldsSchema
 	};
-	server.tool("create-body-measurement", "Create a body measurement entry for a given date. All measurement fields are optional. Returns 409 if an entry already exists for that date — use update-body-measurement instead.", createBodyMeasurementSchema, withErrorHandling(async (args) => {
+	server.tool("create-body-measurement", "Create a body measurement entry for a given date. All measurement fields are optional; null values are treated as omitted, since the Hevy API does not support clearing individual fields. Returns 409 if an entry already exists for that date — use update-body-measurement instead.", createBodyMeasurementSchema, createAnnotations("Create Body Measurement"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { date, ...fields } = args;
 		await hevyClient.createBodyMeasurement({
@@ -376,10 +426,12 @@ function registerBodyMeasurementTools(server, hevyClient) {
 		date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format").describe("The date of the body measurement to update (YYYY-MM-DD). Must already exist — returns 404 otherwise."),
 		...bodyMeasurementFieldsSchema
 	};
-	server.tool("update-body-measurement", "Update an existing body measurement entry for a given date. All fields are overwritten — omitted fields are set to null. Returns 404 if no entry exists for the date.", updateBodyMeasurementSchema, withErrorHandling(async (args) => {
+	server.tool("update-body-measurement", "Update an existing body measurement entry for a given date. Only the fields you provide are sent and updated; null values are treated as omitted, since the Hevy API does not support clearing individual fields. Requires at least one measurement field. Returns 404 if no entry exists for the date.", updateBodyMeasurementSchema, updateAnnotations("Update Body Measurement"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { date, ...fields } = args;
-		await hevyClient.updateBodyMeasurement(date, buildMeasurementPayload(fields));
+		const payload = buildMeasurementPayload(fields);
+		if (Object.keys(payload).length === 0) throw new Error("No measurement fields provided. Include at least one numeric measurement field (e.g. weightKg) to update.");
+		await hevyClient.updateBodyMeasurement(date, payload);
 		return createTextResponse(`Body measurement for ${date} updated successfully.`);
 	}, "update-body-measurement"));
 }
@@ -393,7 +445,7 @@ function registerFolderTools(server, hevyClient) {
 		page: z.coerce.number().int().gte(1).default(1),
 		pageSize: z.coerce.number().int().gte(1).lte(10).default(5)
 	};
-	server.tool("get-routine-folders", "Get a paginated list of your routine folders, including both default and custom folders. Useful for organizing and browsing your workout routines.", getRoutineFoldersSchema, withErrorHandling(async (args) => {
+	server.tool("get-routine-folders", "Get a paginated list of your routine folders, including both default and custom folders. Useful for organizing and browsing your workout routines.", getRoutineFoldersSchema, readOnlyAnnotations("Get Routine Folders"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { page, pageSize } = args;
 		const folders = (await hevyClient.getRoutineFolders({
@@ -404,7 +456,7 @@ function registerFolderTools(server, hevyClient) {
 		return createJsonResponse(folders);
 	}, "get-routine-folders"));
 	const getRoutineFolderSchema = { folderId: z.string().min(1) };
-	server.tool("get-routine-folder", "Get complete details of a specific routine folder by its ID, including name, creation date, and associated routines.", getRoutineFolderSchema, withErrorHandling(async (args) => {
+	server.tool("get-routine-folder", "Get complete details of a specific routine folder by its ID, including name, creation date, and associated routines.", getRoutineFolderSchema, readOnlyAnnotations("Get Routine Folder"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { folderId } = args;
 		const data = await hevyClient.getRoutineFolder(folderId);
@@ -412,7 +464,7 @@ function registerFolderTools(server, hevyClient) {
 		return createJsonResponse(formatRoutineFolder(data));
 	}, "get-routine-folder"));
 	const createRoutineFolderSchema = { name: z.string().min(1) };
-	server.tool("create-routine-folder", "Create a new routine folder in your Hevy account. Requires a name for the folder. Returns the full folder details including the new folder ID.", createRoutineFolderSchema, withErrorHandling(async (args) => {
+	server.tool("create-routine-folder", "Create a new routine folder in your Hevy account. Requires a name for the folder. Returns the full folder details including the new folder ID.", createRoutineFolderSchema, createAnnotations("Create Routine Folder"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { name } = args;
 		const data = await hevyClient.createRoutineFolder({ routine_folder: { title: name } });
@@ -493,7 +545,7 @@ function registerRoutineTools(server, hevyClient) {
 		page: z.coerce.number().int().gte(1).default(1),
 		pageSize: z.coerce.number().int().gte(1).lte(10).default(5)
 	};
-	server.tool("get-routines", "Get a paginated list of your workout routines, including custom and default routines. Useful for browsing or searching your available routines.", getRoutinesSchema, withErrorHandling(async (args) => {
+	server.tool("get-routines", "Get a paginated list of your workout routines, including custom and default routines. Useful for browsing or searching your available routines.", getRoutinesSchema, readOnlyAnnotations("Get Routines"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { page, pageSize } = args;
 		const routines = (await hevyClient.getRoutines({
@@ -504,7 +556,7 @@ function registerRoutineTools(server, hevyClient) {
 		return createJsonResponse(routines);
 	}, "get-routines"));
 	const getRoutineSchema = { routineId: z.string().min(1) };
-	server.tool("get-routine", "Get a routine by its ID using the direct endpoint. Returns all details for the specified routine.", getRoutineSchema, withErrorHandling(async (args) => {
+	server.tool("get-routine", "Get a routine by its ID using the direct endpoint. Returns all details for the specified routine.", getRoutineSchema, readOnlyAnnotations("Get Routine"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { routineId } = args;
 		const data = await hevyClient.getRoutineById(String(routineId));
@@ -539,7 +591,7 @@ function registerRoutineTools(server, hevyClient) {
 			}))
 		})))
 	};
-	server.tool("create-routine", "Create a new workout routine in your Hevy account. Requires a title and at least one exercise with sets. Optionally assign to a folder. Returns the full routine details including the new routine ID.", createRoutineSchema, withErrorHandling(async (args) => {
+	server.tool("create-routine", "Create a new workout routine in your Hevy account. Requires a title and at least one exercise with sets. Optionally assign to a folder. Returns the full routine details including the new routine ID.", createRoutineSchema, createAnnotations("Create Routine"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { title, folderId, notes, exercises } = args;
 		let usesRepRanges = false;
@@ -611,7 +663,7 @@ function registerRoutineTools(server, hevyClient) {
 			}))
 		})))
 	};
-	server.tool("update-routine", "Update an existing routine by ID. You can modify the title, notes, and exercise configurations. Returns the updated routine with all changes applied.", updateRoutineSchema, withErrorHandling(async (args) => {
+	server.tool("update-routine", "Update an existing routine by ID. You can modify the title, notes, and exercise configurations. Returns the updated routine with all changes applied.", updateRoutineSchema, updateAnnotations("Update Routine"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { routineId, title, notes, exercises } = args;
 		let usesRepRanges = false;
@@ -689,7 +741,7 @@ function registerTemplateTools(server, hevyClient) {
 		page: z.coerce.number().int().gte(1).default(1),
 		pageSize: z.coerce.number().int().gte(1).lte(100).default(5)
 	};
-	server.tool("get-exercise-templates", "Get a paginated list of exercise templates (default and custom) with details like name, category, equipment, and muscle groups. Useful for browsing or searching available exercises.", getExerciseTemplatesSchema, withErrorHandling(async (args) => {
+	server.tool("get-exercise-templates", "Get a paginated list of exercise templates (default and custom) with details like name, category, equipment, and muscle groups. Useful for browsing or searching available exercises.", getExerciseTemplatesSchema, readOnlyAnnotations("Get Exercise Templates"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { page, pageSize } = args;
 		const templates = (await hevyClient.getExerciseTemplates({
@@ -700,7 +752,7 @@ function registerTemplateTools(server, hevyClient) {
 		return createJsonResponse(templates);
 	}, "get-exercise-templates"));
 	const getExerciseTemplateSchema = { exerciseTemplateId: z.string().min(1) };
-	server.tool("get-exercise-template", "Get complete details of a specific exercise template by its ID, including name, category, equipment, muscle groups, and notes.", getExerciseTemplateSchema, withErrorHandling(async (args) => {
+	server.tool("get-exercise-template", "Get complete details of a specific exercise template by its ID, including name, category, equipment, muscle groups, and notes.", getExerciseTemplateSchema, readOnlyAnnotations("Get Exercise Template"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { exerciseTemplateId } = args;
 		const data = await hevyClient.getExerciseTemplate(exerciseTemplateId);
@@ -712,7 +764,7 @@ function registerTemplateTools(server, hevyClient) {
 		startDate: z.string().datetime({ offset: true }).describe("ISO 8601 start date for filtering history").optional(),
 		endDate: z.string().datetime({ offset: true }).describe("ISO 8601 end date for filtering history").optional()
 	};
-	server.tool("get-exercise-history", "Get past sets for a specific exercise template, optionally filtered by start and end dates.", getExerciseHistorySchema, withErrorHandling(async (args) => {
+	server.tool("get-exercise-history", "Get past sets for a specific exercise template, optionally filtered by start and end dates.", getExerciseHistorySchema, readOnlyAnnotations("Get Exercise History"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { exerciseTemplateId, startDate, endDate } = args;
 		const history = (await hevyClient.getExerciseHistory(exerciseTemplateId, {
@@ -748,7 +800,7 @@ function registerTemplateTools(server, hevyClient) {
 		muscleGroup: z.enum(MUSCLE_GROUPS),
 		otherMuscles: z.array(z.enum(MUSCLE_GROUPS)).default([])
 	};
-	server.tool("create-exercise-template", "Create a custom exercise template with title, type, equipment, and muscle groups.", createExerciseTemplateSchema, withErrorHandling(async (args) => {
+	server.tool("create-exercise-template", "Create a custom exercise template with title, type, equipment, and muscle groups.", createExerciseTemplateSchema, createAnnotations("Create Exercise Template"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { title, exerciseType, equipmentCategory, muscleGroup, otherMuscles } = args;
 		return createJsonResponse({
@@ -767,7 +819,7 @@ function registerTemplateTools(server, hevyClient) {
 		primaryMuscleGroup: z.enum(MUSCLE_GROUPS).optional().describe("Optional filter to restrict results to a specific primary muscle group"),
 		refresh: z.boolean().optional().default(false).describe("Set to true to bust the in-memory cache and re-fetch all templates from the API")
 	};
-	server.tool("search-exercise-templates", "Search exercise templates by name with optional muscle group filter. Fetches all templates from the Hevy API on first call and caches them in memory for subsequent searches. Use refresh:true to force a re-fetch.", searchExerciseTemplatesSchema, withErrorHandling(async (args) => {
+	server.tool("search-exercise-templates", "Search exercise templates by name with optional muscle group filter. Fetches all templates from the Hevy API on first call and caches them in memory for subsequent searches. Use refresh:true to force a re-fetch.", searchExerciseTemplatesSchema, readOnlyAnnotations("Search Exercise Templates"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { query, primaryMuscleGroup, refresh } = args;
 		if (exerciseTemplateCache === null || refresh) {
@@ -801,6 +853,16 @@ function registerTemplateTools(server, hevyClient) {
 	}, "search-exercise-templates"));
 }
 //#endregion
+//#region src/tools/user.ts
+function registerUserTools(server, hevyClient) {
+	server.tool("get-user-info", "Get the authenticated user's account info, including user ID, display name, and public profile URL. Useful for verifying which account the API key belongs to.", {}, readOnlyAnnotations("Get User Info"), withErrorHandling(async (_args) => {
+		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
+		const data = await hevyClient.getUserInfo();
+		if (!data?.data) return createEmptyResponse("No user info found for the authenticated user");
+		return createJsonResponse(data.data);
+	}, "get-user-info"));
+}
+//#endregion
 //#region src/tools/webhooks.ts
 const webhookUrlSchema = z.string().url().refine((url) => {
 	try {
@@ -818,7 +880,7 @@ const webhookUrlSchema = z.string().url().refine((url) => {
 	}
 }, { message: "Webhook URL cannot be localhost or loopback address" });
 function registerWebhookTools(server, hevyClient) {
-	server.tool("get-webhook-subscription", "Get the current webhook subscription for this account. Returns the webhook URL and auth token if a subscription exists.", {}, withErrorHandling(async (_args) => {
+	server.tool("get-webhook-subscription", "Get the current webhook subscription for this account. Returns the webhook URL and auth token if a subscription exists.", {}, readOnlyAnnotations("Get Webhook Subscription"), withErrorHandling(async (_args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		if (!hevyClient.getWebhookSubscription) throw new Error("Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec.");
 		const data = await hevyClient.getWebhookSubscription();
@@ -829,7 +891,7 @@ function registerWebhookTools(server, hevyClient) {
 		url: webhookUrlSchema.describe("The webhook URL that will receive POST requests when workouts are created"),
 		authToken: z.string().optional().describe("Optional auth token that will be sent as Authorization header in webhook requests")
 	};
-	server.tool("create-webhook-subscription", "Create a new webhook subscription for this account. The webhook will receive POST requests when workouts are created. Your endpoint must respond with 200 OK within 5 seconds.", createWebhookSubscriptionSchema, withErrorHandling(async (args) => {
+	server.tool("create-webhook-subscription", "Create a new webhook subscription for this account. The webhook will receive POST requests when workouts are created. Your endpoint must respond with 200 OK within 5 seconds.", createWebhookSubscriptionSchema, createAnnotations("Create Webhook Subscription"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { url, authToken } = args;
 		if (!hevyClient.createWebhookSubscription) throw new Error("Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec.");
@@ -840,7 +902,7 @@ function registerWebhookTools(server, hevyClient) {
 		if (!data) return createEmptyResponse("Failed to create webhook subscription - please check your URL and try again");
 		return createJsonResponse(data);
 	}, "create-webhook-subscription"));
-	server.tool("delete-webhook-subscription", "Delete the current webhook subscription for this account. This will stop all webhook notifications.", {}, withErrorHandling(async (_args) => {
+	server.tool("delete-webhook-subscription", "Delete the current webhook subscription for this account. This will stop all webhook notifications.", {}, destructiveAnnotations("Delete Webhook Subscription"), withErrorHandling(async (_args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		if (!hevyClient.deleteWebhookSubscription) throw new Error("Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec.");
 		const data = await hevyClient.deleteWebhookSubscription();
@@ -858,7 +920,7 @@ function registerWorkoutTools(server, hevyClient) {
 		page: z.coerce.number().gte(1).default(1),
 		pageSize: z.coerce.number().int().gte(1).lte(10).default(5)
 	};
-	server.tool("get-workouts", "Get a paginated list of workouts. Returns workout details including title, description, start/end times, and exercises performed. Results are ordered from newest to oldest.", getWorkoutsSchema, withErrorHandling(async (args) => {
+	server.tool("get-workouts", "Get a paginated list of workouts. Returns workout details including title, description, start/end times, and exercises performed. Results are ordered from newest to oldest.", getWorkoutsSchema, readOnlyAnnotations("Get Workouts"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { page, pageSize } = args;
 		const workouts = (await hevyClient.getWorkouts({
@@ -869,14 +931,14 @@ function registerWorkoutTools(server, hevyClient) {
 		return createJsonResponse(workouts);
 	}, "get-workouts"));
 	const getWorkoutSchema = { workoutId: z.string().min(1) };
-	server.tool("get-workout", "Get complete details of a specific workout by ID. Returns all workout information including title, description, start/end times, and detailed exercise data.", getWorkoutSchema, withErrorHandling(async (args) => {
+	server.tool("get-workout", "Get complete details of a specific workout by ID. Returns all workout information including title, description, start/end times, and detailed exercise data.", getWorkoutSchema, readOnlyAnnotations("Get Workout"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { workoutId } = args;
 		const data = await hevyClient.getWorkout(workoutId);
 		if (!data) return createEmptyResponse(`Workout with ID ${workoutId} not found`);
 		return createJsonResponse(formatWorkout(data));
 	}, "get-workout"));
-	server.tool("get-workout-count", "Get the total number of workouts on the account. Useful for pagination or statistics.", {}, withErrorHandling(async () => {
+	server.tool("get-workout-count", "Get the total number of workouts on the account. Useful for pagination or statistics.", {}, readOnlyAnnotations("Get Workout Count"), withErrorHandling(async () => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		return createJsonResponse({ count: (await hevyClient.getWorkoutCount())?.workout_count ?? 0 });
 	}, "get-workout-count"));
@@ -885,7 +947,7 @@ function registerWorkoutTools(server, hevyClient) {
 		pageSize: z.coerce.number().int().gte(1).lte(10).default(5),
 		since: z.string().default("1970-01-01T00:00:00Z")
 	};
-	server.tool("get-workout-events", "Retrieve a paged list of workout events (updates or deletes) since a given date. Events are ordered from newest to oldest. The intention is to allow clients to keep their local cache of workouts up to date without having to fetch the entire list of workouts.", getWorkoutEventsSchema, withErrorHandling(async (args) => {
+	server.tool("get-workout-events", "Retrieve a paged list of workout events (updates or deletes) since a given date. Events are ordered from newest to oldest. The intention is to allow clients to keep their local cache of workouts up to date without having to fetch the entire list of workouts.", getWorkoutEventsSchema, readOnlyAnnotations("Get Workout Events"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { page, pageSize, since } = args;
 		const events = (await hevyClient.getWorkoutEvents({
@@ -925,7 +987,7 @@ function registerWorkoutTools(server, hevyClient) {
 			}))
 		})))
 	};
-	server.tool("create-workout", "Create a new workout in your Hevy account. Requires title, start/end times, and at least one exercise with sets. Returns the complete workout details upon successful creation including the newly assigned workout ID.", createWorkoutSchema, withErrorHandling(async (args) => {
+	server.tool("create-workout", "Create a new workout in your Hevy account. Requires title, start/end times, and at least one exercise with sets. Returns the complete workout details upon successful creation including the newly assigned workout ID.", createWorkoutSchema, createAnnotations("Create Workout"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { title, description, startTime, endTime, isPrivate, exercises } = args;
 		const requestBody = { workout: {
@@ -986,7 +1048,7 @@ function registerWorkoutTools(server, hevyClient) {
 			}))
 		})))
 	};
-	server.tool("update-workout", "Update an existing workout by ID. You can modify the title, description, start/end times, privacy setting, and exercise data. Returns the updated workout with all changes applied.", updateWorkoutSchema, withErrorHandling(async (args) => {
+	server.tool("update-workout", "Update an existing workout by ID. You can modify the title, description, start/end times, privacy setting, and exercise data. Returns the updated workout with all changes applied.", updateWorkoutSchema, updateAnnotations("Update Workout"), withErrorHandling(async (args) => {
 		if (!hevyClient) throw new Error("API client not initialized. Please provide HEVY_API_KEY.");
 		const { workoutId, title, description, startTime, endTime, isPrivate, exercises } = args;
 		const requestBody = { workout: {
@@ -1312,6 +1374,34 @@ async function getV1RoutinesRoutineid(routineId, headers, config = {}) {
 	})).data;
 }
 //#endregion
+//#region src/generated/client/api/getV1UserInfo.ts
+/**
+* Generated by Kubb (https://kubb.dev/).
+* Do not edit manually.
+*/
+function getGetV1UserInfoUrl() {
+	return {
+		method: "GET",
+		url: `/v1/user/info`
+	};
+}
+/**
+* @summary Get user info
+* {@link /v1/user/info}
+*/
+async function getV1UserInfo(headers, config = {}) {
+	const { client: request = fetch, ...requestConfig } = config;
+	return (await request({
+		method: "GET",
+		url: getGetV1UserInfoUrl().url.toString(),
+		...requestConfig,
+		headers: {
+			...headers,
+			...requestConfig.headers
+		}
+	})).data;
+}
+//#endregion
 //#region src/generated/client/api/getV1Workouts.ts
 /**
 * Generated by Kubb (https://kubb.dev/).
@@ -1707,6 +1797,7 @@ function createClient$1(apiKey, baseUrl = "https://api.hevyapp.com") {
 		getBodyMeasurement: (date) => wrapApi(getV1BodyMeasurementsDate)(date, headers, { client }),
 		createBodyMeasurement: (data) => wrapApi(postV1BodyMeasurements)(data, headers, { client }),
 		updateBodyMeasurement: (date, data) => wrapApi(putV1BodyMeasurementsDate)(date, data, headers, { client }),
+		getUserInfo: () => wrapApi(getV1UserInfo)(headers, { client }),
 		getWebhookSubscription: async () => {
 			throw new Error("Webhook subscription API not available. Please regenerate the client from the updated OpenAPI spec.");
 		},
@@ -1726,7 +1817,7 @@ function createClient(apiKey, baseUrl) {
 //#endregion
 //#region src/index.ts
 const name = "hevy-mcp";
-const version = "1.23.22";
+const version = "1.23.24";
 const sentryConfig = {
 	dsn: "https://ce696d8333b507acbf5203eb877bce0f@o4508975499575296.ingest.de.sentry.io/4509049671647312",
 	release: process.env.SENTRY_RELEASE ?? `${name}@${version}`,
@@ -1735,9 +1826,14 @@ const sentryConfig = {
 };
 Sentry.init(sentryConfig);
 const HEVY_API_BASEURL = "https://api.hevyapp.com";
+const SENTRY_USER_ID_CONTEXT = "hevy-mcp:sentry-user-id:v1";
+function fingerprintApiKey(apiKey) {
+	return createHmac("sha256", apiKey).update(SENTRY_USER_ID_CONTEXT).digest("hex");
+}
 const serverConfigSchema = z.object({ apiKey: z.string().min(1, "Hevy API key is required").describe("Your Hevy API key (available in the Hevy app settings).") });
 const configSchema = serverConfigSchema;
 function buildServer(apiKey) {
+	Sentry.setUser({ id: fingerprintApiKey(apiKey) });
 	const baseServer = new McpServer({
 		name,
 		version
@@ -1750,6 +1846,7 @@ function buildServer(apiKey) {
 	registerTemplateTools(server, hevyClient);
 	registerFolderTools(server, hevyClient);
 	registerBodyMeasurementTools(server, hevyClient);
+	registerUserTools(server, hevyClient);
 	registerWebhookTools(server, hevyClient);
 	return server;
 }
@@ -1768,4 +1865,4 @@ async function runServer() {
 //#endregion
 export { createServer as n, runServer as r, configSchema as t };
 
-//# sourceMappingURL=src-Cag-RZcj.mjs.map
+//# sourceMappingURL=src-BVYF4gvN.mjs.map