local-model-suitability-mcp 1.1.5 → 1.1.7

package/README.md

@@ -1,3 +1,5 @@
+[![smithery badge](https://smithery.ai/badge/OjasKord/local-model-suitability-mcp)](https://smithery.ai/servers/OjasKord/local-model-suitability-mcp)
+
 # Local Model Suitability MCP
 
 **Cloud inference is expensive. Everything that can run locally should.**
@@ -39,11 +41,11 @@ Call this BEFORE every cloud inference call. If verdict is `LOCAL`, skip the clo
 
 ## Pricing
 
-| Plan | Price | Calls/month |
+| Plan | Calls | Price |
 |---|---|---|
-| Free | $0 | 20 |
-| Pro | $99/month | 2,000 |
-| Enterprise | $299/month | Unlimited |
+| Free | 20/month | $0 |
+| Starter | 500-call bundle | $20 |
+| Pro | 2,000-call bundle | $70 |
 
 [Subscribe at kordagencies.com](https://kordagencies.com)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "local-model-suitability-mcp",
   "mcpName": "io.github.OjasKord/local-model-suitability-mcp",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "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-card.json

@@ -0,0 +1,5 @@
+{
+  "token_footprint_min": 45,
+  "token_footprint_max": 350,
+  "token_footprint_avg": 160
+}

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.4",
+  "version": "1.1.6",
   "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.4",
+      "version": "1.1.6",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         { "name": "ANTHROPIC_API_KEY", "description": "Anthropic API key for Claude routing analysis", "isRequired": true, "isSecret": true }

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.5';
+const VERSION = '1.1.7';
 const PRO_UPGRADE_URL = 'https://buy.stripe.com/cNibJ08wd7zf6NS0h2ebu0p';
 const ENTERPRISE_UPGRADE_URL = 'https://buy.stripe.com/28E9AS27PbPvfkoe7Sebu0q';
 const PERSIST_FILE = '/tmp/lms_stats.json';
@@ -23,19 +23,23 @@ let stats = {
   recent_calls: [],
   free_tier_calls_by_ip: {}
 };
+const trialExtensions = new Map();
+const TRIAL_EXTENSION_CALLS = 10;
 
 function loadStats() {
   try {
     const data = JSON.parse(readFileSync(PERSIST_FILE, 'utf8'));
-    stats = data;
-    console.log('[lms] stats loaded from disk');
+    const { trialExtensions: te, ...rest } = data;
+    stats = rest;
+    if (te) te.forEach(([k, v]) => trialExtensions.set(k, v));
+    console.log('[lms] stats loaded from disk, ' + trialExtensions.size + ' trial extensions');
   } catch(e) {
     console.log('[lms] no stats file found — fresh start');
   }
 }
 
 function saveStats() {
-  try { writeFileSync(PERSIST_FILE, JSON.stringify(stats)); } catch(e) {}
+  try { writeFileSync(PERSIST_FILE, JSON.stringify({ ...stats, trialExtensions: [...trialExtensions.entries()] })); } catch(e) {}
 }
 
 loadStats();
@@ -66,7 +70,7 @@ function checkAccess(ip, apiKey) {
   const count = getFreeTierCount(ip);
   const remaining = FREE_TIER_LIMIT - count;
   if (remaining <= 0) {
-    return { allowed: false, tier: 'free', remaining: 0 };
+    return { allowed: false, tier: 'free', remaining: 0, reason: 'Free tier limit of ' + FREE_TIER_LIMIT + ' calls/month reached. Option 1: POST /trial-extension with {"name":"...","email":"...","use_case":"..."} for 10 extra free calls. Option 2: Upgrade at ' + PRO_UPGRADE_URL + ' (500 calls, never expire).', trial_extension: { endpoint: '/trial-extension', method: 'POST', body: { name: 'string', email: 'string', use_case: 'string' } }, upgrade_url: PRO_UPGRADE_URL };
   }
   return { allowed: true, tier: 'free', remaining, count };
 }
@@ -93,6 +97,7 @@ const CLOUD_PRICING = {
 // ── Tool definition ───────────────────────────────────────────────────────────
 const TOOL_DEFINITION = {
   name: 'check_local_viability',
+  idempotent: true,
   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',
@@ -328,7 +333,8 @@ const server = createServer(async (req, res) => {
       free_tier_total_calls,
       paid_keys_issued: apiKeys.size,
       tool_usage: stats.tool_usage,
-      recent_calls: stats.recent_calls.slice(-20).reverse()
+      recent_calls: stats.recent_calls.slice(-20).reverse(),
+      trial_extensions_granted: trialExtensions.size
     }));
     return;
   }
@@ -340,6 +346,40 @@ const server = createServer(async (req, res) => {
     return;
   }
 
+  // Trial extension
+  if (req.url === '/trial-extension' && req.method === 'POST') {
+    let body = '';
+    req.on('data', c => body += c);
+    req.on('end', async () => {
+      try {
+        const { name, email, use_case } = JSON.parse(body);
+        if (!name || !email) { res.writeHead(400, { ...cors, 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: 'name and email are required', agent_action: 'PROVIDE_REQUIRED_FIELDS' })); return; }
+        const emailKey = 'trial:' + email.toLowerCase().trim();
+        if (trialExtensions.has(emailKey)) { res.writeHead(409, { ...cors, 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: 'Trial extension already granted for this email.', upgrade_url: PRO_UPGRADE_URL, agent_action: 'INFORM_USER_TRIAL_ALREADY_USED' })); return; }
+        const month = MONTH_KEY();
+        if (!stats.free_tier_calls_by_ip[clientIp]) stats.free_tier_calls_by_ip[clientIp] = {};
+        const current = stats.free_tier_calls_by_ip[clientIp][month] || 0;
+        stats.free_tier_calls_by_ip[clientIp][month] = Math.max(0, current - TRIAL_EXTENSION_CALLS);
+        trialExtensions.set(emailKey, { name, email, use_case: use_case || '', ip: clientIp, granted_at: nowISO() });
+        saveStats();
+        const sendTrialEmail = async (to, subject, html) => {
+          await fetch('https://api.resend.com/emails', {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${process.env.RESEND_API_KEY}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ from: 'Local Model Suitability MCP <ojas@kordagencies.com>', to: [to], subject, html })
+          }).catch(e => console.error('[lms] email error:', e.message));
+        };
+        await sendTrialEmail('ojas@kordagencies.com', 'Local Model Suitability MCP -- Trial Extension: ' + name,
+          '<p><b>Name:</b> ' + name + '<br><b>Email:</b> ' + email + '<br><b>Use case:</b> ' + (use_case || 'Not provided') + '<br><b>IP:</b> ' + clientIp + '<br><b>Calls granted:</b> ' + TRIAL_EXTENSION_CALLS + '</p>');
+        await sendTrialEmail(email, TRIAL_EXTENSION_CALLS + ' extra free calls added -- Local Model Suitability MCP',
+          '<p>Hi ' + name + ',</p><p>Your ' + TRIAL_EXTENSION_CALLS + ' extra free calls have been added. You can keep using Local Model Suitability MCP right now -- no action needed.</p><p>When you need more, Pro is $20/month for 500 calls (never expire): ' + PRO_UPGRADE_URL + '</p><p>Ojas<br>kordagencies.com</p>');
+        res.writeHead(200, { ...cors, 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ granted: true, additional_calls: TRIAL_EXTENSION_CALLS, message: TRIAL_EXTENSION_CALLS + ' extra free calls added. Check your email for confirmation.', upgrade_url: PRO_UPGRADE_URL }));
+      } catch(e) { res.writeHead(400, { ...cors, 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: e.message, agent_action: 'RETRY_IN_2_MIN' })); }
+    });
+    return;
+  }
+
   // Stripe webhook
   if (req.url === '/webhook/stripe' && req.method === 'POST') {
     let body = '';
@@ -387,7 +427,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', agent_action: 'PROVIDE_REQUIRED_FIELD', _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', likely_cause: 'required field missing or malformed', retryable: false, retry_after_ms: null, fallback_tool: null, agent_action: 'PROVIDE_REQUIRED_FIELD', category: 'invalid_input', trace_id: nowISO(), _disclaimer: LEGAL_DISCLAIMER }) }] }
             };
           } else {
             const access = checkAccess(clientIp, apiKey);
@@ -395,7 +435,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 reached. Get 500 calls for $20 at ${PRO_UPGRADE_URL} -- calls never expire.`, agent_action: `Inform user free tier quota is exhausted. Get 500 calls for $20 at ${PRO_UPGRADE_URL} -- calls never expire.`, upgrade_url: PRO_UPGRADE_URL }) }] }
+                result: { content: [{ type: 'text', text: JSON.stringify({ error: `Free tier limit reached. Get 500 calls for $20 at ${PRO_UPGRADE_URL} -- calls never expire.`, likely_cause: 'free tier monthly limit reached', retryable: false, retry_after_ms: null, fallback_tool: null, agent_action: `Inform user free tier quota is exhausted. Get 500 calls for $20 at ${PRO_UPGRADE_URL} -- calls never expire.`, category: 'rate_limit', trace_id: nowISO(), upgrade_url: PRO_UPGRADE_URL }) }] }
               };
             } else {
               if (access.tier === 'free') incrementFreeTier(clientIp);
@@ -428,7 +468,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.', agent_action: 'RETRY_IN_2_MIN', 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.', likely_cause: 'AI routing analysis failed — transient Anthropic API issue', retryable: true, retry_after_ms: 120000, fallback_tool: null, agent_action: 'RETRY_IN_2_MIN', category: 'ai_failure', trace_id: nowISO(), checked_at: nowISO(), _disclaimer: LEGAL_DISCLAIMER }) }] }
                 };
               }
             }
@@ -441,7 +481,7 @@ const server = createServer(async (req, res) => {
         res.end(JSON.stringify(response));
       } catch(e) {
         res.writeHead(400, { ...cors, 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ error: e.message }));
+        res.end(JSON.stringify({ error: e.message, likely_cause: 'required field missing or malformed', retryable: false, retry_after_ms: null, fallback_tool: null, agent_action: 'FIX_REQUEST', category: 'invalid_input', trace_id: nowISO() }));
       }
     });
     return;
@@ -478,13 +518,13 @@ function setupStdio() {
       } 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 }) }] } };
+          response = { jsonrpc: '2.0', id: req.id, result: { content: [{ type: 'text', text: JSON.stringify({ error: 'task is required', likely_cause: 'required field missing or malformed', retryable: false, retry_after_ms: null, fallback_tool: null, agent_action: 'PROVIDE_REQUIRED_FIELD', category: 'invalid_input', trace_id: nowISO(), _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' } };
+            response = { jsonrpc: '2.0', id: req.id, result: { content: [{ type: 'text', text: JSON.stringify({ error: e.message, likely_cause: 'AI routing analysis failed — transient Anthropic API issue', retryable: true, retry_after_ms: 120000, fallback_tool: null, agent_action: 'RETRY_IN_2_MIN', category: 'ai_failure', trace_id: nowISO(), _disclaimer: LEGAL_DISCLAIMER }) }] } };
           }
         }
       } else {