@tensorfeed/mcp-server 1.39.0 → 2.0.0

package/CHANGELOG.md

@@ -2,6 +2,67 @@
 
 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).
 
+## 2.0.0 - 2026-06-07
+
+Major tool-surface rework. BREAKING: the catalog drops from about 78 tools to
+exactly 24. The old surface had grown wide enough that agents picked the wrong
+tool or stalled across near-duplicate names; 24 sharp tools make tool-selection
+reliable. No HTTP endpoint was removed. Everything still works at
+tensorfeed.ai; this release only changes which slices are first-class MCP tools.
+
+### Migration
+
+If your code called any of the names below, switch to the replacement:
+
+- The eight signed verdicts collapse from preview plus paid pairs into one tool
+  each with a `tier` parameter. `<family>_verdict_preview` and
+  `<family>_verdict` are now a single `<family>_verdict`, where `tier` is
+  `preview` (free, the default) or `full` (1 credit, AFTA-signed). Affected
+  families: route, provider_reliability, x402_settlement, x402_publisher,
+  stack_safety, benchmark_trust, failover, ssvc.
+- The four time series collapse from free plus paid pairs into one tool each
+  with a `days` parameter. `pricing_series_free` and `pricing_series` are now a
+  single `pricing_series`; the same applies to `benchmark_series`,
+  `status_uptime`, and `status_leaderboard`. Pass `days` 1 to 7 for the free
+  window or 8 to 90 for the paid window.
+- The four watch creators merge into one `create_watch` with a `type`
+  parameter. `create_price_watch`, `create_status_watch`, `create_digest_watch`,
+  and `create_leaderboard_rank_watch` are now `create_watch` with `type` set to
+  `price`, `status`, `digest`, or `leaderboard_rank`.
+- `get_ai_today` folds into `get_ai_news`. Pass `digest: true` for the daily
+  brief that `get_ai_today` used to return.
+- `get_account_balance` and `get_account_usage` merge into one `account_status`
+  that returns both the balance and the usage view.
+
+### Removed from the tool list (still live as HTTP endpoints)
+
+About 40 long-tail standalone tools were dropped from the MCP surface, including
+the model-deprecation, agent-activity, IOC, AFTA-certification,
+agent-reputation, agent-readiness, crawler-access, MCP-registry-snapshot,
+probe, paper and trending feeds, Reddit, OpenRouter, ecosystem-today,
+earthquake, weather-alert, agent-opportunity, AI-CVE, company-filings, x402
+market, and the standalone routing, news-search, cost-projection, and
+agents-directory tools. None of these went away on the server. Each one is
+still callable as an HTTP endpoint on tensorfeed.ai, and the new
+`find_tensorfeed_data` tool helps an agent discover the right one on demand.
+
+### Added
+
+- `find_tensorfeed_data`: a discovery tool. Describe the AI-ecosystem data you
+  want and it returns the matching TensorFeed endpoints, with the path and
+  parameters to call, so an agent can reach the full catalog without a dedicated
+  tool for every feed.
+
+### The 24 tools
+
+`get_ai_news`, `get_ai_status`, `is_service_down`, `get_model_pricing`,
+`route_verdict`, `provider_reliability_verdict`, `x402_settlement_verdict`,
+`x402_publisher_verdict`, `stack_safety_verdict`, `benchmark_trust_verdict`,
+`failover_verdict`, `ssvc_verdict`, `whats_new`, `compare_models`,
+`provider_deepdive`, `pricing_series`, `benchmark_series`, `status_uptime`,
+`status_leaderboard`, `account_status`, `list_watches`, `create_watch`,
+`delete_watch`, `find_tensorfeed_data`.
+
 ## 1.39.0 - 2026-06-04
 
 Surfaces TensorFeed's full signed-verdict family in the stdio server. Adds the

package/README.md

@@ -43,17 +43,17 @@ Swap `task` for `reasoning`, `creative`, or `general`, or pass `?model=<id-or-na
 
 ### The agent path (MCP)
 
-With `@tensorfeed/mcp-server` installed, an agent gets two tools. Call the free one for the pick, then the paid one when it needs to defend the choice:
+With `@tensorfeed/mcp-server` installed, an agent gets one `route_verdict` tool with a `tier` parameter. Call it with the default free tier for the pick, then `tier="full"` when it needs to defend the choice:
 
 ```text
-# Free taste: the top pick + reasoning, no token (10/IP/day)
-route_verdict_preview({ task: "code" })
+# Free taste: the top pick + reasoning, no token (10/IP/day). tier defaults to "preview".
+route_verdict({ task: "code" })
 
 # 1 credit: ranked runners-up, constraint filters, AFTA-signed receipt
-route_verdict({ task: "code", max_latency_p95_ms: 1500, budget: 8, min_quality: 0.6 })
+route_verdict({ task: "code", tier: "full", max_latency_p95_ms: 1500, budget: 8, min_quality: 0.6 })
 ```
 
-`route_verdict` adds the ranked runners-up, the constraint filters (`max_latency_p95_ms`, `budget`, `min_quality`, `require_operational`, `exclude_deprecated`), and the AFTA-signed receipt the agent can audit later. Credits come from [tensorfeed.ai/developers/agent-payments](https://tensorfeed.ai/developers/agent-payments).
+`tier="full"` adds the ranked runners-up, the constraint filters (`max_latency_p95_ms`, `budget`, `min_quality`, `require_operational`, `exclude_deprecated`), and the AFTA-signed receipt the agent can audit later. Credits come from [tensorfeed.ai/developers/agent-payments](https://tensorfeed.ai/developers/agent-payments).
 
 ### Why it matters
 
@@ -61,11 +61,11 @@ Models, prices, and latency move week to week. `route_verdict` is one signed cal
 
 ## Catalog
 
-79 tools (48 free, 31 premium). Free tools need no token; premium tools charge USDC on Base via x402 and return an AFTA-signed receipt. The full tool reference lives in the [standalone repo](https://github.com/RipperMercs/tensorfeed-mcp).
+24 tools. The core flagships, the eight signed verdicts, the time-series tools, and the webhook watches are dedicated tools; the rest of the 100+ TensorFeed endpoints are reachable through the `find_tensorfeed_data` discovery tool and callable over HTTP. Free tiers need no token; paid tiers charge USDC on Base via x402 and return an AFTA-signed receipt. The full tool reference lives in the [standalone repo](https://github.com/RipperMercs/tensorfeed-mcp).
 
 ### Verdict family
 
-Seven signed decisions, each with a free preview tool plus a 1-credit ($0.02) AFTA-signed premium version:
+Eight signed decisions (route_verdict is featured above). Each is a single tool with a `tier` parameter: `tier="preview"` (default) is free, `tier="full"` costs 1 credit ($0.02) and adds the full ranking and an AFTA-signed receipt:
 
 - **provider_reliability_verdict**: the safest AI provider to build on, ranked by availability and tail consistency over TensorFeed's own probes.
 - **x402_settlement_verdict**: the x402 settlement momentum, concentration, and leading publisher over a 24h, 7d, or 30d window.

package/dist/discovery.d.ts

@@ -0,0 +1,9 @@
+export interface EndpointRow {
+    key: string;
+    path: string;
+    description: string;
+}
+/** Flatten the /api/meta `api` object ({key: 'path (desc)'}) into rows. */
+export declare function flattenCatalog(meta: unknown): EndpointRow[];
+/** Keyword-overlap score of a query against each row's key + description. Returns top N with score > 0. */
+export declare function scoreEndpoints(rows: EndpointRow[], query: string, limit: number): EndpointRow[];

package/dist/discovery.js

@@ -0,0 +1,38 @@
+/** Flatten the /api/meta `api` object ({key: 'path (desc)'}) into rows. */
+export function flattenCatalog(meta) {
+    const api = meta?.api;
+    if (!api || typeof api !== 'object')
+        return [];
+    const rows = [];
+    for (const [key, val] of Object.entries(api)) {
+        if (typeof val !== 'string')
+            continue;
+        const m = val.match(/^(\S+)\s*(.*)$/);
+        const path = m ? m[1] : val;
+        const description = m ? m[2].replace(/^\(/, '').replace(/\)$/, '') : '';
+        rows.push({ key, path, description });
+    }
+    return rows;
+}
+const STOP = new Set(['the', 'a', 'an', 'for', 'of', 'to', 'and', 'or', 'in', 'on', 'with', 'me', 'get', 'find', 'data', 'i', 'need', 'want', 'my']);
+function tokenize(s) {
+    return s.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 2 && !STOP.has(t));
+}
+/** Keyword-overlap score of a query against each row's key + description. Returns top N with score > 0. */
+export function scoreEndpoints(rows, query, limit) {
+    const q = new Set(tokenize(query));
+    if (q.size === 0)
+        return [];
+    const scored = rows
+        .map((r) => {
+        const hay = tokenize(r.key + ' ' + r.description);
+        let score = 0;
+        for (const t of hay)
+            if (q.has(t))
+                score += 1;
+        return { r, score };
+    })
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit).map((x) => x.r);
+}