@aashari/boilerplate-mcp-server 3.0.0 → 3.1.0

package/.releaserc.json

@@ -1,5 +1,7 @@
 {
-	"branches": ["main"],
+	"branches": [
+		"main"
+	],
 	"plugins": [
 		"@semantic-release/commit-analyzer",
 		"@semantic-release/release-notes-generator",
@@ -24,7 +26,8 @@
 					"package.json",
 					"CHANGELOG.md",
 					"src/index.ts",
-					"src/cli/index.ts"
+					"src/cli/index.ts",
+					"src/utils/constants.util.ts"
 				],
 				"message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
 			}

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [3.1.0](https://github.com/aashari/boilerplate-mcp-server/compare/v3.0.0...v3.1.0) (2026-02-17)
+
+
+### Features
+
+* modernize HTTP transport and standardize MCP tool contracts ([615b373](https://github.com/aashari/boilerplate-mcp-server/commit/615b3732c10ad2c607a899de0f6632221b6f7bc3))
+
 # [3.0.0](https://github.com/aashari/boilerplate-mcp-server/compare/v2.0.0...v3.0.0) (2026-02-04)
 
 

package/README.md

@@ -263,10 +263,6 @@ npm run mcp:stdio           # STDIO transport for AI assistants
 npm run mcp:http            # HTTP transport on port 3000
 npm run mcp:inspect         # HTTP + auto-open MCP Inspector
 
-# Development with Debugging
-npm run dev:stdio           # STDIO with MCP Inspector integration
-npm run dev:http            # HTTP with debug logging enabled
-
 # Testing
 npm test                    # Run all tests (Jest)
 npm run test:coverage       # Generate coverage report
@@ -275,7 +271,6 @@ npm run test:cli            # Run CLI-specific tests
 # Code Quality
 npm run lint                # ESLint with TypeScript rules
 npm run format              # Prettier formatting
-npm run update:deps         # Update dependencies
 ```
 
 ### Environment Variables

package/dist/controllers/ipaddress.controller.js

@@ -110,7 +110,8 @@ async function get(args = {}) {
         const useToon = args.outputFormat !== 'json';
         // Format the output
         const content = await (0, jq_util_js_1.toOutputString)(filteredData, useToon);
-        return { content, rawResponsePath };
+        // Expose canonical resolved IP so callers do not need to parse rendered output
+        return { content, rawResponsePath, resolvedIp: data.query };
     }
     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/index.js

@@ -5,9 +5,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startServer = startServer;
+const node_crypto_1 = require("node:crypto");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const logger_util_js_1 = require("./utils/logger.util.js");
 const config_util_js_1 = require("./utils/config.util.js");
 const constants_util_js_1 = require("./utils/constants.util.js");
@@ -22,6 +24,28 @@ const analysis_prompt_js_1 = __importDefault(require("./prompts/analysis.prompt.
 const logger = logger_util_js_1.Logger.forContext('index.ts');
 let serverInstance = null;
 let transportInstance = null;
+const httpSessions = new Map();
+function createMcpServer() {
+    const server = new mcp_js_1.McpServer({
+        name: constants_util_js_1.PACKAGE_NAME,
+        version: constants_util_js_1.VERSION,
+    });
+    ipaddress_tool_js_1.default.registerTools(server);
+    ipaddress_link_tool_js_1.default.registerTools(server);
+    ipaddress_resource_js_1.default.registerResources(server);
+    analysis_prompt_js_1.default.registerPrompts(server);
+    return server;
+}
+function getSessionId(req) {
+    const rawSessionId = req.headers['mcp-session-id'];
+    if (Array.isArray(rawSessionId)) {
+        return rawSessionId[0] ?? null;
+    }
+    if (typeof rawSessionId === 'string' && rawSessionId.length > 0) {
+        return rawSessionId;
+    }
+    return null;
+}
 /**
  * Start the MCP server with the specified transport mode
  */
@@ -34,19 +58,11 @@ async function startServer(mode = 'stdio') {
     if (config_util_js_1.config.getBoolean('DEBUG')) {
         serverLogger.debug('Debug mode enabled');
     }
-    serverLogger.info(`Initializing Boilerplate MCP server v${constants_util_js_1.VERSION}`);
-    serverInstance = new mcp_js_1.McpServer({
-        name: constants_util_js_1.PACKAGE_NAME,
-        version: constants_util_js_1.VERSION,
-    });
-    // Register tools, resources, and prompts
-    serverLogger.info('Registering MCP tools, resources, and prompts...');
-    ipaddress_tool_js_1.default.registerTools(serverInstance);
-    ipaddress_link_tool_js_1.default.registerTools(serverInstance);
-    ipaddress_resource_js_1.default.registerResources(serverInstance);
-    analysis_prompt_js_1.default.registerPrompts(serverInstance);
-    serverLogger.debug('All tools, resources, and prompts registered');
     if (mode === 'stdio') {
+        serverLogger.info(`Initializing Boilerplate MCP server v${constants_util_js_1.VERSION}`);
+        serverLogger.info('Registering MCP tools, resources, and prompts...');
+        serverInstance = createMcpServer();
+        serverLogger.debug('All tools, resources, and prompts registered');
         serverLogger.info('Using STDIO transport');
         transportInstance = new stdio_js_1.StdioServerTransport();
         try {
@@ -94,26 +110,132 @@ async function startServer(mode = 'stdio') {
         app.use(express_1.default.json());
         const mcpEndpoint = '/mcp';
         serverLogger.debug(`MCP endpoint: ${mcpEndpoint}`);
-        // Create transport instance
-        const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
-            // sessionIdGenerator is optional
-            sessionIdGenerator: undefined,
-        });
-        // Connect server to transport
-        await serverInstance.connect(transport);
-        transportInstance = transport;
-        // Handle all MCP requests
-        app.all(mcpEndpoint, (req, res) => {
-            transport
-                .handleRequest(req, res, req.body)
-                .catch((err) => {
-                serverLogger.error('Error in transport.handleRequest', err);
+        // Handle MCP POST requests (initialize + normal RPC calls)
+        app.post(mcpEndpoint, async (req, res) => {
+            const sessionId = getSessionId(req);
+            try {
+                if (sessionId) {
+                    const session = httpSessions.get(sessionId);
+                    if (!session) {
+                        res.status(404).json({
+                            jsonrpc: '2.0',
+                            error: {
+                                code: -32001,
+                                message: 'Session not found for provided Mcp-Session-Id',
+                            },
+                            id: null,
+                        });
+                        return;
+                    }
+                    await session.transport.handleRequest(req, res, req.body);
+                    return;
+                }
+                if (!(0, types_js_1.isInitializeRequest)(req.body)) {
+                    res.status(400).json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32000,
+                            message: 'Bad Request: Missing Mcp-Session-Id header',
+                        },
+                        id: null,
+                    });
+                    return;
+                }
+                serverLogger.info('Creating new HTTP MCP session for initialize request');
+                let initializedSessionId = null;
+                const sessionServer = createMcpServer();
+                const sessionTransport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => (0, node_crypto_1.randomUUID)(),
+                    onsessioninitialized: (newSessionId) => {
+                        initializedSessionId = newSessionId;
+                        httpSessions.set(newSessionId, {
+                            server: sessionServer,
+                            transport: sessionTransport,
+                        });
+                        serverLogger.info(`Initialized HTTP MCP session ${newSessionId}`);
+                    },
+                    onsessionclosed: (closedSessionId) => {
+                        const session = httpSessions.get(closedSessionId);
+                        if (!session) {
+                            return;
+                        }
+                        httpSessions.delete(closedSessionId);
+                        void session.server.close().catch((err) => {
+                            serverLogger.error(`Error closing server for session ${closedSessionId}`, err);
+                        });
+                        serverLogger.info(`Closed HTTP MCP session ${closedSessionId}`);
+                    },
+                });
+                await sessionServer.connect(sessionTransport);
+                try {
+                    await sessionTransport.handleRequest(req, res, req.body);
+                }
+                catch (err) {
+                    if (initializedSessionId) {
+                        httpSessions.delete(initializedSessionId);
+                    }
+                    await sessionTransport.close();
+                    await sessionServer.close();
+                    throw err;
+                }
+            }
+            catch (err) {
+                serverLogger.error('Error in HTTP MCP handler', err);
                 if (!res.headersSent) {
                     res.status(500).json({
-                        error: 'Internal Server Error',
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32603,
+                            message: 'Internal server error',
+                        },
+                        id: null,
                     });
                 }
-            });
+            }
+        });
+        // Handle optional GET requests for streamable HTTP SSE
+        app.get(mcpEndpoint, async (req, res) => {
+            const sessionId = getSessionId(req);
+            if (!sessionId) {
+                res.status(400).send('Missing Mcp-Session-Id header');
+                return;
+            }
+            const session = httpSessions.get(sessionId);
+            if (!session) {
+                res.status(404).send('Session not found');
+                return;
+            }
+            try {
+                await session.transport.handleRequest(req, res);
+            }
+            catch (err) {
+                serverLogger.error('Error in HTTP MCP GET handler', err);
+                if (!res.headersSent) {
+                    res.status(500).send('Internal Server Error');
+                }
+            }
+        });
+        // Handle session termination requests
+        app.delete(mcpEndpoint, async (req, res) => {
+            const sessionId = getSessionId(req);
+            if (!sessionId) {
+                res.status(400).send('Missing Mcp-Session-Id header');
+                return;
+            }
+            const session = httpSessions.get(sessionId);
+            if (!session) {
+                res.status(404).send('Session not found');
+                return;
+            }
+            try {
+                await session.transport.handleRequest(req, res);
+            }
+            catch (err) {
+                serverLogger.error('Error in HTTP MCP DELETE handler', err);
+                if (!res.headersSent) {
+                    res.status(500).send('Internal Server Error');
+                }
+            }
         });
         // Health check endpoint
         app.get('/', (_req, res) => {
@@ -130,7 +252,7 @@ async function startServer(mode = 'stdio') {
             });
         });
         setupGracefulShutdown();
-        return serverInstance;
+        return createMcpServer();
     }
 }
 /**
@@ -177,6 +299,24 @@ function setupGracefulShutdown() {
     const shutdown = async () => {
         try {
             shutdownLogger.info('Shutting down gracefully...');
+            if (httpSessions.size > 0) {
+                shutdownLogger.info(`Closing ${httpSessions.size} active HTTP session(s)`);
+            }
+            for (const [sessionId, session] of httpSessions.entries()) {
+                try {
+                    await session.transport.close();
+                }
+                catch (err) {
+                    shutdownLogger.error(`Error closing transport for session ${sessionId}`, err);
+                }
+                try {
+                    await session.server.close();
+                }
+                catch (err) {
+                    shutdownLogger.error(`Error closing server for session ${sessionId}`, err);
+                }
+            }
+            httpSessions.clear();
             if (transportInstance &&
                 'close' in transportInstance &&
                 typeof transportInstance.close === 'function') {

package/dist/tools/ipaddress-link.tool.js

@@ -5,68 +5,61 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const logger_util_js_1 = require("../utils/logger.util.js");
 const error_util_js_1 = require("../utils/error.util.js");
+const formatter_util_js_1 = require("../utils/formatter.util.js");
 const zod_1 = require("zod");
 const ipaddress_controller_js_1 = __importDefault(require("../controllers/ipaddress.controller.js"));
+const ipaddress_types_js_1 = require("./ipaddress.types.js");
 const logger = logger_util_js_1.Logger.forContext('tools/ipaddress-link.tool.ts');
 /**
  * Zod schema for the resource-link tool arguments
+ * Keep argument shape aligned with ip_get_details for consistency.
  */
 const GetIpDetailsLinkToolSchema = zod_1.z.object({
     ipAddress: zod_1.z
         .string()
         .optional()
         .describe('IP address to lookup (omit for current IP)'),
-    includeExtendedData: zod_1.z
-        .boolean()
-        .optional()
-        .describe('Include extended data (ASN, host, proxy detection)'),
+    ...ipaddress_types_js_1.IpAddressToolArgs.shape,
 });
 /**
  * Tool description for ip_get_details_link
  */
-const IP_GET_DETAILS_LINK_DESCRIPTION = `Retrieve IP address details and return as a resource reference (ResourceLink pattern).
-
-**This demonstrates the ResourceLink pattern** - instead of embedding full data inline, the tool returns a reference to a resource. This is useful for:
-- Large responses that would consume many tokens
-- Data that clients may cache and reuse
-- Responses that other tools can reference
-
-**When to use ResourceLink vs inline content:**
-- ResourceLink: Large data, cacheable, reusable across multiple tools
-- Inline: Small data, one-time use, immediate context
+const IP_GET_DETAILS_LINK_DESCRIPTION = `Retrieve IP address details and return both direct content and a resource link.
 
-**Parameters:**
-- \`ipAddress\` - IP to lookup (omit for current device's public IP)
-- \`includeExtendedData\` - Include ASN, host, proxy detection (requires API token)
+**Consistency with ip_get_details:**
+- Uses the same arguments: \`ipAddress\`, \`includeExtendedData\`, \`useHttps\`, \`jq\`, \`outputFormat\`
+- Uses the same output rendering pipeline (TOON by default, JSON when \`outputFormat: "json"\`)
 
-**Returns:** A resource reference (resourceLink) instead of inline text.
+**What this returns:**
+- A normal text response (same rendered output as \`ip_get_details\`)
+- A \`resource_link\` entry pointing to \`ip://<resolved-ip>\` for resource-style clients
 
 **Note:** Cannot lookup private IPs (192.168.x.x, 10.x.x.x). Powered by ip-api.com.`;
 /**
- * Handle IP lookup with ResourceLink pattern
+ * Handle IP lookup with resource-link + text output consistency.
  */
 async function handleGetIpDetailsLink(args) {
     const methodLogger = logger.forMethod('handleGetIpDetailsLink');
     methodLogger.debug(`Getting IP address details link for ${args.ipAddress || 'current IP'}...`, args);
     try {
-        // First, verify we can get the data
         const result = await ipaddress_controller_js_1.default.get(args);
-        // Extract the actual IP from the result
-        // The result.content includes the IP in TOON or JSON format
-        const ipMatch = result.content.match(/query[:\s]+([0-9.]+)/);
-        const actualIp = ipMatch?.[1] || args.ipAddress || 'current';
-        methodLogger.debug(`IP resolved to: ${actualIp}`);
-        // Return a ResourceLink instead of inline content
-        // This tells the client to fetch the resource separately
+        const actualIp = result.resolvedIp ||
+            (typeof args.ipAddress === 'string' ? args.ipAddress : 'current');
+        methodLogger.debug(`Resolved IP for resource URI: ${actualIp}`);
+        const textContent = (0, formatter_util_js_1.truncateForAI)(result.content, result.rawResponsePath);
+        const mimeType = args.outputFormat === 'json' ? 'application/json' : 'text/plain';
         return {
             content: [
                 {
-                    type: 'resource',
-                    resource: {
-                        uri: `ip://${actualIp}`,
-                        text: `IP lookup result available at resource ip://${actualIp}`,
-                        mimeType: 'text/markdown',
-                    },
+                    type: 'text',
+                    text: textContent,
+                },
+                {
+                    type: 'resource_link',
+                    uri: `ip://${actualIp}`,
+                    name: `IP lookup ${actualIp}`,
+                    description: `Resource link for IP lookup result ${actualIp}`,
+                    mimeType,
                 },
             ],
         };

package/dist/types/common.types.d.ts

@@ -50,4 +50,9 @@ export interface ControllerResponse {
      * When the response is truncated, this path allows AI to access the full data.
      */
     rawResponsePath?: string | null;
+    /**
+     * Canonical resolved IP from the upstream API response.
+     * Use this to avoid parsing formatted output when consumers need the queried IP value.
+     */
+    resolvedIp?: string;
 }

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 = "3.0.0";
+export declare const VERSION = "3.1.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 = '3.0.0';
+exports.VERSION = '3.1.0';
 /**
  * Package name with scope
  * Used for initialization and identification

package/dist/utils/constants.util.js.bak

@@ -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.19.0';
+exports.VERSION = '3.0.0';
 /**
  * Package name with scope
  * Used for initialization and identification

package/dist/utils/error-handler.util.js

@@ -162,7 +162,7 @@ function createUserFriendlyErrorMessage(code, context = {}, originalMessage) {
     const entity = entityType
         ? `${entityType}${entityIdStr ? ` ${entityIdStr}` : ''}`
         : 'Resource';
-    let message = '';
+    let message;
     switch (code) {
         case ErrorCode.NOT_FOUND:
             message = `${entity} not found${entityIdStr ? `: ${entityIdStr}` : ''}. Verify the ID is correct and that you have access to this ${entityType?.toLowerCase() || 'resource'}.`;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "3.0.0",
+	"version": "3.1.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",
@@ -14,28 +14,18 @@
 	},
 	"scripts": {
 		"build": "tsc",
+		"clean": "rm -rf dist coverage",
 		"prepare": "npm run build && node scripts/ensure-executable.js",
 		"postinstall": "node scripts/ensure-executable.js",
-		"clean": "rm -rf dist coverage",
+		"lint": "eslint src --ext .ts --config eslint.config.mjs",
+		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
 		"test": "jest",
 		"test:coverage": "jest --coverage",
 		"test:cli": "jest src/cli/.*\\.cli\\.test\\.ts --runInBand --testTimeout=60000",
-		"lint": "eslint src --ext .ts --config eslint.config.mjs",
-		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
-		"publish:npm": "npm publish",
-		"update:check": "npx npm-check-updates",
-		"update:deps": "npx npm-check-updates -u && npm install --legacy-peer-deps",
-		"update:version": "node scripts/update-version.js",
+		"cli": "npm run build && node dist/index.js",
 		"mcp:stdio": "TRANSPORT_MODE=stdio npm run build && node dist/index.js",
 		"mcp:http": "TRANSPORT_MODE=http npm run build && node dist/index.js",
-		"mcp:inspect": "TRANSPORT_MODE=http npm run build && (node dist/index.js &) && sleep 2 && npx @modelcontextprotocol/inspector http://localhost:3000/mcp",
-		"dev:stdio": "npm run build && npx @modelcontextprotocol/inspector -e TRANSPORT_MODE=stdio -e DEBUG=true node dist/index.js",
-		"dev:http": "DEBUG=true TRANSPORT_MODE=http npm run build && node dist/index.js",
-		"dev:server": "DEBUG=true npm run build && npx @modelcontextprotocol/inspector -e DEBUG=true node dist/index.js",
-		"dev:cli": "DEBUG=true npm run build && DEBUG=true node dist/index.js",
-		"start:server": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js",
-		"start:cli": "npm run build && node dist/index.js",
-		"cli": "npm run build && node dist/index.js"
+		"mcp:inspect": "TRANSPORT_MODE=http npm run build && (node dist/index.js &) && sleep 2 && npx @modelcontextprotocol/inspector http://localhost:3000/mcp"
 	},
 	"keywords": [
 		"mcp",
@@ -56,42 +46,42 @@
 	"author": "Andi Ashari",
 	"license": "ISC",
 	"engines": {
-		"node": ">=18.0.0"
+		"node": ">=20.0.0"
 	},
 	"devDependencies": {
-		"@eslint/js": "^9.39.1",
+		"@eslint/js": "^10.0.1",
 		"@semantic-release/changelog": "^6.0.3",
 		"@semantic-release/exec": "^7.1.0",
 		"@semantic-release/git": "^10.0.1",
-		"@semantic-release/github": "^12.0.2",
-		"@semantic-release/npm": "^13.1.2",
+		"@semantic-release/github": "^12.0.6",
+		"@semantic-release/npm": "^13.1.4",
 		"@types/cors": "^2.8.19",
-		"@types/express": "^5.0.5",
+		"@types/express": "^5.0.6",
 		"@types/jest": "^30.0.0",
 		"@types/jmespath": "^0.15.2",
-		"@types/node": "^24.10.10",
-		"@typescript-eslint/eslint-plugin": "^8.48.0",
-		"@typescript-eslint/parser": "^8.48.0",
-		"eslint": "^9.39.1",
+		"@types/node": "^25.2.3",
+		"@typescript-eslint/eslint-plugin": "^8.56.0",
+		"@typescript-eslint/parser": "^8.56.0",
+		"eslint": "^10.0.0",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-filenames": "^1.3.2",
-		"eslint-plugin-prettier": "^5.5.4",
+		"eslint-plugin-prettier": "^5.5.5",
 		"jest": "^30.2.0",
 		"nodemon": "^3.1.11",
-		"npm-check-updates": "^19.1.2",
-		"prettier": "^3.7.3",
-		"semantic-release": "^25.0.2",
-		"ts-jest": "^29.4.5",
+		"npm-check-updates": "^19.3.2",
+		"prettier": "^3.8.1",
+		"semantic-release": "^25.0.3",
+		"ts-jest": "^29.4.6",
 		"ts-node": "^10.9.2",
 		"typescript": "^5.9.3",
-		"typescript-eslint": "^8.48.0"
+		"typescript-eslint": "^8.56.0"
 	},
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.25.3",
+		"@modelcontextprotocol/sdk": "^1.26.0",
 		"@toon-format/toon": "^2.1.0",
 		"commander": "^14.0.3",
 		"cors": "^2.8.6",
-		"dotenv": "^17.2.3",
+		"dotenv": "^17.3.1",
 		"express": "^5.2.1",
 		"jmespath": "^0.16.0",
 		"zod": "^4.3.6"

package/package.json.bak

@@ -1,6 +1,6 @@
 {
 	"name": "@aashari/boilerplate-mcp-server",
-	"version": "2.0.0",
+	"version": "3.0.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",
@@ -14,28 +14,18 @@
 	},
 	"scripts": {
 		"build": "tsc",
+		"clean": "rm -rf dist coverage",
 		"prepare": "npm run build && node scripts/ensure-executable.js",
 		"postinstall": "node scripts/ensure-executable.js",
-		"clean": "rm -rf dist coverage",
+		"lint": "eslint src --ext .ts --config eslint.config.mjs",
+		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
 		"test": "jest",
 		"test:coverage": "jest --coverage",
 		"test:cli": "jest src/cli/.*\\.cli\\.test\\.ts --runInBand --testTimeout=60000",
-		"lint": "eslint src --ext .ts --config eslint.config.mjs",
-		"format": "prettier --write 'src/**/*.ts' 'scripts/**/*.js'",
-		"publish:npm": "npm publish",
-		"update:check": "npx npm-check-updates",
-		"update:deps": "npx npm-check-updates -u && npm install --legacy-peer-deps",
-		"update:version": "node scripts/update-version.js",
+		"cli": "npm run build && node dist/index.js",
 		"mcp:stdio": "TRANSPORT_MODE=stdio npm run build && node dist/index.js",
 		"mcp:http": "TRANSPORT_MODE=http npm run build && node dist/index.js",
-		"mcp:inspect": "TRANSPORT_MODE=http npm run build && (node dist/index.js &) && sleep 2 && npx @modelcontextprotocol/inspector http://localhost:3000/mcp",
-		"dev:stdio": "npm run build && npx @modelcontextprotocol/inspector -e TRANSPORT_MODE=stdio -e DEBUG=true node dist/index.js",
-		"dev:http": "DEBUG=true TRANSPORT_MODE=http npm run build && node dist/index.js",
-		"dev:server": "DEBUG=true npm run build && npx @modelcontextprotocol/inspector -e DEBUG=true node dist/index.js",
-		"dev:cli": "DEBUG=true npm run build && DEBUG=true node dist/index.js",
-		"start:server": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js",
-		"start:cli": "npm run build && node dist/index.js",
-		"cli": "npm run build && node dist/index.js"
+		"mcp:inspect": "TRANSPORT_MODE=http npm run build && (node dist/index.js &) && sleep 2 && npx @modelcontextprotocol/inspector http://localhost:3000/mcp"
 	},
 	"keywords": [
 		"mcp",
@@ -56,42 +46,42 @@
 	"author": "Andi Ashari",
 	"license": "ISC",
 	"engines": {
-		"node": ">=18.0.0"
+		"node": ">=20.0.0"
 	},
 	"devDependencies": {
-		"@eslint/js": "^9.39.1",
+		"@eslint/js": "^10.0.1",
 		"@semantic-release/changelog": "^6.0.3",
 		"@semantic-release/exec": "^7.1.0",
 		"@semantic-release/git": "^10.0.1",
-		"@semantic-release/github": "^12.0.2",
-		"@semantic-release/npm": "^13.1.2",
+		"@semantic-release/github": "^12.0.6",
+		"@semantic-release/npm": "^13.1.4",
 		"@types/cors": "^2.8.19",
-		"@types/express": "^5.0.5",
+		"@types/express": "^5.0.6",
 		"@types/jest": "^30.0.0",
 		"@types/jmespath": "^0.15.2",
-		"@types/node": "^24.10.10",
-		"@typescript-eslint/eslint-plugin": "^8.48.0",
-		"@typescript-eslint/parser": "^8.48.0",
-		"eslint": "^9.39.1",
+		"@types/node": "^25.2.3",
+		"@typescript-eslint/eslint-plugin": "^8.56.0",
+		"@typescript-eslint/parser": "^8.56.0",
+		"eslint": "^10.0.0",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-filenames": "^1.3.2",
-		"eslint-plugin-prettier": "^5.5.4",
+		"eslint-plugin-prettier": "^5.5.5",
 		"jest": "^30.2.0",
 		"nodemon": "^3.1.11",
-		"npm-check-updates": "^19.1.2",
-		"prettier": "^3.7.3",
-		"semantic-release": "^25.0.2",
-		"ts-jest": "^29.4.5",
+		"npm-check-updates": "^19.3.2",
+		"prettier": "^3.8.1",
+		"semantic-release": "^25.0.3",
+		"ts-jest": "^29.4.6",
 		"ts-node": "^10.9.2",
 		"typescript": "^5.9.3",
-		"typescript-eslint": "^8.48.0"
+		"typescript-eslint": "^8.56.0"
 	},
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.25.3",
+		"@modelcontextprotocol/sdk": "^1.26.0",
 		"@toon-format/toon": "^2.1.0",
 		"commander": "^14.0.3",
 		"cors": "^2.8.6",
-		"dotenv": "^17.2.3",
+		"dotenv": "^17.3.1",
 		"express": "^5.2.1",
 		"jmespath": "^0.16.0",
 		"zod": "^4.3.6"