@findtime/mcp-server 3.25.13 → 3.25.14

package/README.md

@@ -49,6 +49,7 @@ Optional environment variables:
 - `TIME_API_BASE_URL`
 - `TIME_API_TIMEOUT_MS`
 - `FINDTIME_MCP_CLIENT_TYPE`
+- `FINDTIME_MCP_TOOL_MODE=answer-only` to expose only `answer_time_question` and `get_api_diagnostics` for enterprise bots that should route every natural-language request through the answer API.
 - `FINDTIME_MCP_CLIENT_ID` or `FINDTIME_MCP_INSTALL_ID` to provide a stable client identifier. If omitted, the server creates one locally under the user's state directory.
 - `FINDTIME_MCP_INSTRUMENTATION_ENABLED=false` to opt out of anonymous usage telemetry.
 - `FINDTIME_MCP_USAGE_TELEMETRY_URL` to override the default telemetry endpoint.

package/SKILL.md

@@ -72,9 +72,22 @@ Most MCP clients need the same core config:
 
 For a company bot or server-side agent, set `FINDTIME_MCP_CLIENT_TYPE` to a stable identifier such as `company-bot`, and provide a stable install ID with `FINDTIME_MCP_CLIENT_ID` or `FINDTIME_MCP_INSTALL_ID` when possible.
 
+For enterprise bots that should avoid model-level tool selection across the lower-level APIs, set:
+
+```text
+FINDTIME_MCP_TOOL_MODE=answer-only
+```
+
+In answer-only mode, the MCP server exposes only:
+
+- `answer_time_question`
+- `get_api_diagnostics`
+
+Use this mode when the bot should route all natural-language time requests through the answer API first.
+
 ## Tool Selection
 
-Use `answer_time_question` first for natural-language or ambiguous prompts.
+Use `answer_time_question` first for natural-language or ambiguous prompts. In enterprise bot deployments, prefer `FINDTIME_MCP_TOOL_MODE=answer-only` so the agent sees `answer_time_question` as the default execution path instead of choosing lower-level tools directly.
 
 Examples:
 

package/package.json

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

package/server.js

@@ -49,6 +49,7 @@ const DEFAULT_API_KEY = firstNonEmpty(
   process.env.FINDTIME_TIME_API_KEY
 );
 const TIMEZONE_HELPERS_PATH = path.join(REPO_ROOT, 'slack-bot', 'timezone-helpers.js');
+const ANSWER_ONLY_TOOL_NAMES = new Set(['answer_time_question', 'get_api_diagnostics']);
 
 const TOOL_DEFINITIONS = [
   {
@@ -385,6 +386,25 @@ const TOOL_DEFINITIONS_BY_NAME = new Map(TOOL_DEFINITIONS.map((tool) => [tool.na
 let cachedResolveLocation;
 let cachedMcpClientId;
 
+function getMcpToolMode() {
+  const mode = String(firstNonEmpty(
+    process.env.FINDTIME_MCP_TOOL_MODE,
+    process.env.FINDTIME_MCP_TOOLS
+  ) || 'full').trim().toLowerCase();
+
+  return ['answer-only', 'answer_only', 'answer'].includes(mode)
+    ? 'answer-only'
+    : 'full';
+}
+
+function getVisibleToolDefinitions() {
+  if (getMcpToolMode() !== 'answer-only') {
+    return TOOL_DEFINITIONS;
+  }
+
+  return TOOL_DEFINITIONS.filter((tool) => ANSWER_ONLY_TOOL_NAMES.has(tool.name));
+}
+
 function safeReadJson(filePath) {
   try {
     return JSON.parse(fs.readFileSync(filePath, 'utf8'));
@@ -1073,7 +1093,7 @@ function createFindtimeMcpServer(options = {}) {
 
   async function callTool(name, args = {}) {
     const tool = TOOL_DEFINITIONS_BY_NAME.get(name);
-    if (!tool) {
+    if (!tool || (getMcpToolMode() === 'answer-only' && !ANSWER_ONLY_TOOL_NAMES.has(name))) {
       throw invalidParamsError(`Unknown tool: ${name}`);
     }
 
@@ -1231,7 +1251,7 @@ function createFindtimeMcpServer(options = {}) {
 
       if (method === 'tools/list') {
         return createSuccessResponse(message.id, {
-          tools: TOOL_DEFINITIONS.map(({ name, description, inputSchema }) => ({
+          tools: getVisibleToolDefinitions().map(({ name, description, inputSchema }) => ({
             name,
             description,
             inputSchema