@dizzlkheinz/ynab-mcpb 0.16.1 → 0.17.0

package/src/tools/monthTools.ts

@@ -8,6 +8,9 @@ import { cacheManager, CACHE_TTLS, CacheManager } from '../server/cacheManager.j
 import type { DeltaFetcher } from './deltaFetcher.js';
 import { CacheKeys } from '../server/cacheKeys.js';
 import { resolveDeltaFetcherArgs } from './deltaSupport.js';
+import type { ToolFactory } from '../types/toolRegistration.js';
+import { createAdapters, createBudgetResolver } from './adapters.js';
+import { ToolAnnotationPresets } from './toolCategories.js';
 
 /**
  * Schema for ynab:get_month tool parameters
@@ -168,3 +171,39 @@ export async function handleListMonths(
     'listing months',
   );
 }
+
+/**
+ * Registers all month-related tools with the registry.
+ */
+export const registerMonthTools: ToolFactory = (registry, context) => {
+  const { adapt, adaptWithDelta } = createAdapters(context);
+  const budgetResolver = createBudgetResolver(context);
+
+  registry.register({
+    name: 'get_month',
+    description: 'Get budget data for a specific month',
+    inputSchema: GetMonthSchema,
+    handler: adapt(handleGetMonth),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof GetMonthSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: Get Month Details',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'list_months',
+    description: 'List all months summary data for a budget',
+    inputSchema: ListMonthsSchema,
+    handler: adaptWithDelta(handleListMonths),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof ListMonthsSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: List Months',
+      },
+    },
+  });
+};

package/src/tools/payeeTools.ts

@@ -7,6 +7,9 @@ import { cacheManager, CACHE_TTLS, CacheManager } from '../server/cacheManager.j
 import type { DeltaFetcher } from './deltaFetcher.js';
 import { CacheKeys } from '../server/cacheKeys.js';
 import { resolveDeltaFetcherArgs } from './deltaSupport.js';
+import type { ToolFactory } from '../types/toolRegistration.js';
+import { createAdapters, createBudgetResolver } from './adapters.js';
+import { ToolAnnotationPresets } from './toolCategories.js';
 
 /**
  * Schema for ynab:list_payees tool parameters
@@ -144,3 +147,39 @@ export async function handleGetPayee(
     'getting payee details',
   );
 }
+
+/**
+ * Registers all payee-related tools with the registry.
+ */
+export const registerPayeeTools: ToolFactory = (registry, context) => {
+  const { adapt, adaptWithDelta } = createAdapters(context);
+  const budgetResolver = createBudgetResolver(context);
+
+  registry.register({
+    name: 'list_payees',
+    description: 'List all payees for a specific budget',
+    inputSchema: ListPayeesSchema,
+    handler: adaptWithDelta(handleListPayees),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof ListPayeesSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: List Payees',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'get_payee',
+    description: 'Get detailed information for a specific payee',
+    inputSchema: GetPayeeSchema,
+    handler: adapt(handleGetPayee),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof GetPayeeSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: Get Payee Details',
+      },
+    },
+  });
+};

package/src/tools/reconciliation/index.ts

@@ -8,6 +8,13 @@ import { z } from 'zod/v4';
 import type * as ynab from 'ynab';
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { withToolErrorHandling } from '../../types/index.js';
+import type { ToolFactory } from '../../types/toolRegistration.js';
+import { createAdapters, createBudgetResolver } from '../adapters.js';
+import { ToolAnnotationPresets } from '../toolCategories.js';
+import {
+  CompareTransactionsSchema,
+  handleCompareTransactions,
+} from '../compareTransactions/index.js';
 import { analyzeReconciliation } from './analyzer.js';
 import type { MatchingConfig } from './matcher.js';
 import { buildReconciliationPayload } from '../reconcileAdapter.js';
@@ -457,6 +464,44 @@ export async function handleReconcileAccount(
   );
 }
 
+/**
+ * Registers reconciliation-domain tools (compare + reconcile) with the registry.
+ */
+export const registerReconciliationTools: ToolFactory = (registry, context) => {
+  const { adapt, adaptWithDelta } = createAdapters(context);
+  const budgetResolver = createBudgetResolver(context);
+
+  registry.register({
+    name: 'compare_transactions',
+    description:
+      'Compare bank transactions from CSV with YNAB transactions to find missing entries',
+    inputSchema: CompareTransactionsSchema,
+    handler: adapt(handleCompareTransactions),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof CompareTransactionsSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: Compare Transactions',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'reconcile_account',
+    description:
+      'Guided reconciliation workflow with human narrative, insight detection, and optional execution (create/update/unclear). Set include_structured_data=true to also get full JSON output (large).',
+    inputSchema: ReconcileAccountSchema,
+    handler: adaptWithDelta(handleReconcileAccount),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof ReconcileAccountSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.WRITE_EXTERNAL_UPDATE,
+        title: 'YNAB: Reconcile Account',
+      },
+    },
+  });
+};
+
 function mapCsvDateFormatToHint(
   format: string | undefined,
 ): ParseCSVOptions['dateFormat'] | undefined {

package/src/tools/schemas/common.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Shared Zod schemas used across multiple tool domains.
+ * @module tools/schemas/common
+ */
+
+import { z } from 'zod/v4';
+
+/**
+ * Strict empty object schema used for tools that do not accept input params.
+ * Examples: list_budgets, get_user, get_default_budget, clear_cache
+ */
+export const emptyObjectSchema = z.object({}).strict();
+
+/**
+ * Permissive object schema used when hosts require a top-level object but we
+ * intentionally allow passthrough properties (e.g., mutation tool outputs).
+ */
+export const looseObjectSchema = z.object({}).passthrough();

package/src/tools/transactionTools.ts

@@ -6,6 +6,9 @@ import type { SaveTransactionsResponseData } from 'ynab/dist/models/SaveTransact
 import { z } from 'zod/v4';
 import { createHash } from 'crypto';
 import { ValidationError, withToolErrorHandling } from '../types/index.js';
+import type { ToolFactory } from '../types/toolRegistration.js';
+import { createAdapters, createBudgetResolver } from './adapters.js';
+import { ToolAnnotationPresets } from './toolCategories.js';
 import { responseFormatter } from '../server/responseFormatter.js';
 import { amountToMilliunits, milliunitsToAmount } from '../utils/amountUtils.js';
 import { cacheManager, CACHE_TTLS, CacheManager } from '../server/cacheManager.js';
@@ -14,6 +17,7 @@ import type { DeltaFetcher } from './deltaFetcher.js';
 import type { DeltaCache } from '../server/deltaCache.js';
 import type { ServerKnowledgeStore } from '../server/serverKnowledgeStore.js';
 import { resolveDeltaFetcherArgs, resolveDeltaWriteArgs } from './deltaSupport.js';
+import { handleExportTransactions, ExportTransactionsSchema } from './exportTransactions.js';
 
 /**
  * Utility function to ensure transaction is not null/undefined
@@ -2506,3 +2510,139 @@ function handleTransactionError(error: unknown, defaultMessage: string): CallToo
     ],
   };
 }
+
+/**
+ * Registers transaction-domain tools with the provided registry.
+ */
+export const registerTransactionTools: ToolFactory = (registry, context) => {
+  const { adapt, adaptWithDelta, adaptWrite } = createAdapters(context);
+  const budgetResolver = createBudgetResolver(context);
+
+  registry.register({
+    name: 'list_transactions',
+    description: 'List transactions for a budget with optional filtering',
+    inputSchema: ListTransactionsSchema,
+    handler: adaptWithDelta(handleListTransactions),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof ListTransactionsSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: List Transactions',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'export_transactions',
+    description: 'Export all transactions to a JSON file with descriptive filename',
+    inputSchema: ExportTransactionsSchema,
+    handler: adapt(handleExportTransactions),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof ExportTransactionsSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: Export Transactions',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'get_transaction',
+    description: 'Get detailed information for a specific transaction',
+    inputSchema: GetTransactionSchema,
+    handler: adapt(handleGetTransaction),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof GetTransactionSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: Get Transaction Details',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'create_transaction',
+    description: 'Create a new transaction in the specified budget and account',
+    inputSchema: CreateTransactionSchema,
+    handler: adaptWrite(handleCreateTransaction),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof CreateTransactionSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.WRITE_EXTERNAL_CREATE,
+        title: 'YNAB: Create Transaction',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'create_transactions',
+    description:
+      'Create multiple transactions in a single batch (1-100 items) with duplicate detection, dry-run validation, and automatic response size management with correlation metadata.',
+    inputSchema: CreateTransactionsSchema,
+    handler: adaptWrite(handleCreateTransactions),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof CreateTransactionsSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.WRITE_EXTERNAL_CREATE,
+        title: 'YNAB: Create Multiple Transactions',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'create_receipt_split_transaction',
+    description: 'Create a split transaction from receipt items with proportional tax allocation',
+    inputSchema: CreateReceiptSplitTransactionSchema,
+    handler: adaptWrite(handleCreateReceiptSplitTransaction),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof CreateReceiptSplitTransactionSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.WRITE_EXTERNAL_CREATE,
+        title: 'YNAB: Create Split Transaction from Receipt',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'update_transaction',
+    description: 'Update an existing transaction',
+    inputSchema: UpdateTransactionSchema,
+    handler: adaptWrite(handleUpdateTransaction),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof UpdateTransactionSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.WRITE_EXTERNAL_UPDATE,
+        title: 'YNAB: Update Transaction',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'update_transactions',
+    description:
+      'Update multiple transactions in a single batch (1-100 items) with dry-run validation, automatic cache invalidation, and response size management. Supports optional original_account_id and original_date metadata for efficient cache invalidation.',
+    inputSchema: UpdateTransactionsSchema,
+    handler: adaptWrite(handleUpdateTransactions),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof UpdateTransactionsSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.WRITE_EXTERNAL_UPDATE,
+        title: 'YNAB: Update Multiple Transactions',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'delete_transaction',
+    description: 'Delete a transaction from the specified budget',
+    inputSchema: DeleteTransactionSchema,
+    handler: adaptWrite(handleDeleteTransaction),
+    defaultArgumentResolver: budgetResolver<z.infer<typeof DeleteTransactionSchema>>(),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.WRITE_EXTERNAL_DELETE,
+        title: 'YNAB: Delete Transaction',
+      },
+    },
+  });
+};

package/src/tools/utilityTools.ts

@@ -1,8 +1,12 @@
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import * as ynab from 'ynab';
 import { z } from 'zod/v4';
-import { withToolErrorHandling } from '../types/index.js';
 import { responseFormatter } from '../server/responseFormatter.js';
+import { withToolErrorHandling } from '../types/index.js';
+import { createAdapters } from './adapters.js';
+import { emptyObjectSchema } from './schemas/common.js';
+import { ToolAnnotationPresets } from './toolCategories.js';
+import type { ToolFactory } from '../types/toolRegistration.js';
 
 /**
  * Schema for ynab:convert_amount tool parameters
@@ -48,7 +52,10 @@ export async function handleGetUser(ynabAPI: ynab.API): Promise<CallToolResult>
  * Handles the ynab:convert_amount tool call
  * Converts between dollars and milliunits with integer arithmetic for precision
  */
-export async function handleConvertAmount(params: ConvertAmountParams): Promise<CallToolResult> {
+export async function handleConvertAmount(
+  _ynabAPI: ynab.API,
+  params: ConvertAmountParams,
+): Promise<CallToolResult> {
   return await withToolErrorHandling(
     async () => {
       const { amount, to_milliunits } = params;
@@ -88,3 +95,36 @@ export async function handleConvertAmount(params: ConvertAmountParams): Promise<
     'converting amount',
   );
 }
+
+/**
+ * Registers utility tools (get_user, convert_amount) using the shared factory pattern.
+ */
+export const registerUtilityTools: ToolFactory = (registry, context) => {
+  const { adapt, adaptNoInput } = createAdapters(context);
+
+  registry.register({
+    name: 'get_user',
+    description: 'Get information about the authenticated user',
+    inputSchema: emptyObjectSchema,
+    handler: adaptNoInput(handleGetUser),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.READ_ONLY_EXTERNAL,
+        title: 'YNAB: Get User Information',
+      },
+    },
+  });
+
+  registry.register({
+    name: 'convert_amount',
+    description: 'Convert between dollars and milliunits with integer arithmetic for precision',
+    inputSchema: ConvertAmountSchema,
+    handler: adapt(handleConvertAmount),
+    metadata: {
+      annotations: {
+        ...ToolAnnotationPresets.UTILITY_LOCAL,
+        title: 'YNAB: Convert Amount',
+      },
+    },
+  });
+};

package/src/types/index.ts

@@ -65,3 +65,6 @@ export type { MCPToolAnnotations } from './toolAnnotations.js';
 
 // Re-export tool registry types for convenience
 export type { ToolDefinition } from '../server/toolRegistry.js';
+
+// Re-export tool registration factory types
+export type { ToolContext, ToolFactory, BudgetIdResolverFactory } from './toolRegistration.js';

package/src/types/toolRegistration.ts

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Type definitions for the tool factory registration pattern.
+ * Provides ToolContext for dependency injection and typed handler signatures
+ * used by domain-specific tool factory functions.
+ * @module types/toolRegistration
+ */
+
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import * as ynab from 'ynab';
+import type {
+  ToolRegistry,
+  ToolExecutionPayload,
+  DefaultArgumentResolver,
+} from '../server/toolRegistry.js';
+import type { DeltaFetcher } from '../tools/deltaFetcher.js';
+import type { DeltaCache } from '../server/deltaCache.js';
+import type { ServerKnowledgeStore } from '../server/serverKnowledgeStore.js';
+import type { DiagnosticManager } from '../server/diagnostics.js';
+import type { CacheManager } from '../server/cacheManager.js';
+
+/**
+ * Context object passed to tool factory functions. Contains the dependencies
+ * required by tool adapters and handlers.
+ *
+ * @stable This interface is part of the public tool registration contract.
+ * Changes to this interface may affect all domain tool factories.
+ */
+export interface ToolContext {
+  ynabAPI: ynab.API;
+  deltaFetcher: DeltaFetcher;
+  deltaCache: DeltaCache;
+  serverKnowledgeStore: ServerKnowledgeStore;
+  getDefaultBudgetId: () => string | undefined;
+  setDefaultBudget: (budgetId: string) => void;
+  cacheManager: CacheManager;
+  diagnosticManager?: DiagnosticManager;
+}
+
+/**
+ * Factory function signature for registering a domain's tools.
+ */
+export type ToolFactory = (registry: ToolRegistry, context: ToolContext) => void;
+
+/**
+ * Common adapter signature used within tool factories.
+ */
+export type Adapter<TInput extends Record<string, unknown>> = (
+  payload: ToolExecutionPayload<TInput>,
+) => Promise<CallToolResult>;
+
+/**
+ * Generic handler signature used by adapter helpers.
+ */
+export type Handler<TInput extends Record<string, unknown>> = (
+  api: ynab.API,
+  params: TInput,
+) => Promise<CallToolResult>;
+
+/**
+ * Handler signature for operations that require delta fetching.
+ */
+export type DeltaHandler<TInput extends Record<string, unknown>> = (
+  api: ynab.API,
+  deltaFetcher: DeltaFetcher,
+  params: TInput,
+) => Promise<CallToolResult>;
+
+/**
+ * Handler signature for write operations that update caches and knowledge stores.
+ */
+export type WriteHandler<TInput extends Record<string, unknown>> = (
+  api: ynab.API,
+  deltaCache: DeltaCache,
+  serverKnowledgeStore: ServerKnowledgeStore,
+  params: TInput,
+) => Promise<CallToolResult>;
+
+/**
+ * Handler signature for tools that do not accept input parameters.
+ */
+export type NoInputHandler = (api: ynab.API) => Promise<CallToolResult>;
+
+/**
+ * Helper type for default argument resolver factories.
+ */
+export type BudgetIdResolverFactory = <
+  TInput extends { budget_id?: string | undefined },
+>() => DefaultArgumentResolver<TInput>;

package/.github/workflows/pr-description-check.yml

@@ -1,88 +0,0 @@
-name: PR Description Check
-
-on:
-  pull_request:
-    types: [opened, edited, synchronize]
-
-permissions:
-  contents: read
-  issues: write
-  pull-requests: read
-
-jobs:
-  check-description:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check PR Description Format
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
-        with:
-          script: |
-            const body = context.payload.pull_request.body || '';
-
-            // Required sections from template
-            const requiredSections = [
-              'Type of change',
-              'Public API surface checklist',
-              'Versioning and release'
-            ];
-
-            const missingSections = requiredSections.filter(section =>
-              !body.includes(section)
-            );
-
-            if (missingSections.length > 0) {
-              // Build comment as array to avoid YAML indentation issues
-              const commentLines = [
-                '⚠️ **PR Description Check Failed**',
-                '',
-                'The PR description is missing required sections from the template:',
-                ...missingSections.map(s => `- ${s}`),
-                '',
-                'Please update the description to include these sections. You can view the template at:',
-                `https://github.com/${context.repo.owner}/${context.repo.repo}/blob/master/.github/pull_request_template.md`,
-                '',
-                'Or run this command to update it:',
-                '```bash',
-                `gh pr edit ${context.payload.pull_request.number} --body-file .github/pull_request_template.md`,
-                '```'
-              ];
-              const comment = commentLines.join('\n');
-
-              // Upsert comment: update existing bot comment or create new one
-              const botCommentPrefix = '⚠️ **PR Description Check Failed**';
-              // Paginate through all comments to handle PRs with >30 comments
-              const comments = await github.paginate(
-                github.rest.issues.listComments,
-                {
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: context.payload.pull_request.number,
-                  per_page: 100
-                }
-              );
-
-              const existingComment = comments.find(
-                c => c.user.type === 'Bot' && c.body.startsWith(botCommentPrefix)
-              );
-
-              if (existingComment) {
-                await github.rest.issues.updateComment({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  comment_id: existingComment.id,
-                  body: comment
-                });
-              } else {
-                await github.rest.issues.createComment({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: context.payload.pull_request.number,
-                  body: comment
-                });
-              }
-
-              // Fail the check
-              core.setFailed(`Missing required sections: ${missingSections.join(', ')}`);
-            } else {
-              console.log('✅ All required sections present in PR description');
-            }

package/docs/README.md

@@ -1,72 +0,0 @@
-# YNAB MCP Server Documentation
-
-Complete documentation for the YNAB Model Context Protocol Server.
-
-## 📚 Documentation Overview
-
-### Getting Started
-New to the YNAB MCP Server? Start here:
-
-- **[Quick Start](getting-started/QUICKSTART.md)** - Fast path to testing with Claude Desktop
-- **[Installation](getting-started/INSTALLATION.md)** - Detailed installation instructions
-- **[Configuration](getting-started/CONFIGURATION.md)** - Environment variables and settings
-
-### Guides
-Learn how to develop with and extend the server:
-
-- **[Architecture](guides/ARCHITECTURE.md)** - Server architecture and core components
-- **[Testing](guides/TESTING.md)** - Automated and manual testing strategies
-- **[Deployment](guides/DEPLOYMENT.md)** - Production deployment instructions
-
-### Reference
-Complete API and technical reference:
-
-- **[API Reference](reference/API.md)** - Complete tool documentation with examples
-- **[Tools Quick Reference](reference/TOOLS.md)** - Quick tool catalog and parameter guide
-- **[Examples](reference/EXAMPLES.md)** - Practical usage examples and workflows
-- **[Troubleshooting](reference/TROUBLESHOOTING.md)** - Common issues, solutions, and debugging
-
-## 🎯 Quick Navigation by Task
-
-### I want to...
-
-**Get Started**
-- Install and configure → [Installation](getting-started/INSTALLATION.md)
-- Test quickly → [Quick Start](getting-started/QUICKSTART.md)
-- Understand the architecture → [Architecture](guides/ARCHITECTURE.md)
-
-**Develop**
-- Create a new tool → [Architecture Guide](guides/ARCHITECTURE.md#developing-tools-with-v08x)
-- Understand the architecture → [Architecture](guides/ARCHITECTURE.md)
-
-**Troubleshoot**
-- Common issues → [Troubleshooting](reference/TROUBLESHOOTING.md)
-
-**Test**
-- Run automated tests → [Testing Guide](guides/TESTING.md)
-
-**Deploy**
-- Deploy to production → [Deployment Guide](guides/DEPLOYMENT.md)
-- Configure for Claude Desktop → [Quick Start](getting-started/QUICKSTART.md#claude-desktop-integration)
-
-## 🔗 External Resources
-
-- **[YNAB API Documentation](https://api.youneedabudget.com/)** - Official YNAB API docs
-- **[Model Context Protocol](https://modelcontextprotocol.io/)** - MCP specification
-- **[Project Repository](https://github.com/dizzlkheinz/mcp-for-ynab)** - GitHub repository
-- **[Release Notes](https://github.com/dizzlkheinz/mcp-for-ynab/releases)** - Version history and changelog
-
-## 💡 Need Help?
-
-- **Documentation Issue?** Check the [Troubleshooting Guide](reference/TROUBLESHOOTING.md)
-- **Bug Report?** [Open an issue](https://github.com/dizzlkheinz/mcp-for-ynab/issues/new?template=bug_report.md)
-- **Feature Request?** [Request a feature](https://github.com/dizzlkheinz/mcp-for-ynab/issues/new?template=feature_request.md)
-- **Question?** Check existing [GitHub Discussions](https://github.com/dizzlkheinz/mcp-for-ynab/discussions)
-
-## 📄 License
-
-This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the [LICENSE](../LICENSE) file for details.
-
----
-
-**Quick Links**: [Main README](../README.md) | [API Reference](reference/API.md) | [Quick Start](getting-started/QUICKSTART.md) | [Architecture](guides/ARCHITECTURE.md)