@tensorfeed/mcp-server 1.36.2 → 1.36.3

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to the [TensorFeed.ai MCP server](https://github.com/RipperMercs/tensorfeed-mcp). Free tools work without configuration; premium tools require a bearer token via the `TENSORFEED_TOKEN` env var. Buy credits at [tensorfeed.ai/developers/agent-payments](https://tensorfeed.ai/developers/agent-payments).
 
+## 1.36.3 - 2026-05-31
+
+Adds the Route Verdict wedge: TensorFeed's signed routing decision is now a
+tool you can try free, then upgrade. Brings the catalog to 61 tools (37 free,
+24 premium).
+
+Free tool:
+- `route_verdict_preview`: TensorFeed's signed routing decision that fuses
+  live pricing, contamination-discounted benchmarks, real production usage,
+  measured p95 latency, incident state, and deprecation flags into the single
+  best model for a task or a named model, with the reasoning. No key, 10 calls
+  per day per IP.
+
+Premium tool:
+- `route_verdict` (1 credit): the same decision plus ranked runners-up,
+  constraint filters (max p95 latency, budget, min quality, operational-only,
+  exclude-deprecated), and an AFTA-signed receipt over the exact inputs so you
+  can prove why you routed. Strict premium, no free trial.
+
+The older `premium_routing` (a ranked list with a score breakdown) is
+unchanged and remains available.
+
 ## 1.36.2 - 2026-05-31
 
 Pricing-copy and catalog-accuracy corrections. No change to the free/paid

package/dist/index.js

@@ -584,6 +584,124 @@ registerTool('premium_routing', 'Get a ranked list of recommended AI models for
         : '';
     return { content: [{ type: 'text', text: `Routing for "${data.task}":\n\n${list}${billing}` }] };
 });
+registerTool('route_verdict_preview', "Free. TensorFeed's signed routing decision that fuses live pricing, contamination-discounted benchmarks, real production usage, MEASURED p95 latency, incident state, and deprecation flags into the single best model for a task or a named model, with the reasoning. For ranked runners-up, constraint filters, and an AFTA-signed receipt you can audit, use route_verdict. 10 calls per day per IP.", {
+    task: z.enum(['code', 'reasoning', 'creative', 'general']).optional().describe('Task type to route for (code, reasoning, creative, general). Provide task or model.'),
+    model: z.string().optional().describe('Model id or display name to narrow the verdict to one model (e.g. "Claude Opus 4.7" or "claude-opus-4-7"). Provide task or model.'),
+}, async ({ task, model }) => {
+    if (!task && !model) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Provide a task (code, reasoning, creative, general) or a model id/name to get a routing verdict.',
+                },
+            ],
+        };
+    }
+    const params = new URLSearchParams();
+    if (task)
+        params.set('task', task);
+    if (model)
+        params.set('model', model);
+    const data = (await fetchJSON(`/preview/route-verdict?${params}`));
+    if (!data.verdict) {
+        return {
+            content: [{ type: 'text', text: `No routing verdict available for that query.\n${data.claim ?? ''}` }],
+        };
+    }
+    const v = data.verdict;
+    const t = data.trust;
+    const fresh = [
+        data.data_freshness.pricing ? `pricing ${data.data_freshness.pricing}` : null,
+        data.data_freshness.probe ? `latency ${data.data_freshness.probe}` : null,
+        data.data_freshness.status ? `status ${data.data_freshness.status}` : null,
+    ]
+        .filter(Boolean)
+        .join(', ');
+    const trustLine = `Trust: usage ${t.usage_corroborated ? 'corroborated' : 'uncorroborated'}, benchmark contamination ${t.benchmark_contamination}, operational ${t.operational_layer}, latency ${t.latency_layer}`;
+    const rl = data.rate_limit ? `\nPreview: ${data.rate_limit.remaining} of ${data.rate_limit.limit} calls left today (${data.rate_limit.scope}).` : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Route Verdict: ${v.model.name} (${v.model.provider})\n` +
+                    `Why: ${v.why}\n` +
+                    `Blended price: $${v.pricing.blended}/1M tokens (in $${v.pricing.input}, out $${v.pricing.output})\n` +
+                    `${trustLine}${fresh ? `\nData freshness: ${fresh}` : ''}\n` +
+                    `Upgrade: route_verdict (1 credit) adds ranked runners-up, constraint filters, and an AFTA-signed receipt you can audit.${rl}`,
+            },
+        ],
+    };
+});
+// ── Tool: route_verdict (1 credit) ──────────────────────────────────
+// The signed routing decision. Single best model plus ranked runners-up
+// for a task or named model, with constraint filters and an AFTA-signed
+// receipt over the exact inputs. Strict premium, no free trial. The free
+// route_verdict_preview is the no-auth taste of the same engine.
+registerTool('route_verdict', "Costs 1 credit ($0.02). The signed routing decision: TensorFeed's single best model plus ranked runners-up for your task or a named model, fused from live pricing, contamination-discounted benchmarks, real production usage, MEASURED p95 latency, incident state, and deprecation flags, with an AFTA-signed receipt over the exact inputs so you can prove why you routed. Versus the free route_verdict_preview it adds ranked runners-up, constraint filters (max p95 latency, budget, min quality, operational-only, exclude-deprecated), the signed receipt, and no rate limit. Get credits at tensorfeed.ai/developers/agent-payments. Strict premium, no free trial.", {
+    task: z.enum(['code', 'reasoning', 'creative', 'general']).optional().describe('Task type to route for (code, reasoning, creative, general). Provide task or model.'),
+    model: z.string().optional().describe('Model id or display name to narrow the verdict to one model. Provide task or model.'),
+    max_latency_p95_ms: z.number().optional().describe('Drop candidates whose measured p95 latency exceeds this value (ms).'),
+    budget: z.number().optional().describe('Max blended USD per 1M tokens'),
+    min_quality: z.number().min(0).max(1).optional().describe('Minimum trust-discounted quality score in [0, 1]'),
+    require_operational: z.boolean().optional().describe('Default true. Set false to keep candidates known down or in failover.'),
+    exclude_deprecated: z.boolean().optional().describe('Default true. Set false to keep deprecated or sunsetted models.'),
+}, async ({ task, model, max_latency_p95_ms, budget, min_quality, require_operational, exclude_deprecated }) => {
+    if (!task && !model) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Provide a task (code, reasoning, creative, general) or a model id/name to get a signed routing verdict.',
+                },
+            ],
+        };
+    }
+    const params = new URLSearchParams();
+    if (task)
+        params.set('task', task);
+    if (model)
+        params.set('model', model);
+    if (typeof max_latency_p95_ms === 'number')
+        params.set('max_latency_p95_ms', String(max_latency_p95_ms));
+    if (typeof budget === 'number')
+        params.set('budget', String(budget));
+    if (typeof min_quality === 'number')
+        params.set('min_quality', String(min_quality));
+    if (typeof require_operational === 'boolean')
+        params.set('require_operational', String(require_operational));
+    if (typeof exclude_deprecated === 'boolean')
+        params.set('exclude_deprecated', String(exclude_deprecated));
+    const data = (await fetchJSON(`/premium/route-verdict?${params}`, { auth: true }));
+    if (!data.verdict) {
+        return {
+            content: [{ type: 'text', text: `No routing verdict matched your filters.\n${data.claim ?? ''}` }],
+        };
+    }
+    const v = data.verdict;
+    const t = data.trust;
+    const f = data.filters_applied;
+    const runners = (data.runners_up ?? [])
+        .map((r) => `  #${r.rank} ${r.model.name} (${r.model.provider}) blended $${r.pricing.blended}/1M\n     ${r.why}`)
+        .join('\n');
+    const trustLine = `Trust: usage ${t.usage_corroborated ? 'corroborated' : 'uncorroborated'}, benchmark contamination ${t.benchmark_contamination}, operational ${t.operational_layer}, latency ${t.latency_layer}`;
+    const filterLine = `Filters: max p95 ${f.max_latency_p95_ms ?? 'none'}ms, require_operational ${f.require_operational}, exclude_deprecated ${f.exclude_deprecated}`;
+    const billing = data.billing
+        ? `\n\nCharged ${data.billing.credits_charged} credit. Remaining: ${data.billing.credits_remaining}.`
+        : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Route Verdict: ${v.model.name} (${v.model.provider}) score ${v.composite_score}\n` +
+                    `Why: ${v.why}\n` +
+                    `Blended price: $${v.pricing.blended}/1M tokens (in $${v.pricing.input}, out $${v.pricing.output})\n\n` +
+                    `Runners-up:\n${runners || '  (none)'}\n\n` +
+                    `${trustLine}\n${filterLine}\n\nClaim: ${data.claim}${billing}`,
+            },
+        ],
+    };
+});
 // ── Tool: pricing_series_free (free, 7-day cap) ─────────────────────
 registerTool('pricing_series_free', 'Daily price points for one AI model over the last 1 to 7 days, free. For windows up to 90 days use pricing_series (1 credit).', {
     model: z.string().describe('Model id or display name (e.g. "Claude Opus 4.7" or "claude-opus-4-7")'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tensorfeed/mcp-server",
-  "version": "1.36.2",
+  "version": "1.36.3",
   "mcpName": "ai.tensorfeed/mcp-server",
   "description": "MCP server for TensorFeed.ai - AI news, status, model data, and premium endpoints (routing, cost projection, forecast, history series, news search, webhook watches with digest tier, enriched directory) for AI agents",
   "main": "dist/index.js",

package/server.json

@@ -3,7 +3,7 @@
   "name": "ai.tensorfeed/mcp-server",
   "title": "TensorFeed",
   "description": "AI news, model pricing, service status, and machine-payable premium tools. AFTA-certified.",
-  "version": "1.36.2",
+  "version": "1.36.3",
   "websiteUrl": "https://tensorfeed.ai/developers/agent-payments",
   "repository": {
     "url": "https://github.com/RipperMercs/tensorfeed-mcp",
@@ -20,7 +20,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@tensorfeed/mcp-server",
-      "version": "1.36.2",
+      "version": "1.36.3",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -78,7 +78,8 @@
         "get_x402_summary",
         "get_x402_publishers",
         "get_x402_leaderboard",
-        "get_x402_recent"
+        "get_x402_recent",
+        "route_verdict_preview"
       ],
       "premiumTools": [
         "premium_routing",
@@ -103,7 +104,8 @@
         "get_account_usage",
         "premium_ai_company",
         "premium_x402_publisher_receipts",
-        "premium_x402_series"
+        "premium_x402_series",
+        "route_verdict"
       ]
     }
   }