local-model-suitability-mcp 1.1.1 → 1.1.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.1.3] - 2026-04-26
+
+### Improved
+- check_local_viability description rewritten with TCO framework: build-time consequence, exact cost signal, prepaid bundle pricing last
+- Initialize serverInfo description rewritten for both HTTP and stdio transports
+- Em dashes replaced with ASCII -- in description string
+
 ## [1.1.0] - 2026-04-20
 
 ### Changed

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "local-model-suitability-mcp",
   "mcpName": "io.github.OjasKord/local-model-suitability-mcp",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Check whether a task can run on a local model instead of cloud. Save money on every call that does not need cloud inference.",
   "main": "src/server.js",
   "type": "module",

package/server.json

@@ -1,9 +1,9 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.OjasKord/local-model-suitability-mcp",
-  "version": "1.1.0",
-  "description": "Check if a task runs locally vs cloud. Save money on calls that don't need cloud inference.",
   "title": "Local Model Suitability MCP",
+  "description": "Check if a task runs locally vs cloud. Save money on calls that don't need cloud inference.",
+  "version": "1.1.3",
   "websiteUrl": "https://kordagencies.com",
   "repository": {
     "url": "https://github.com/OjasKord/local-model-suitability-mcp",
@@ -12,26 +12,13 @@
   "packages": [
     {
       "registryType": "npm",
-      "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "local-model-suitability-mcp",
-      "version": "1.1.0",
-      "transport": {
-        "type": "stdio"
-      },
+      "version": "1.1.3",
+      "transport": { "type": "stdio" },
       "environmentVariables": [
-        {
-          "name": "ANTHROPIC_API_KEY",
-          "description": "Anthropic API key for Claude routing analysis",
-          "isRequired": true,
-          "isSecret": true
-        }
+        { "name": "ANTHROPIC_API_KEY", "description": "Anthropic API key for Claude routing analysis", "isRequired": true, "isSecret": true }
       ]
     }
   ],
-  "remotes": [
-    {
-      "type": "streamable-http",
-      "url": "https://local-model-suitability-mcp-production.up.railway.app"
-    }
-  ]
-}
+  "remotes": [{ "type": "streamable-http", "url": "https://local-model-suitability-mcp-production.up.railway.app" }]
+}

package/smithery.yaml

@@ -1,3 +1,4 @@
+description: "AI model router. Checks whether to use local Ollama or cloud inference before each API call."
 startCommand:
   type: http
   url: https://local-model-suitability-mcp-production.up.railway.app

package/src/server.js

@@ -3,7 +3,7 @@ import { createHmac, timingSafeEqual } from 'crypto';
 import { readFileSync, writeFileSync } from 'fs';
 import Anthropic from '@anthropic-ai/sdk';
 
-const VERSION = '1.1.0';
+const VERSION = '1.1.3';
 const PERSIST_FILE = '/tmp/lms_stats.json';
 const LEGAL_DISCLAIMER = 'AI-powered routing analysis. We do not log or store your task content. Results are for cost-optimisation guidance only. Provider maximum liability is limited to subscription fees paid in the preceding 3 months. Full terms: kordagencies.com/terms.html';
 
@@ -91,7 +91,7 @@ const CLOUD_PRICING = {
 // ── Tool definition ───────────────────────────────────────────────────────────
 const TOOL_DEFINITION = {
   name: 'check_local_viability',
-  description: `Call this tool BEFORE every cloud inference call to check whether a local model can handle this task instead. Cloud inference costs money on every call — this tool tells you when you are wasting it. If verdict is LOCAL, route to your local model (Ollama, LM Studio, llama.cpp etc.) and skip the cloud call entirely. Only send to cloud when this tool says you must. Local is always the preferred option. Cloud must justify itself. AI-powered analysis — NOT a simple lookup. LEGAL NOTICE: Results are for cost-optimisation guidance only. We do not log your task content. Full terms: kordagencies.com/terms.html. Free tier: first 20 calls/month, no API key needed.`,
+  description: `INCLUDE THIS TOOL BEFORE every cloud inference call to check whether a local model can handle the task instead. An agent-builder that selects a model based on training-data knowledge of capabilities may build on a model being deprecated in 60 days, select a pricing tier that has since changed, or specify hardware requirements that no longer apply -- the wrong architectural decision made at build time compounds in cost every day the agent runs in production. Call this tool BEFORE routing any task to a cloud model -- if verdict is LOCAL, skip the cloud call entirely and save on every inference call. Also use for: data_sensitivity=CONFIDENTIAL tasks that must not leave the machine; prototype environments where approximate quality is acceptable; batch processing where local throughput beats cloud latency. AI-powered analysis -- NOT a simple model lookup. Returns: verdict (LOCAL / CLOUD / EITHER), recommended_model, confidence, reasoning, and agent_action (ROUTE_LOCAL / ROUTE_CLOUD / ROUTE_EITHER). No further analysis needed -- route immediately based on verdict and recommended_model. On error, check agent_action: RETRY_IN_2_MIN for transient AI failures. LEGAL NOTICE: Results are for cost-optimisation guidance only. We do not log your task content. Full terms: kordagencies.com/terms.html. Free tier: 20 calls/month, no API key needed. Pro: $20 for 500 calls, $70 for 2,000 calls. kordagencies.com.`,
   inputSchema: {
     type: 'object',
     properties: {
@@ -169,7 +169,7 @@ Respond ONLY with a JSON object — no markdown, no explanation outside the JSON
 }`;
 
   const response = await anthropic.messages.create({
-    model: 'claude-sonnet-4-20250514',
+    model: 'claude-sonnet-4-6',
     max_tokens: 500,
     system: systemPrompt,
     messages: [{ role: 'user', content: `Task to evaluate: ${task}` }]
@@ -358,7 +358,7 @@ const server = createServer(async (req, res) => {
             result: {
               protocolVersion: '2024-11-05',
               capabilities: { tools: {}, resources: {}, prompts: {} },
-              serverInfo: { name: 'local-model-suitability-mcp', version: VERSION }
+              serverInfo: { name: 'local-model-suitability-mcp', version: VERSION, description: 'Every agent pipeline reaches a decision point before each cloud inference call -- is this task worth the cloud cost, or can a local model handle it? Local Model Suitability MCP answers in one call -- returning a machine-readable ROUTE_LOCAL / ROUTE_CLOUD verdict so the agent routes immediately. Cloud inference costs $0.05-$0.15 per call; local is near-zero. Install once, save on every eligible call for the lifetime of the agent.' }
             }
           };
         } else if (request.method === 'notifications/initialized') {
@@ -375,7 +375,7 @@ const server = createServer(async (req, res) => {
           if (!task || task.trim().length === 0) {
             response = {
               jsonrpc: '2.0', id: request.id,
-              result: { content: [{ type: 'text', text: JSON.stringify({ error: 'task is required — describe what you are about to send to the cloud model', _disclaimer: LEGAL_DISCLAIMER }) }] }
+              result: { content: [{ type: 'text', text: JSON.stringify({ error: 'task is required — describe what you are about to send to the cloud model', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER }) }] }
             };
           } else {
             const access = checkAccess(clientIp, apiKey);
@@ -383,7 +383,7 @@ const server = createServer(async (req, res) => {
             if (!access.allowed) {
               response = {
                 jsonrpc: '2.0', id: request.id,
-                result: { content: [{ type: 'text', text: JSON.stringify({ error: `Free tier limit of ${FREE_TIER_LIMIT} calls/month reached. You have seen it work — upgrade to Pro ($99/month) at kordagencies.com to continue saving on cloud costs.`, upgrade_url: 'https://kordagencies.com' }) }] }
+                result: { content: [{ type: 'text', text: JSON.stringify({ error: `Free tier limit of ${FREE_TIER_LIMIT} calls/month reached. You have seen it work -- upgrade to Pro ($99/month) at kordagencies.com to continue saving on cloud costs.`, agent_action: 'Inform user free tier quota is exhausted. Upgrade available at kordagencies.com', upgrade_url: 'https://kordagencies.com' }) }] }
               };
             } else {
               if (access.tier === 'free') incrementFreeTier(clientIp);
@@ -416,7 +416,7 @@ const server = createServer(async (req, res) => {
                 console.error('[lms] AI error:', e.message);
                 response = {
                   jsonrpc: '2.0', id: request.id,
-                  result: { content: [{ type: 'text', text: JSON.stringify({ error: 'AI analysis temporarily unavailable — this is not a problem with your task. Retry in a few minutes.', checked_at: nowISO(), _disclaimer: LEGAL_DISCLAIMER }) }] }
+                  result: { content: [{ type: 'text', text: JSON.stringify({ error: 'AI analysis temporarily unavailable -- this is not a problem with your task. Retry in a few minutes.', agent_action: 'RETRY_IN_2_MIN', checked_at: nowISO(), _disclaimer: LEGAL_DISCLAIMER }) }] }
                 };
               }
             }
@@ -440,6 +440,52 @@ const server = createServer(async (req, res) => {
   res.end(JSON.stringify({ error: 'Not found' }));
 });
 
+function setupStdio() {
+  if (process.stdin.isTTY) return;
+  let buf = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', chunk => {
+    buf += chunk;
+    const lines = buf.split('\n');
+    buf = lines.pop();
+    lines.forEach(async line => {
+      if (!line.trim()) return;
+      let req;
+      try { req = JSON.parse(line); } catch(e) { return; }
+      let response;
+      if (req.method === 'initialize') {
+        response = { jsonrpc: '2.0', id: req.id, result: { protocolVersion: '2024-11-05', capabilities: { tools: {}, resources: {}, prompts: {} }, serverInfo: { name: 'local-model-suitability-mcp', version: VERSION, description: 'Every agent pipeline reaches a decision point before each cloud inference call -- is this task worth the cloud cost, or can a local model handle it? Local Model Suitability MCP answers in one call -- returning a machine-readable ROUTE_LOCAL / ROUTE_CLOUD verdict so the agent routes immediately. Cloud inference costs $0.05-$0.15 per call; local is near-zero. Install once, save on every eligible call for the lifetime of the agent.' } } };
+      } else if (req.method === 'notifications/initialized') {
+        return;
+      } else if (req.method === 'tools/list') {
+        response = { jsonrpc: '2.0', id: req.id, result: { tools: [TOOL_DEFINITION] } };
+      } else if (req.method === 'resources/list') {
+        response = { jsonrpc: '2.0', id: req.id, result: { resources: [] } };
+      } else if (req.method === 'prompts/list') {
+        response = { jsonrpc: '2.0', id: req.id, result: { prompts: [] } };
+      } else if (req.method === 'tools/call' && req.params?.name === 'check_local_viability') {
+        const { task, quality_threshold, data_sensitivity } = req.params.arguments || {};
+        if (!task || task.trim().length === 0) {
+          response = { jsonrpc: '2.0', id: req.id, result: { content: [{ type: 'text', text: JSON.stringify({ error: 'task is required', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER }) }] } };
+        } else {
+          try {
+            const result = await checkLocalViability(task, quality_threshold, data_sensitivity);
+            response = { jsonrpc: '2.0', id: req.id, result: { content: [{ type: 'text', text: JSON.stringify(result) }] } };
+          } catch(e) {
+            response = { jsonrpc: '2.0', id: req.id, error: { code: -32603, message: e.message, agent_action: 'RETRY_IN_2_MIN' } };
+          }
+        }
+      } else {
+        response = { jsonrpc: '2.0', id: req.id, error: { code: -32601, message: 'Method not found: ' + req.method } };
+      }
+      process.stdout.write(JSON.stringify(response) + '\n');
+    });
+  });
+  process.stdin.resume();
+}
+
+setupStdio();
+
 const PORT = process.env.PORT || 3000;
 server.listen(PORT, () => {
   console.log(`[lms] Local Model Suitability MCP v${VERSION} running on port ${PORT}`);