@dizzlkheinz/ynab-mcpb 0.24.0 → 0.24.2

package/.github/workflows/ci-tests.yml

@@ -6,6 +6,9 @@ on:
       - master
   pull_request:
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   unit-tests:
     runs-on: ubuntu-latest

package/.github/workflows/claude-code-review.yml

@@ -10,6 +10,9 @@ on:
     #   - "src/**/*.js"
     #   - "src/**/*.jsx"
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   claude-review:
     # Optional: Filter by PR author

package/.github/workflows/claude.yml

@@ -10,6 +10,9 @@ on:
   pull_request_review:
     types: [submitted]
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   claude:
     if: |

package/.github/workflows/full-integration.yml

@@ -5,6 +5,9 @@ on:
     - cron: '0 2 * * *'
   workflow_dispatch:
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   run-full-suite:
     runs-on: ubuntu-latest

package/.github/workflows/publish.yml

@@ -9,6 +9,9 @@ on:
   release:
     types: [published]
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   publish:
     # Required to satisfy npm Trusted Publisher matching (environment name left blank in npm)

package/.github/workflows/release.yml

@@ -16,6 +16,9 @@ on:
         required: false
         default: 'master'
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 permissions:
   contents: write
 

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.24.2] - 2026-03-29
+
+### Changed
+
+- **Dependencies** - Updated `@modelcontextprotocol/sdk` to 1.28.0; updated dev dependencies (Biome 2.4.9, Vitest 4.1.2, csv-parse 6.2.1, esbuild 0.27.4, @types/node 25.5.0)
+
+## [0.24.1] - 2026-03-29
+
+### Fixed
+
+- **Reconciliation Bulk Creates** - Correlation now succeeds when YNAB populates `payee_id` on returned transactions; previously every bulk-created transaction landed in the `correlation_failed` bucket, reporting 0 transactions created
+- **MCP SDK 1.27+ Compatibility** - All 28 tool handlers now return `structuredContent` alongside text content, resolving the `RuntimeError: Tool has an output schema but did not return structured content` thrown by SDK clients
+- **Output Schema Stripping** - Zod schema stripping is now applied to handler-supplied `structuredContent`; previously the raw handler object was returned, leaking fields not declared in the output schema (e.g. `security` in diagnostic info)
+- **Content Validation Ordering** - Content array validation now runs unconditionally before the `structuredContent` fast-path, so malformed content is caught centrally even when `structuredContent` is present
+
+### Changed
+
+- **CI** - GitHub Actions runners now opt into Node.js 24 via `FORCE_JAVASCRIPT_ACTIONS_TO_NODE24=true`, ahead of the June 2026 forced migration
+
 ## [0.24.0] - 2026-02-22
 
 ### Changed

package/CLAUDE.md

@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 This is a Model Context Protocol (MCP) server for YNAB (You Need A Budget) integration, enabling AI assistants to interact with YNAB budgets, accounts, transactions, and categories. The codebase uses TypeScript with a modular, service-oriented architecture.
 
-**Current Version:** 0.24.0
+**Current Version:** 0.24.2
 
 ## Essential Commands
 
@@ -85,7 +85,8 @@ The architecture is modular and service-oriented:
 - **prompts.ts** - MCP prompt definitions and handlers
 - **diagnostics.ts** - System diagnostics and health monitoring
 - **securityMiddleware.ts** - Security validation and wrapper functions
-- **responseFormatter.ts** - JSON response formatting (minification/pretty-print)
+- **responseFormatter.ts** - JSON response formatting (pretty-print)
+- **markdownFormatter.ts** - Human-readable markdown output for all read tools (tables, detail views, pagination footers)
 - **rateLimiter.ts** - Rate limiting for YNAB API compliance
 - **requestLogger.ts** - Request/response logging middleware
 - **cacheKeys.ts** - Centralized cache key generation utilities
@@ -176,6 +177,27 @@ registry.register({
 });
 ```
 
+### Response Format (Markdown / JSON)
+
+All read-only tools accept a `response_format` parameter (`"markdown"` | `"json"`, default: `"markdown"`):
+
+- **`"markdown"`** — Human-readable tables and detail views via `markdownFormatter.ts`. Includes pagination footers and cache info.
+- **`"json"`** — Structured JSON (pretty-printed). Also returned as `structuredContent` for clients that support output schemas.
+
+**Supported tools**: `ynab_list_budgets`, `ynab_get_budget`, `ynab_list_accounts`, `ynab_get_account`, `ynab_list_transactions`, `ynab_get_transaction`, `ynab_list_categories`, `ynab_get_category`, `ynab_list_payees`, `ynab_get_payee`, `ynab_get_month`, `ynab_list_months`, `ynab_get_user`
+
+```typescript
+// In tool handler
+const fmt = params.response_format ?? "markdown";
+return {
+  content: [{
+    type: "text",
+    text: fmt === "json" ? JSON.stringify(data, null, 2) : formatBudgetsList(data),
+  }],
+  structuredContent: data,
+};
+```
+
 ### Enhanced Caching with Delta Support
 
 Use `cacheManager.wrap()` for automatic caching with observability:

package/README.md

@@ -56,6 +56,7 @@ graph LR
 - **Bank reconciliation (beta)** — Import a bank CSV, fuzzy-match against YNAB, detect missing or mismatched transactions, and apply bulk fixes.
 - **28 YNAB tools** — Full coverage of budgets, accounts, transactions, categories, payees, months, and utilities.
 - **Delta sync** — Fetches only changed data since the last request, keeping things fast.
+- **Markdown or JSON** — All read tools support `response_format`: human-readable markdown tables (default) or structured JSON.
 - **MCP-native** — Structured outputs, annotations, completions API, and resource templates.
 
 ---
@@ -199,6 +200,8 @@ Create a transaction: $42.18 at Trader Joe's yesterday.
 | Reconciliation | `reconcile_account` |
 | Utilities | `get_user` `diagnostic_info` `clear_cache` |
 
+All read tools accept `response_format` (`"markdown"` or `"json"`, default: `"markdown"`).
+
 Full reference: [docs/reference/API.md](docs/reference/API.md)
 
 </details>