@dizzlkheinz/ynab-mcpb 0.17.1 → 0.18.1

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

@@ -11,9 +11,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 24
           cache: npm
       - name: Install dependencies
         run: npm ci
@@ -31,9 +31,9 @@ jobs:
       YNAB_ACCESS_TOKEN: ${{ secrets.YNAB_ACCESS_TOKEN }}
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 24
           cache: npm
       - name: Install dependencies
         run: npm ci

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

@@ -12,9 +12,9 @@ jobs:
       YNAB_ACCESS_TOKEN: ${{ secrets.YNAB_ACCESS_TOKEN }}
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 24
           cache: npm
       - name: Install dependencies
         run: npm ci

package/.github/workflows/publish.yml

@@ -24,7 +24,7 @@ jobs:
         with:
           ref: ${{ inputs.tag || github.ref }}
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: 24
           registry-url: https://registry.npmjs.org

package/.github/workflows/release.yml

@@ -42,9 +42,9 @@ jobs:
           ref: ${{ inputs.ref }}
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 18
+          node-version: 24
           cache: npm
 
       - name: Install dependencies (no scripts)

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.18.0] - 2025-12-21
+
+### Added
+
+- **MCP Completions** - Autocomplete support for budgets, accounts, categories, and payees
+  - Improves client-side UX for tools that accept IDs or names
+  - Uses cached data to keep suggestions responsive
+- **Progress Notifications** - Long-running operations can emit MCP progress updates
+  - Reconciliation workflows now report progress during bulk create/update/unclear steps
+  - Clients can surface progress bars when providing a progress token
+
 ## [0.16.0] - 2025-12-01
 
 ### Added
@@ -160,7 +171,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- **Structured Output Schemas** - Zod-based output validation for all 30 tools
+- **Structured Output Schemas** - Zod-based output validation for all tools
   - Output schemas in `src/tools/schemas/outputs/` with centralized exports
   - Automatic validation in ToolRegistry (toolRegistry.ts:401-483) using `z.safeParse()`
   - Type-safe responses with TypeScript inference

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.17.0
+**Current Version:** 0.18.1
 
 ## Essential Commands
 
@@ -172,11 +172,14 @@ return cacheManager.wrap('cache_key', {
 
 Cache TTL constants are defined in `cacheManager.ts`:
 
-- `CACHE_TTLS.BUDGETS` - 1 hour (rarely changes)
-- `CACHE_TTLS.ACCOUNTS` - 30 minutes
-- `CACHE_TTLS.CATEGORIES` - 30 minutes
-- `CACHE_TTLS.SHORT` - 5 minutes (transactions)
-- `CACHE_TTLS.LONG` - 1 hour
+- `CACHE_TTLS.BUDGETS` - 10 minutes (rarely changes)
+- `CACHE_TTLS.ACCOUNTS` - 5 minutes
+- `CACHE_TTLS.CATEGORIES` - 5 minutes
+- `CACHE_TTLS.PAYEES` - 10 minutes
+- `CACHE_TTLS.TRANSACTIONS` - 2 minutes
+- `CACHE_TTLS.SCHEDULED_TRANSACTIONS` - 5 minutes
+- `CACHE_TTLS.USER_INFO` - 30 minutes
+- `CACHE_TTLS.MONTHS` - 5 minutes
 
 ### Delta Caching Pattern
 
@@ -387,7 +390,7 @@ Required:
 Optional (Caching):
 
 - `YNAB_MCP_CACHE_MAX_ENTRIES` (default: 1000)
-- `YNAB_MCP_CACHE_DEFAULT_TTL_MS` (default: 1800000 / 30 min)
+- `YNAB_MCP_CACHE_DEFAULT_TTL_MS` (default: 300000 / 5 min)
 - `YNAB_MCP_CACHE_STALE_MS` (default: 120000 / 2 min)
 
 Optional (Output):

package/README.md

@@ -162,7 +162,7 @@ For advanced configuration options (caching, output formatting), see the `.env.e
 
 ## What's Available
 
-The server gives Claude access to 30 tools organized by function. You don't need to know the tool names - just ask Claude in natural language and it will use the right tools.
+The server gives Claude access to 29 tools organized by function. You don't need to know the tool names - just ask Claude in natural language and it will use the right tools.
 
 **Budget & Account Info**
 
@@ -190,6 +190,11 @@ The server gives Claude access to 30 tools organized by function. You don't need
 
 For the complete list with technical details, see the [API Reference](docs/reference/API.md).
 
+## MCP Client Features
+
+- **Autocomplete (Completions)**: Clients that support MCP completions can suggest budgets, accounts, categories, and payees while filling tool arguments.
+- **Progress Notifications**: Long-running operations (notably reconciliation) emit progress updates when the client provides a progress token.
+
 ## Need Help?
 
 - **[API Reference](docs/reference/API.md)** - Complete tool documentation