@tensorfeed/mcp-server 1.39.0 → 2.0.1

package/CHANGELOG.md

@@ -2,6 +2,78 @@
 
 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.1 - 2026-07-03
+
+Docs release, no code changes to the stdio server. The README now documents
+the hosted remote endpoint (https://mcp.tensorfeed.ai/mcp, 33-tool curated
+subset) and its wallet-native x402 payment surfaces: premium tools
+(route_verdict, whats_new) are payable per call with a funded USDC wallet
+(Base or Solana) via arguments.payment or an X-PAYMENT header, with strict
+HTTP-402 transport for auto-pay wrappers at
+https://mcp.tensorfeed.ai/mcp?x402=strict. No account, no signup, no API key.
+Bearer credits tokens keep working everywhere.
+
+## 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

@@ -6,6 +6,38 @@
 
 This subfolder remains in the main `tensorfeed` repo as the **publishing source** for the npm package (`@tensorfeed/mcp-server`) and the [official MCP registry](https://registry.modelcontextprotocol.io/v0/servers/ai.tensorfeed/mcp-server) entry. Edits to `src/`, `server.json`, `package.json`, etc. happen here and get pushed to the standalone repo on release.
 
+## Hosted remote endpoint (zero install, wallet-payable)
+
+You do not need to install this package to use TensorFeed over MCP. A hosted Streamable HTTP endpoint serves a curated 33-tool subset (31 free + 2 premium), and the premium tools are payable per call with nothing but a funded USDC wallet: no account, no signup, no API key.
+
+| Surface | URL |
+| --- | --- |
+| Canonical endpoint | `https://mcp.tensorfeed.ai/mcp` |
+| Same endpoint, legacy path | `https://tensorfeed.ai/api/mcp` |
+| Strict x402 transport (for auto-pay wrappers) | `https://mcp.tensorfeed.ai/mcp?x402=strict` |
+
+Connect any MCP client with an HTTP transport:
+
+```json
+{
+  "mcpServers": {
+    "tensorfeed": { "type": "http", "url": "https://mcp.tensorfeed.ai/mcp" }
+  }
+}
+```
+
+`GET` the endpoint for machine-readable discovery info (tool count, payment surfaces, spec version). `POST` a JSON-RPC 2.0 envelope for `initialize`, `tools/list`, `tools/call`, and `ping`.
+
+### Paying premium tools per call (x402)
+
+The two premium tools, `route_verdict` (the signed model-routing decision) and `whats_new` (the full AFTA-signed morning brief), cost 1 credit ($0.02 in USDC, Base or Solana) per call. Three payment paths, pick whichever your client supports:
+
+1. **`arguments.payment`**: call the tool unpaid, read the canonical x402 requirements from the response (`accepts` array), sign, then retry the same call with the base64 payment payload in the `payment` argument. Works in every MCP client, no header access needed.
+2. **`X-PAYMENT` header**: send the same base64 payload as an `X-PAYMENT` (or `PAYMENT-SIGNATURE`) header on the POST.
+3. **Bearer credits**: `Authorization: Bearer tf_live_...` token from [tensorfeed.ai/developers/agent-payments](https://tensorfeed.ai/developers/agent-payments).
+
+x402 client wrappers that auto-pay on HTTP 402 should point at the strict URL (`?x402=strict`): unpaid premium calls there return a real HTTP 402 with a `PAYMENT-REQUIRED` header, the wrapper signs and retries, and the settled response carries a `PAYMENT-RESPONSE` header plus the AFTA-signed receipt in the body. No USDC yet? Claim free trial credits by signing a wallet message at `https://tensorfeed.ai/api/payment/trial-credits` (no payment required).
+
 ## Featured: Route Verdict
 
 The single best model to use right now, as one signed call. `route_verdict` fuses live pricing, contamination-discounted benchmark capability, real production usage, measured p95 latency probes, live incident state, and deprecation flags into one ranked decision, with an AFTA-signed receipt over the exact inputs. Instead of stitching together pricing pages, benchmark leaderboards, status dashboards, and your own latency tests, you get a current, defensible routing answer in one request.
@@ -43,17 +75,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 +93,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 on this stdio package. 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 hosted HTTP endpoint above carries a different, broader 33-tool curated subset (SEC EDGAR, openFDA, EIA, USGS, NWS, AI papers, and more). 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);
+}