local-model-suitability-mcp 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.1.4] - 2026-04-27
+
+### Added
+- `token_count` field on all tool responses — lets orchestrator budget ledgers track token cost per call
+- `/ready` endpoint — returns 200 when `ANTHROPIC_API_KEY` is present, 503 otherwise
+- Phase 4 enhanced error objects: `category`, `retryable`, `retry_after_ms`, `fallback_tool`, `trace_id` on all error returns
+
+## [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.2",
+  "version": "1.1.4",
   "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

@@ -3,7 +3,7 @@
   "name": "io.github.OjasKord/local-model-suitability-mcp",
   "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.2",
+  "version": "1.1.4",
   "websiteUrl": "https://kordagencies.com",
   "repository": {
     "url": "https://github.com/OjasKord/local-model-suitability-mcp",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "local-model-suitability-mcp",
-      "version": "1.1.2",
+      "version": "1.1.4",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         { "name": "ANTHROPIC_API_KEY", "description": "Anthropic API key for Claude routing analysis", "isRequired": true, "isSecret": true }

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.2';
+const VERSION = '1.1.4';
 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: {
@@ -191,7 +191,7 @@ Respond ONLY with a JSON object — no markdown, no explanation outside the JSON
     };
   }
 
-  return {
+  const _rLms = {
     ...parsed,
     task_quality_threshold: quality,
     data_sensitivity: sensitivity,
@@ -199,6 +199,8 @@ Respond ONLY with a JSON object — no markdown, no explanation outside the JSON
     checked_at: nowISO(),
     _disclaimer: LEGAL_DISCLAIMER
   };
+  _rLms.token_count = Math.ceil(JSON.stringify(_rLms).length / 4);
+  return _rLms;
 }
 
 // ── Stripe webhook ────────────────────────────────────────────────────────────
@@ -286,6 +288,14 @@ const server = createServer(async (req, res) => {
     return;
   }
 
+  if (req.url === '/ready' && (req.method === 'GET' || req.method === 'HEAD')) {
+    const checks = { anthropic: !!(process.env.ANTHROPIC_API_KEY) };
+    const ready = checks.anthropic;
+    res.writeHead(ready ? 200 : 503, { ...cors, 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ status: ready ? 'ready' : 'not_ready', version: VERSION, checks }));
+    return;
+  }
+
   // Deps
   if (req.url === '/deps' && req.method === 'GET') {
     let anthropicOk = false;
@@ -324,7 +334,7 @@ const server = createServer(async (req, res) => {
   // Server card (Smithery)
   if (req.url === '/.well-known/mcp/server-card.json') {
     res.writeHead(200, { ...cors, 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ name: 'local-model-suitability-mcp', version: VERSION, description: 'Check whether a task can run locally instead of cloud — save money on every call that doesn\'t need cloud inference.', tools: [TOOL_DEFINITION], transport: 'stdio', homepage: 'https://kordagencies.com', author: 'ojas1' }));
+    res.end(JSON.stringify({ name: 'local-model-suitability-mcp', version: VERSION, description: 'Check whether a task can run locally instead of cloud — save money on every call that doesn\'t need cloud inference.', tools: [TOOL_DEFINITION], transport: 'streamable-http', homepage: 'https://kordagencies.com', author: 'ojas1', token_footprint_min: 204, token_footprint_max: 230, token_footprint_avg: 217, idempotent_tools: ['check_local_viability'], circuit_breaker: false, health_endpoint: '/health', ready_endpoint: '/ready' }));
     return;
   }
 
@@ -358,7 +368,7 @@ const server = createServer(async (req, res) => {
             result: {
               protocolVersion: '2024-11-05',
               capabilities: { tools: {}, resources: {}, prompts: {} },
-              serverInfo: { name: 'local-model-suitability-mcp', version: VERSION, description: 'Checks whether each task can run on a local model instead of cloud -- saves money on every call that does not need cloud inference. Free tier: 20 calls/month, no API key needed.' }
+              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') {
@@ -454,7 +464,7 @@ function setupStdio() {
       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: 'Checks whether each task can run on a local model instead of cloud -- saves money on every call that does not need cloud inference. Free tier: 20 calls/month, no API key needed.' } } };
+        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') {