@findtime/mcp-server 3.25.15 → 3.25.16

package/README.md

@@ -124,15 +124,16 @@ Best meeting time between New York, Sydney, and Mumbai?
 
 ## Local development
 
-Run the server directly from the public repo root:
+Run the workspace version directly:
 
 ```bash
-npm start
+npm run mcp:start
 ```
 
 The server attempts to load `.env.development.local`, `.env.development`, `.env.local`, and `.env` from:
 
 - the current working directory
+- `services/mcp-server`
 - the repo root
 
 ## Tests
@@ -140,13 +141,13 @@ The server attempts to load `.env.development.local`, `.env.development`, `.env.
 Protocol and transport tests:
 
 ```bash
-npm test
+npm run test:mcp-server
 ```
 
 Live production-parity smoke tests:
 
 ```bash
-npm run test:smoke
+npm run test:mcp-server:smoke
 ```
 
 The smoke suite checks:
@@ -168,7 +169,7 @@ The canonical public source for this package now lives in:
 - npm: `@findtime/mcp-server`
 - Official MCP Registry: `https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server`
 
-Publish and version updates should happen from this public repo.
+Publish and version updates should happen from that public repo, not from this private app repo.
 
 Standard publish flow in the public repo:
 
@@ -178,4 +179,11 @@ npm pack --dry-run
 npm publish --access public
 ```
 
-Use the workflow in `.github/workflows/publish.yml` for repo-backed publishes.
+The equivalent local verification checks in this repo are:
+
+```bash
+npm run test:mcp-server
+npm run mcp:pack
+```
+
+Treat this repo as the implementation source that originally produced the MCP package, not as the canonical public release source.

package/examples/claude-desktop-config.json

@@ -2,12 +2,13 @@
   "mcpServers": {
     "findtime": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@findtime/mcp-server"],
+      "command": "node",
+      "args": [
+        "/absolute/path/to/findtime-io-mcp/services/mcp-server/src/server.js"
+      ],
       "env": {
         "FINDTIME_MCP_CLIENT_TYPE": "claude-desktop",
-        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
-        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
+        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io"
       }
     }
   }

package/examples/cline-mcp.json

@@ -2,12 +2,13 @@
   "mcpServers": {
     "findtime": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@findtime/mcp-server"],
+      "command": "node",
+      "args": [
+        "/absolute/path/to/findtime-io-mcp/services/mcp-server/src/server.js"
+      ],
       "env": {
         "FINDTIME_MCP_CLIENT_TYPE": "cline",
-        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
-        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
+        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io"
       }
     }
   }

package/examples/codex-mcp.json

@@ -2,12 +2,13 @@
   "mcpServers": {
     "findtime": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@findtime/mcp-server"],
+      "command": "node",
+      "args": [
+        "/absolute/path/to/findtime-io-mcp/services/mcp-server/src/server.js"
+      ],
       "env": {
         "FINDTIME_MCP_CLIENT_TYPE": "codex",
-        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
-        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
+        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io"
       }
     }
   }

package/examples/cursor-mcp.json

@@ -2,12 +2,13 @@
   "mcpServers": {
     "findtime": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@findtime/mcp-server"],
+      "command": "node",
+      "args": [
+        "/absolute/path/to/findtime-io-mcp/services/mcp-server/src/server.js"
+      ],
       "env": {
         "FINDTIME_MCP_CLIENT_TYPE": "cursor",
-        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
-        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
+        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io"
       }
     }
   }

package/examples/windsurf-mcp.json

@@ -2,12 +2,13 @@
   "mcpServers": {
     "findtime": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@findtime/mcp-server"],
+      "command": "node",
+      "args": [
+        "/absolute/path/to/findtime-io-mcp/services/mcp-server/src/server.js"
+      ],
       "env": {
         "FINDTIME_MCP_CLIENT_TYPE": "windsurf",
-        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io",
-        "FINDTIME_TIME_API_KEY": "YOUR_FINDTIME_SECRET_KEY"
+        "FINDTIME_TIME_API_BASE_URL": "https://time-api.findtime.io"
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@findtime/mcp-server",
-  "version": "3.25.15",
+  "version": "3.25.16",
   "mcpName": "io.github.hkchao/findtime-mcp-server",
   "description": "Production-parity MCP server for the findtime.io Time API",
   "bin": {
@@ -31,14 +31,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hkchao/findtime-mcp-server.git"
-  },
   "homepage": "https://findtime.io/developers/mcp/",
-  "bugs": {
-    "url": "https://github.com/hkchao/findtime-mcp-server/issues"
-  },
   "keywords": [
     "mcp",
     "model-context-protocol",

package/server.js

@@ -442,14 +442,24 @@ function buildFindtimeHelpPayload() {
       },
       {
         intent: 'timezone_lookup',
-        example: 'What is the IANA timezone for San Francisco?',
-        notes: 'Use IANA timezone IDs as canonical identifiers.'
+        example: 'What timezone is Auckland in?',
+        notes: 'Returns the canonical IANA timezone plus the current abbreviation.'
+      },
+      {
+        intent: 'timezone_abbreviation_lookup',
+        example: 'What timezone abbreviation is Auckland?',
+        notes: 'Returns the current abbreviation plus the canonical IANA timezone.'
       },
       {
         intent: 'time_conversion',
-        example: 'Convert 3pm next Tuesday in New York to London, Berlin, and Singapore.',
+        example: 'If it is 3:30pm in London, what time is it in Sydney?',
         notes: 'Include local dates because conversions often cross calendar days.'
       },
+      {
+        intent: 'time_conversion',
+        example: 'What is 5pm San Francisco time in Tokyo?',
+        notes: 'Natural-language conversion works for common city and timezone phrasing.'
+      },
       {
         intent: 'dst_status',
         example: 'Is Mexico City on DST?',
@@ -462,7 +472,7 @@ function buildFindtimeHelpPayload() {
       },
       {
         intent: 'meeting_time_search',
-        example: 'Find a good 45-minute meeting time next week for San Francisco, Berlin, and Sydney.',
+        example: 'Find a good meeting time for San Francisco, Berlin, and Sydney.',
         notes: 'Returns ranked meeting windows and tradeoffs across participants.'
       },
       {
@@ -506,6 +516,20 @@ function buildFindtimeHelpPayload() {
   };
 }
 
+function formatFindtimeHelpText(help) {
+  const lines = [
+    'findtime.io Time Help',
+    '',
+    'Try asking:',
+    ...help.intents.map((entry) => `- ${entry.example}`),
+    '',
+    'If a place or timezone is ambiguous, findtime.io will ask for clarification. For example:',
+    ...help.ambiguityExamples.map((entry) => `- ${entry.query} -> ${entry.expectedBehavior}`),
+  ];
+
+  return lines.join('\n');
+}
+
 function safeReadJson(filePath) {
   try {
     return JSON.parse(fs.readFileSync(filePath, 'utf8'));
@@ -1199,14 +1223,15 @@ function createFindtimeMcpServer(options = {}) {
     }
 
     if (name === 'get_findtime_help') {
+      const help = buildFindtimeHelpPayload();
       return {
         content: [
           {
             type: 'text',
-            text: `get_findtime_help response\n${JSON.stringify(buildFindtimeHelpPayload(), null, 2)}`
+            text: formatFindtimeHelpText(help)
           }
         ],
-        structuredContent: buildFindtimeHelpPayload()
+        structuredContent: help
       };
     }