hevy-mcp 1.26.6 → 1.28.1-beta.1

package/README.md

@@ -21,6 +21,7 @@ A Model Context Protocol (MCP) server implementation that interfaces with the [H
 - [Why hevy-mcp?](#why-hevy-mcp)
 - [Configuration](#configuration)
 - [Available MCP Tools](#available-mcp-tools)
+- [Available MCP Resources](#available-mcp-resources)
 - [Development & Contributing](#development--contributing)
 
 ---
@@ -40,14 +41,14 @@ Pick the workflow that fits your setup:
 
 | Scenario              | Command                                                                                     | Requirements               |
 | :-------------------- | :------------------------------------------------------------------------------------------ | :------------------------- |
-| **One-off stdio run** | `HEVY_API_KEY=sk_live... npx -y hevy-mcp` or `HEVY_API_KEY=sk_live... bunx hevy-mcp@latest` | Node.js ≥ 24, Hevy API key |
+| **One-off stdio run** | `HEVY_API_KEY=sk_live... npx -y hevy-mcp` or `HEVY_API_KEY=sk_live... bunx hevy-mcp@latest` | Node.js ≥ 20, Hevy API key |
 | **Local development** | `npm install && npm run build && npm start`                                                 | `.env` with `HEVY_API_KEY` |
 
 ---
 
 ## 🛠️ Prerequisites
 
-- **Node.js**: v24 or higher (strongly recommended to use the exact version pinned in `.nvmrc`).
+- **Node.js**: v20 or higher (strongly recommended to use the exact version pinned in `.nvmrc`).
 - **npm**: v10 or higher.
 - **Bun** (optional): If you want to launch with `bunx`.
 - **Hevy API key**: Required for all operations (available with Hevy PRO).
@@ -69,6 +70,25 @@ HEVY_API_KEY=your_hevy_api_key_here npx -y hevy-mcp
 HEVY_API_KEY=your_hevy_api_key_here bunx hevy-mcp@latest
 ```
 
+### Prerelease channel
+
+Install `hevy-mcp@beta` to opt into changes merged to `main` that have not yet
+reached a stable release:
+
+```bash
+npm install hevy-mcp@beta
+
+# npx launcher
+npx -y hevy-mcp@beta
+
+# bun launcher
+bunx hevy-mcp@beta
+```
+
+Beta builds may be less stable and can change before their stable release.
+`npm install hevy-mcp@latest` remains the stable channel. To switch back from
+beta, install `hevy-mcp@latest` again.
+
 ### Manual Installation
 
 ```bash
@@ -178,17 +198,24 @@ Supply your Hevy API key via the `HEVY_API_KEY` environment variable (in
 Set `HEVY_MCP_API_TIMEOUT` to override the default 30-second Hevy API request
 timeout. Its value is in milliseconds.
 
+Set `HEVY_MCP_DEBUG=1` to emit verbose, privacy-bounded diagnostics to stderr.
+Debug records include tool invocations and sanitized Hevy API response timing
+and status details. Other values leave diagnostics disabled, and stdout remains
+reserved for the MCP JSON-RPC stream.
+
 ```env
 # Example .env
 HEVY_API_KEY=your_hevy_api_key_here
 # Optional: customize Hevy API request timeout (milliseconds)
 HEVY_MCP_API_TIMEOUT=30000
+# Optional: enable verbose stderr diagnostics (only the value 1 enables it)
+HEVY_MCP_DEBUG=1
 ```
 
 ### 🧠 Exercise Template Cache Behavior
 
-`search-exercise-templates` now uses a shared in-memory async cache for the
-full exercise template catalog:
+`search-exercise-templates` and the `hevy://exercise-templates` resource use a
+shared in-memory async cache for the full exercise template catalog:
 
 - **TTL**: 5 minutes per cached catalog entry.
 - **Memory bound**: max 1 catalog entry (LRU bounded cache).
@@ -197,9 +224,8 @@ full exercise template catalog:
 - **Manual refresh**: set `refresh: true` in the tool input to invalidate the
   cached catalog and force a re-fetch from the Hevy API.
 
-This cache currently applies to `search-exercise-templates` only. Paginated
-`get-exercise-templates` requests still call the API directly to keep paging
-behavior explicit and avoid cross-page invalidation complexity.
+Paginated `get-exercise-templates` requests still call the API directly to keep
+paging behavior explicit and avoid cross-page invalidation complexity.
 
 ### 📡 Sentry Monitoring
 
@@ -240,6 +266,28 @@ The supported path is stdio via `npx hevy-mcp`.
 > folders, exercise templates, or body measurements, so `hevy-mcp` does not
 > provide delete tools for these resources.
 
+## 💬 Available MCP Prompts
+
+| Prompt                        | Arguments                                                                              | Guided workflow                                       |
+| :---------------------------- | :------------------------------------------------------------------------------------- | :---------------------------------------------------- |
+| `analyze-workout-progress`    | Optional `weeks` (1-12; defaults to `4` when omitted from a supplied arguments object) | Analyze recent workout and body-measurement trends.   |
+| `create-workout-from-routine` | `routineId`, `startTime` (UTC ISO seconds)                                             | Record a completed workout using a routine as a plan. |
+
+Compatibility note: with MCP SDK v1.29.0, clients using the default must send
+`arguments: {}` because the SDK rejects requests that omit the entire
+`arguments` object before prompt field defaults are evaluated.
+
+---
+
+## 📚 Available MCP Resources
+
+| Name                 | URI                         |
+| :------------------- | :-------------------------- |
+| `user-profile`       | `hevy://user`               |
+| `workout-count`      | `hevy://workout-count`      |
+| `exercise-templates` | `hevy://exercise-templates` |
+| `routine-folders`    | `hevy://routine-folders`    |
+
 ---
 
 ## 👨‍💻 Development & Contributing
@@ -249,7 +297,7 @@ The supported path is stdio via `npx hevy-mcp`.
 - **Build**: `npm run build`
 - **Lint/Format**: `npm run check` (uses oxlint/oxfmt)
 - **Type Check**: `npm run check:types`
-- **Unit Tests**: `npx vitest run --exclude tests/integration/**`
+- **Unit Tests**: `npx vitest run --exclude 'tests/integration/**'`
 - **Full Test Suite**: `npm test` (requires `HEVY_API_KEY`)
 - **Changeset Check**: `npm run check:changeset`
 

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: "hevy-mcp@1.26.6" };
+		e.SENTRY_RELEASE = { id: "hevy-mcp@1.28.1-beta.1" };
 		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-B9KZiN70.mjs";
+import { r as runServer } from "./src-CHT_Meh8.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: "hevy-mcp@1.26.6" };
+		e.SENTRY_RELEASE = { id: "hevy-mcp@1.28.1-beta.1" };
 		var n = new e.Error().stack;
 		n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "5b077b94-9ef8-4f24-a0b0-8dcfbf491be1", e._sentryDebugIdIdentifier = "sentry-dbid-5b077b94-9ef8-4f24-a0b0-8dcfbf491be1");
 	} catch (e) {}
 })();
-import { n as createServer, r as runServer, t as configSchema } from "./src-B9KZiN70.mjs";
+import { n as createServer, r as runServer, t as configSchema } from "./src-CHT_Meh8.mjs";
 export { configSchema, createServer, createServer as default, runServer };