@aashari/boilerplate-mcp-server 1.14.0 → 1.15.0

package/.trigger-ci

@@ -0,0 +1 @@
+# CI/CD trigger Thu Sep 18 00:40:39 WIB 2025

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [1.15.0](https://github.com/aashari/boilerplate-mcp-server/compare/v1.14.0...v1.15.0) (2025-12-01)
+
+
+### Bug Fixes
+
+* update tests for TOON output format ([6054be3](https://github.com/aashari/boilerplate-mcp-server/commit/6054be313fd54c6678b39da214c13e17b04ec4a6))
+
+
+### Features
+
+* add TOON output format with JMESPath filtering support ([#126](https://github.com/aashari/boilerplate-mcp-server/issues/126)) ([2b3d8d8](https://github.com/aashari/boilerplate-mcp-server/commit/2b3d8d8a6811a1296475b6971d840b9392ceff08))
+
 # [1.14.0](https://github.com/aashari/boilerplate-mcp-server/compare/v1.13.5...v1.14.0) (2025-09-09)
 
 

package/dist/cli/ipaddress.cli.js

@@ -21,6 +21,8 @@ function register(program) {
         .option('-e, --include-extended-data', 'Include extended data (ASN, host, org). Requires API token.')
         .option('--no-use-https', // commander creates a 'useHttps' boolean, defaulting to true
     'Use HTTP instead of HTTPS for the API call.')
+        .option('--jq <expression>', 'JMESPath expression to filter/transform the response.')
+        .option('-o, --output-format <format>', 'Output format: "toon" (default, token-efficient) or "json".', 'toon')
         .action(async (ipAddress, options) => {
         const actionLogger = logger.forMethod('action:get-ip-details');
         try {
@@ -33,6 +35,8 @@ function register(program) {
                 ipAddress,
                 includeExtendedData: options.includeExtendedData || false,
                 useHttps: options.useHttps, // commander handles the default via --no-use-https
+                jq: options.jq,
+                outputFormat: options.outputFormat,
             };
             const result = await ipaddress_controller_js_1.default.get(args);
             console.log(result.content);

package/dist/controllers/ipaddress.controller.d.ts

@@ -1,4 +1,13 @@
-import { ControllerResponse } from '../types/common.types.js';
+/**
+ * Output format type
+ */
+type OutputFormat = 'toon' | 'json';
+/**
+ * Controller response type
+ */
+interface ControllerResponse {
+    content: string;
+}
 /**
  * @namespace IpAddressController
  * @description Controller responsible for handling IP address lookup logic.
@@ -14,13 +23,17 @@ import { ControllerResponse } from '../types/common.types.js';
  * @param {string} [args.ipAddress] - Optional IP address to look up. If omitted, the service will fetch the current device's public IP.
  * @param {boolean} [args.includeExtendedData=false] - Whether to include extended data fields requiring an API token
  * @param {boolean} [args.useHttps=true] - Whether to use HTTPS for the API request
- * @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the formatted IP details in Markdown.
+ * @param {string} [args.jq] - JMESPath expression to filter the response
+ * @param {OutputFormat} [args.outputFormat] - Output format (toon or json)
+ * @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the formatted IP details.
  * @throws {McpError} Throws an McpError (handled by `handleControllerError`) if the service call fails or returns an error.
  */
 declare function get(args?: {
     ipAddress?: string;
     includeExtendedData?: boolean;
     useHttps?: boolean;
+    jq?: string;
+    outputFormat?: OutputFormat;
 }): Promise<ControllerResponse>;
 declare const _default: {
     get: typeof get;

package/dist/controllers/ipaddress.controller.js

@@ -5,11 +5,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const logger_util_js_1 = require("../utils/logger.util.js");
 const vendor_ip_api_com_service_js_1 = __importDefault(require("../services/vendor.ip-api.com.service.js"));
-const ipaddress_formatter_js_1 = require("./ipaddress.formatter.js");
 const error_handler_util_js_1 = require("../utils/error-handler.util.js");
 const config_util_js_1 = require("../utils/config.util.js");
 const error_util_js_1 = require("../utils/error.util.js");
 const error_handler_util_js_2 = require("../utils/error-handler.util.js");
+const jq_util_js_1 = require("../utils/jq.util.js");
 /**
  * @namespace IpAddressController
  * @description Controller responsible for handling IP address lookup logic.
@@ -25,7 +25,9 @@ const error_handler_util_js_2 = require("../utils/error-handler.util.js");
  * @param {string} [args.ipAddress] - Optional IP address to look up. If omitted, the service will fetch the current device's public IP.
  * @param {boolean} [args.includeExtendedData=false] - Whether to include extended data fields requiring an API token
  * @param {boolean} [args.useHttps=true] - Whether to use HTTPS for the API request
- * @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the formatted IP details in Markdown.
+ * @param {string} [args.jq] - JMESPath expression to filter the response
+ * @param {OutputFormat} [args.outputFormat] - Output format (toon or json)
+ * @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the formatted IP details.
  * @throws {McpError} Throws an McpError (handled by `handleControllerError`) if the service call fails or returns an error.
  */
 async function get(args = {}) {
@@ -71,12 +73,11 @@ async function get(args = {}) {
             serviceOptions,
             isTestEnvironment,
         });
+        let data;
         try {
             // Call the service with ipAddress and the mapped serviceOptions
-            const data = await vendor_ip_api_com_service_js_1.default.get(args.ipAddress, serviceOptions);
+            data = await vendor_ip_api_com_service_js_1.default.get(args.ipAddress, serviceOptions);
             methodLogger.debug(`Got the response from the service`, data);
-            const formattedContent = (0, ipaddress_formatter_js_1.formatIpDetails)(data);
-            return { content: formattedContent };
         }
         catch (error) {
             // If HTTPS fails with permission/SSL error and useHttps was true, try again with HTTP
@@ -87,17 +88,24 @@ async function get(args = {}) {
                     error.message.includes('Access denied'))) {
                 methodLogger.warn('HTTPS request failed, falling back to HTTP');
                 // Try again with HTTP
-                const httpData = await vendor_ip_api_com_service_js_1.default.get(args.ipAddress, {
+                data = await vendor_ip_api_com_service_js_1.default.get(args.ipAddress, {
                     ...serviceOptions,
                     useHttps: false,
                 });
-                methodLogger.debug(`Got the response from HTTP fallback`, httpData);
-                const formattedContent = (0, ipaddress_formatter_js_1.formatIpDetails)(httpData);
-                return { content: formattedContent };
+                methodLogger.debug(`Got the response from HTTP fallback`, data);
+            }
+            else {
+                // For other errors, rethrow
+                throw error;
             }
-            // For other errors, rethrow
-            throw error;
         }
+        // Apply JQ filter if provided
+        const filteredData = (0, jq_util_js_1.applyJqFilter)(data, args.jq);
+        // Determine output format (default to TOON)
+        const useToon = args.outputFormat !== 'json';
+        // Format the output
+        const content = await (0, jq_util_js_1.toOutputString)(filteredData, useToon);
+        return { content };
     }
     catch (error) {
         throw (0, error_handler_util_js_1.handleControllerError)(error, (0, error_handler_util_js_2.buildErrorContext)('IP Address', 'get', 'controllers/ipaddress.controller.ts@get', args.ipAddress || 'current device', { args }));

package/dist/tools/ipaddress.tool.js

@@ -63,7 +63,29 @@ async function handleGetIpDetails(args) {
 function registerTools(server) {
     const methodLogger = logger_util_js_1.Logger.forContext('tools/ipaddress.tool.ts', 'registerTools');
     methodLogger.debug(`Registering IP address tools...`);
-    server.tool('ip_get_details', `Retrieves detailed geolocation and network information for a public IP address (\`ipAddress\`). If no IP is provided, automatically uses the server's current public IP. Returns comprehensive location data including country, region, city, coordinates, timezone, and network details like ISP and organization. Use \`includeExtendedData\` to get additional information such as ASN, mobile/proxy detection (requires API token). **Note:** Cannot lookup private IPs (e.g., 192.168.x.x, 10.x.x.x). Powered by ip-api.com. Enable \`useHttps\` for secure connections (required for paid tier).`, GetIpDetailsToolSchema.shape, handleGetIpDetails);
+    server.tool('ip_get_details', `Retrieve geolocation and network information for a public IP address. Returns TOON format by default (30-60% fewer tokens than JSON).
+
+**IMPORTANT - Cost Optimization:**
+- Use \`jq\` param to extract only needed fields. Unfiltered responses are expensive!
+- Example: \`jq: "{ip: query, country: country, city: city}"\` - extract specific fields
+- If unsure about available fields, first call WITHOUT jq filter to see all fields, then use jq in subsequent calls
+
+**Schema Discovery Pattern:**
+1. First call: \`ipAddress: "8.8.8.8"\` (no jq) - explore available fields
+2. Then use: \`jq: "{ip: query, location: {city: city, country: country}}"\` - extract only what you need
+
+**Output format:** TOON (default, token-efficient) or JSON (\`outputFormat: "json"\`)
+
+**Parameters:**
+- \`ipAddress\` - IP to lookup (omit for current device's public IP)
+- \`includeExtendedData\` - Include ASN, host, proxy detection (requires API token)
+- \`useHttps\` - Use HTTPS (default: true)
+- \`jq\` - JMESPath expression to filter response
+- \`outputFormat\` - "toon" (default) or "json"
+
+**JQ examples:** \`query\` (IP only), \`{ip: query, country: country}\`, \`{location: {lat: lat, lon: lon}}\`
+
+**Note:** Cannot lookup private IPs (192.168.x.x, 10.x.x.x). Powered by ip-api.com.`, GetIpDetailsToolSchema.shape, handleGetIpDetails);
     methodLogger.debug('Successfully registered ip_get_details tool.');
 }
 exports.default = { registerTools };

package/dist/tools/ipaddress.types.d.ts

@@ -1,16 +1,28 @@
 import { z } from 'zod';
+/**
+ * Output format options for API responses
+ * - toon: Token-Oriented Object Notation (default, more token-efficient for LLMs)
+ * - json: Standard JSON format
+ */
+export declare const OutputFormat: z.ZodOptional<z.ZodEnum<["toon", "json"]>>;
 /**
  * Zod schema for the IP address tool arguments.
  */
 export declare const IpAddressToolArgs: z.ZodObject<{
     includeExtendedData: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     useHttps: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    jq: z.ZodOptional<z.ZodString>;
+    outputFormat: z.ZodOptional<z.ZodEnum<["toon", "json"]>>;
 }, "strict", z.ZodTypeAny, {
     useHttps: boolean;
     includeExtendedData: boolean;
+    jq?: string | undefined;
+    outputFormat?: "toon" | "json" | undefined;
 }, {
     useHttps?: boolean | undefined;
     includeExtendedData?: boolean | undefined;
+    jq?: string | undefined;
+    outputFormat?: "toon" | "json" | undefined;
 }>;
 /**
  * TypeScript type inferred from the IpAddressToolArgs Zod schema.

package/dist/tools/ipaddress.types.js

@@ -1,7 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IpAddressToolArgs = void 0;
+exports.IpAddressToolArgs = exports.OutputFormat = void 0;
 const zod_1 = require("zod");
+/**
+ * Output format options for API responses
+ * - toon: Token-Oriented Object Notation (default, more token-efficient for LLMs)
+ * - json: Standard JSON format
+ */
+exports.OutputFormat = zod_1.z
+    .enum(['toon', 'json'])
+    .optional()
+    .describe('Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax.');
 /**
  * Zod schema for the IP address tool arguments.
  */
@@ -19,5 +28,10 @@ exports.IpAddressToolArgs = zod_1.z
         .optional()
         .default(true)
         .describe('Whether to use HTTPS for the API call (recommended).'),
+    jq: zod_1.z
+        .string()
+        .optional()
+        .describe('JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "{ip: query, country: country}" (extract specific fields), "lat" (single field). See https://jmespath.org'),
+    outputFormat: exports.OutputFormat,
 })
     .strict();

package/dist/utils/cli.test.util.d.ts

@@ -21,8 +21,14 @@ export declare class CliTestUtil {
      * Validates that stdout contains expected strings/patterns
      */
     static validateOutputContains(output: string, expectedPatterns: (string | RegExp)[]): void;
+    /**
+     * Validates TOON output format
+     * TOON uses "key: value" syntax for objects
+     */
+    static validateToonOutput(output: string): void;
     /**
      * Validates Markdown output format
+     * @deprecated Use validateToonOutput for new code - output is now TOON by default
      */
     static validateMarkdownOutput(output: string): void;
 }

package/dist/utils/cli.test.util.js

@@ -99,8 +99,28 @@ class CliTestUtil {
             }
         }
     }
+    /**
+     * Validates TOON output format
+     * TOON uses "key: value" syntax for objects
+     */
+    static validateToonOutput(output) {
+        // Filter out debug log lines for cleaner validation
+        const cleanOutput = output
+            .split('\n')
+            .filter((line) => !line.match(/^\[\d{2}:\d{2}:\d{2}\]/))
+            .join('\n');
+        // TOON format characteristics:
+        // - Key-value pairs in "key: value" format
+        // - No curly braces for objects
+        // - Arrays use [count]{fields}: notation
+        const toonPatterns = [
+            /^\w+:\s*.+/m, // key: value pattern
+        ];
+        expect(toonPatterns.some((pattern) => pattern.test(cleanOutput))).toBe(true);
+    }
     /**
      * Validates Markdown output format
+     * @deprecated Use validateToonOutput for new code - output is now TOON by default
      */
     static validateMarkdownOutput(output) {
         // Filter out debug log lines for cleaner validation

package/dist/utils/constants.util.d.ts

@@ -8,7 +8,7 @@
  * Current application version
  * This should match the version in package.json
  */
-export declare const VERSION = "1.14.0";
+export declare const VERSION = "1.15.0";
 /**
  * Package name with scope
  * Used for initialization and identification

package/dist/utils/constants.util.js

@@ -11,7 +11,7 @@ exports.CLI_NAME = exports.PACKAGE_NAME = exports.VERSION = void 0;
  * Current application version
  * This should match the version in package.json
  */
-exports.VERSION = '1.14.0';
+exports.VERSION = '1.15.0';
 /**
  * Package name with scope
  * Used for initialization and identification

package/dist/utils/jq.util.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Apply a JMESPath filter to JSON data
+ *
+ * @param data - The data to filter (any JSON-serializable value)
+ * @param filter - JMESPath expression to apply
+ * @returns Filtered data or original data if filter is empty/invalid
+ *
+ * @example
+ * // Get single field
+ * applyJqFilter(data, "name")
+ *
+ * // Get nested field
+ * applyJqFilter(data, "body.storage.value")
+ *
+ * // Get multiple fields as object
+ * applyJqFilter(data, "{id: id, title: title}")
+ *
+ * // Array operations
+ * applyJqFilter(data, "results[*].title")
+ */
+export declare function applyJqFilter(data: unknown, filter?: string): unknown;
+/**
+ * Convert data to JSON string for MCP response
+ *
+ * @param data - The data to stringify
+ * @param pretty - Whether to pretty-print the JSON (default: true)
+ * @returns JSON string
+ */
+export declare function toJsonString(data: unknown, pretty?: boolean): string;
+/**
+ * Convert data to output string for MCP response
+ *
+ * By default, converts to TOON format (Token-Oriented Object Notation)
+ * for improved LLM token efficiency (30-60% fewer tokens).
+ * Falls back to JSON if TOON conversion fails or if useToon is false.
+ *
+ * @param data - The data to convert
+ * @param useToon - Whether to use TOON format (default: true)
+ * @param pretty - Whether to pretty-print JSON (default: true)
+ * @returns TOON formatted string (default), or JSON string
+ */
+export declare function toOutputString(data: unknown, useToon?: boolean, pretty?: boolean): Promise<string>;

package/dist/utils/jq.util.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyJqFilter = applyJqFilter;
+exports.toJsonString = toJsonString;
+exports.toOutputString = toOutputString;
+const jmespath_1 = __importDefault(require("jmespath"));
+const logger_util_js_1 = require("./logger.util.js");
+const toon_util_js_1 = require("./toon.util.js");
+const logger = logger_util_js_1.Logger.forContext('utils/jq.util.ts');
+/**
+ * Apply a JMESPath filter to JSON data
+ *
+ * @param data - The data to filter (any JSON-serializable value)
+ * @param filter - JMESPath expression to apply
+ * @returns Filtered data or original data if filter is empty/invalid
+ *
+ * @example
+ * // Get single field
+ * applyJqFilter(data, "name")
+ *
+ * // Get nested field
+ * applyJqFilter(data, "body.storage.value")
+ *
+ * // Get multiple fields as object
+ * applyJqFilter(data, "{id: id, title: title}")
+ *
+ * // Array operations
+ * applyJqFilter(data, "results[*].title")
+ */
+function applyJqFilter(data, filter) {
+    const methodLogger = logger.forMethod('applyJqFilter');
+    // Return original data if no filter provided
+    if (!filter || filter.trim() === '') {
+        methodLogger.debug('No filter provided, returning original data');
+        return data;
+    }
+    try {
+        methodLogger.debug(`Applying JMESPath filter: ${filter}`);
+        const result = jmespath_1.default.search(data, filter);
+        methodLogger.debug('Filter applied successfully');
+        return result;
+    }
+    catch (error) {
+        methodLogger.error(`Invalid JMESPath expression: ${filter}`, error);
+        // Return original data with error info if filter is invalid
+        return {
+            _jqError: `Invalid JMESPath expression: ${filter}`,
+            _originalData: data,
+        };
+    }
+}
+/**
+ * Convert data to JSON string for MCP response
+ *
+ * @param data - The data to stringify
+ * @param pretty - Whether to pretty-print the JSON (default: true)
+ * @returns JSON string
+ */
+function toJsonString(data, pretty = true) {
+    if (pretty) {
+        return JSON.stringify(data, null, 2);
+    }
+    return JSON.stringify(data);
+}
+/**
+ * Convert data to output string for MCP response
+ *
+ * By default, converts to TOON format (Token-Oriented Object Notation)
+ * for improved LLM token efficiency (30-60% fewer tokens).
+ * Falls back to JSON if TOON conversion fails or if useToon is false.
+ *
+ * @param data - The data to convert
+ * @param useToon - Whether to use TOON format (default: true)
+ * @param pretty - Whether to pretty-print JSON (default: true)
+ * @returns TOON formatted string (default), or JSON string
+ */
+async function toOutputString(data, useToon = true, pretty = true) {
+    const jsonString = toJsonString(data, pretty);
+    // Return JSON directly if TOON is not requested
+    if (!useToon) {
+        return jsonString;
+    }
+    // Try TOON conversion with JSON fallback
+    return (0, toon_util_js_1.toToonOrJson)(data, jsonString);
+}

package/dist/utils/toon.util.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convert data to TOON format with JSON fallback.
+ *
+ * TOON (Token-Oriented Object Notation) is 30-60% more token-efficient than JSON
+ * for tabular data, making it ideal for LLM responses.
+ *
+ * @param data - The data to convert
+ * @param jsonFallback - JSON string to return if TOON encoding fails
+ * @returns TOON formatted string, or JSON fallback on failure
+ *
+ * @example
+ * const json = JSON.stringify(data, null, 2);
+ * const output = await toToonOrJson(data, json);
+ */
+export declare function toToonOrJson(data: unknown, jsonFallback: string): Promise<string>;

package/dist/utils/toon.util.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toToonOrJson = toToonOrJson;
+const logger_util_js_1 = require("./logger.util.js");
+const logger = logger_util_js_1.Logger.forContext('utils/toon.util.ts');
+/**
+ * Cached TOON encoder to avoid repeated dynamic imports
+ */
+let toonEncode = null;
+/**
+ * Dynamically loads the TOON encoder module.
+ * Uses dynamic import because @toon-format/toon is an ESM-only package.
+ *
+ * @returns Promise resolving to the encode function or null if loading fails
+ */
+async function loadToonEncoder() {
+    const methodLogger = logger.forMethod('loadToonEncoder');
+    // Return cached encoder if available
+    if (toonEncode) {
+        return toonEncode;
+    }
+    try {
+        methodLogger.debug('Loading TOON encoder module...');
+        // Dynamic import for ESM module in CommonJS project
+        const toon = await import('@toon-format/toon');
+        toonEncode = toon.encode;
+        methodLogger.debug('TOON encoder loaded successfully');
+        return toonEncode;
+    }
+    catch (error) {
+        methodLogger.error('Failed to load TOON encoder', error);
+        return null;
+    }
+}
+/**
+ * Convert data to TOON format with JSON fallback.
+ *
+ * TOON (Token-Oriented Object Notation) is 30-60% more token-efficient than JSON
+ * for tabular data, making it ideal for LLM responses.
+ *
+ * @param data - The data to convert
+ * @param jsonFallback - JSON string to return if TOON encoding fails
+ * @returns TOON formatted string, or JSON fallback on failure
+ *
+ * @example
+ * const json = JSON.stringify(data, null, 2);
+ * const output = await toToonOrJson(data, json);
+ */
+async function toToonOrJson(data, jsonFallback) {
+    const methodLogger = logger.forMethod('toToonOrJson');
+    try {
+        const encode = await loadToonEncoder();
+        if (!encode) {
+            methodLogger.debug('TOON encoder not available, using JSON fallback');
+            return jsonFallback;
+        }
+        const result = encode(data, { indent: 2 });
+        methodLogger.debug('Successfully converted to TOON format');
+        return result;
+    }
+    catch (error) {
+        methodLogger.error('TOON encoding failed, using JSON fallback', error);
+        return jsonFallback;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "1.14.0",
+	"version": "1.15.0",
 	"description": "TypeScript MCP server boilerplate with STDIO and HTTP transport support, CLI tools, and extensible architecture",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -60,6 +60,7 @@
 		"@types/cors": "^2.8.19",
 		"@types/express": "^5.0.3",
 		"@types/jest": "^30.0.0",
+		"@types/jmespath": "^0.15.2",
 		"@types/node": "^24.3.1",
 		"@typescript-eslint/eslint-plugin": "^8.43.0",
 		"@typescript-eslint/parser": "^8.43.0",
@@ -75,10 +76,12 @@
 	},
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.17.5",
+		"@toon-format/toon": "^2.0.1",
 		"commander": "^14.0.0",
 		"cors": "^2.8.5",
 		"dotenv": "^17.2.2",
 		"express": "^5.1.0",
+		"jmespath": "^0.16.0",
 		"zod": "^3.25.76"
 	},
 	"publishConfig": {

package/package.json.bak

@@ -1,6 +1,6 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "1.13.5",
+	"version": "1.14.0",
 	"description": "TypeScript MCP server boilerplate with STDIO and HTTP transport support, CLI tools, and extensible architecture",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -60,6 +60,7 @@
 		"@types/cors": "^2.8.19",
 		"@types/express": "^5.0.3",
 		"@types/jest": "^30.0.0",
+		"@types/jmespath": "^0.15.2",
 		"@types/node": "^24.3.1",
 		"@typescript-eslint/eslint-plugin": "^8.43.0",
 		"@typescript-eslint/parser": "^8.43.0",
@@ -75,10 +76,12 @@
 	},
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.17.5",
+		"@toon-format/toon": "^2.0.1",
 		"commander": "^14.0.0",
 		"cors": "^2.8.5",
 		"dotenv": "^17.2.2",
 		"express": "^5.1.0",
+		"jmespath": "^0.16.0",
 		"zod": "^3.25.76"
 	},
 	"publishConfig": {