@findtime/mcp-server 3.25.5 → 3.25.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@findtime/mcp-server",
-  "version": "3.25.5",
+  "version": "3.25.7",
   "mcpName": "io.github.hkchao/findtime-mcp-server",
   "description": "Production-parity MCP server for the findtime.io Time API",
   "bin": {

package/server.js

@@ -33,6 +33,18 @@ const DEFAULT_API_KEY = firstNonEmpty(
 const TIMEZONE_HELPERS_PATH = path.join(REPO_ROOT, 'slack-bot', 'timezone-helpers.js');
 
 const TOOL_DEFINITIONS = [
+  {
+    name: 'get_api_diagnostics',
+    description: 'Return MCP and findtime Time API diagnostics, including package version, API base URL, auth configuration, and a live health check.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      additionalProperties: false
+    },
+    buildRequest() {
+      return { path: '/health', params: new URLSearchParams() };
+    }
+  },
   {
     name: 'time_snapshot',
     description: 'Return the production time snapshot payload for one location or a list of locations.',
@@ -131,6 +143,10 @@ const TOOL_DEFINITIONS = [
         at: {
           type: 'string',
           description: 'Optional ISO timestamp used as the reference instant.'
+        },
+        year: {
+          type: 'integer',
+          description: 'Optional calendar year used to return DST transitions for that civil year.'
         }
       },
       additionalProperties: false
@@ -143,6 +159,7 @@ const TOOL_DEFINITIONS = [
       setParam(params, 'timezone', args.timezone);
       setParam(params, 'countryCode', args.countryCode);
       setParam(params, 'at', args.at);
+      setParam(params, 'year', args.year);
       return { path: '/timezone/dst', params };
     }
   },
@@ -807,6 +824,42 @@ function createFindtimeMcpServer(options = {}) {
       throw invalidParamsError(`Unknown tool: ${name}`);
     }
 
+    if (name === 'get_api_diagnostics') {
+      const request = tool.buildRequest(args || {});
+      const apiResponse = await fetchJson(name, request);
+      const checkedAt = new Date().toISOString();
+      const diagnostics = {
+        ok: apiResponse.ok,
+        tool: name,
+        checkedAt,
+        mcpVersion: SERVER_VERSION,
+        apiBaseUrl,
+        apiConfigured: Boolean(apiBaseUrl),
+        apiAuthConfigured: Boolean(typeof apiKey === 'string' && apiKey.trim()),
+        clientType: firstNonEmpty(
+          process.env.FINDTIME_MCP_CLIENT_TYPE,
+          process.env.TIME_API_CLIENT_TYPE
+        ) || null,
+        apiHealthUrl: apiResponse.url,
+        apiStatus: apiResponse.status,
+        apiReachable: apiResponse.ok
+      };
+
+      if (apiResponse.ok) {
+        diagnostics.apiHealth = apiResponse.parsedBody;
+      } else {
+        diagnostics.error = apiResponse.parsedBody !== undefined ? apiResponse.parsedBody : apiResponse.rawBody;
+        if (apiResponse.networkError) {
+          diagnostics.networkError = apiResponse.networkError;
+        }
+      }
+
+      return buildToolSuccessResult(name, diagnostics, {
+        endpoint: request.path,
+        url: apiResponse.url
+      });
+    }
+
     const request = tool.buildRequest(args || {});
     let apiResponse = await fetchJson(name, request);