@tensorfeed/mcp-server 1.34.0 → 1.36.0

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 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.0 - 2026-05-28
+
+Adds 6 tools wrapping the x402 settlement index endpoints (Wave 20)
+that shipped earlier today as the first-mover ecosystem-level index
+of x402 USDC settlements on Base mainnet.
+
+Free tools:
+- `get_x402_summary`: ecosystem-level rollup across 24h/7d/30d window.
+- `get_x402_publishers`: canonical list of x402-compliant publishers
+  TensorFeed is currently indexing, auto-discovered from
+  /.well-known/x402.json crawls.
+- `get_x402_leaderboard`: top publishers by volume in the window.
+- `get_x402_recent`: most recent settlement events newest-first.
+
+Premium tools (1 credit, AFTA-signed):
+- `premium_x402_publisher_receipts`: per-publisher feed with daily
+  series + avg_amount + attribution.
+- `premium_x402_series`: time-series of ecosystem or per-publisher
+  volume / count across a date range.
+
+Each premium tool's description includes an explicit VS FREE
+differentiator (per the upsell-copy memory): Anthropic-side LLMs
+repeat tool descriptions verbatim when deciding whether to recommend
+paying.
+
 ## 1.33.0 - 2026-05-25 (AI-CVE intelligence tools, unified versioning)
 
 Versions across npm + MCP Registry + MCPB manifest are now all 1.33.0

package/dist/index.js

@@ -1665,6 +1665,193 @@ registerTool('get_ai_cves_stats', 'Get aggregate counts across the most-recent A
         ],
     };
 });
+// ── Tool: get_ai_company_filings (free) ─────────────────────────────
+registerTool('get_ai_company_filings', 'Get recent SEC filings (10-K, 10-Q, 8-K, etc.) for one AI bellwether ticker. Cohort: NVDA, AMD, AVGO, TSM, ARM, MSFT, GOOGL, AMZN, ORCL, PLTR, SMCI, AAPL, META, TSLA. Source: data.sec.gov, public domain. Refreshed every 6 hours. Free, no auth.', {
+    ticker: z.string().describe('AI bellwether ticker (case-insensitive). One of NVDA, AMD, AVGO, TSM, ARM, MSFT, GOOGL, AMZN, ORCL, PLTR, SMCI, AAPL, META, TSLA.'),
+    limit: z.number().min(1).max(50).optional().describe('Max filings to return (default 10, max 50).'),
+}, async ({ ticker, limit }) => {
+    const params = new URLSearchParams({ ticker: ticker.toUpperCase() });
+    params.set('limit', String(limit ?? 10));
+    const data = (await fetchJSON(`/sec/filings/recent?${params}`));
+    if (!data.ok || !data.filings || data.filings.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No filings returned for ${ticker.toUpperCase()}. The ticker may not be in the AI bellwether cohort; supported tickers: NVDA, AMD, AVGO, TSM, ARM, MSFT, GOOGL, AMZN, ORCL, PLTR, SMCI, AAPL, META, TSLA.`,
+                },
+            ],
+        };
+    }
+    const lines = data.filings
+        .map((f, i) => `${i + 1}. ${f.form} on ${f.filing_date}\n   ${f.primary_doc_description}\n   ${f.primary_doc_url}`)
+        .join('\n\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${ticker.toUpperCase()} recent SEC filings (captured ${data.capturedAt ?? 'unknown'}, ${data.filings_count} returned):\n\n${lines}`,
+            },
+        ],
+    };
+});
+// ── Tool: premium_ai_company (1 credit) ─────────────────────────────
+registerTool('premium_ai_company', 'Get the per-ticker AI intelligence envelope for one AI bellwether: latest 10 SEC filings, latest 10 AI-tagged news mentions filtered by curated aliases, strategic and equity funding rounds where the company is a lead or notable investor, and cohort metadata. One call replaces four free siblings (sec/filings, news, funding, cohort) plus the agent-side alias filter. Costs 1 credit ($0.02). Strict-premium; ticker must be in the cohort.', {
+    ticker: z.string().describe('AI bellwether ticker (case-insensitive). One of NVDA, AMD, AVGO, TSM, ARM, MSFT, GOOGL, AMZN, ORCL, PLTR, SMCI, AAPL, META, TSLA.'),
+}, async ({ ticker }) => {
+    const upper = ticker.toUpperCase();
+    const data = (await fetchJSON(`/premium/ai-companies/${upper}`, { auth: true }));
+    const filingsList = data.filings.items
+        .slice(0, 10)
+        .map((f, i) => `   ${i + 1}. ${f.form} on ${f.filing_date}: ${f.primary_doc_description}`)
+        .join('\n');
+    const newsList = data.news.items
+        .slice(0, 10)
+        .map((n, i) => `   ${i + 1}. ${n.title}\n      ${n.source} (${n.publishedAt})`)
+        .join('\n\n');
+    const fundingList = data.funding_as_investor.items
+        .map((r, i) => `   ${i + 1}. ${r.company} ${r.stage}, $${r.amountM}M, ${r.announcedDate}`)
+        .join('\n');
+    const billing = data.billing
+        ? `\n\nCharged ${data.billing.credits_charged} credit. Remaining: ${data.billing.credits_remaining ?? '?'}.`
+        : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${data.ticker} (${data.company.display_name}, ${data.company.exchange}, ${data.company.category})\nAI angle: ${data.company.ai_angle}\nCaptured: ${data.capturedAt}\n\nRecent SEC filings (${data.filings.count}):\n${filingsList || '   none'}\n\nAI news mentions (${data.news.count}, aliases: ${data.news.aliases_used.join(', ')}):\n${newsList || '   none'}\n\nFunding rounds as lead or notable investor (${data.funding_as_investor.count}):\n${fundingList || '   none'}${billing}`,
+            },
+        ],
+    };
+});
+// ── Tool: get_x402_summary (free) ───────────────────────────────────
+registerTool('get_x402_summary', 'Get ecosystem-level x402 USDC settlement rollup on Base mainnet. Returns volume_usdc, count, unique_publishers, and change_vs_prior_window across a 24h, 7d, or 30d window. TensorFeed indexes Base USDC Transfer events filtered to wallets self-published by x402-compliant publishers in their /.well-known/x402.json manifests. Forward-only from 2026-05-28; ~6 min worst-case freshness (10 min SLA). Free, capped to one window per call.', {
+    window: z.enum(['24h', '7d', '30d']).optional().describe('Aggregation window. Defaults to 24h if omitted.'),
+}, async ({ window }) => {
+    const w = window ?? '24h';
+    const data = (await fetchJSON(`/x402-index/summary?window=${w}`));
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `x402 settlement rollup (window ${data.window}, captured ${data.captured_at}):\n  volume_usdc: ${data.volume_usdc}\n  count: ${data.count}\n  unique_publishers: ${data.unique_publishers}\n  change vs prior window: volume ${data.change_vs_prior_window.volume_pct}%, count ${data.change_vs_prior_window.count_pct}%`,
+            },
+        ],
+    };
+});
+// ── Tool: get_x402_publishers (free) ────────────────────────────────
+registerTool('get_x402_publishers', 'List x402-compliant publishers TensorFeed currently indexes. Each entry: domain, pay_to_wallets, first_seen, last_crawled, last_event_at, last_crawl_error. Publishers are auto-discovered daily via /.well-known/x402.json crawls. Use this to enumerate which publishers can then be queried in depth via premium_x402_publisher_receipts. Free, no input.', {}, async () => {
+    const data = (await fetchJSON('/x402-index/publishers'));
+    if (data.count === 0) {
+        return { content: [{ type: 'text', text: 'No x402 publishers indexed yet.' }] };
+    }
+    const lines = data.publishers
+        .map((p, i) => `${i + 1}. ${p.domain}\n   wallets: ${p.pay_to_wallets.join(', ')}\n   first_seen: ${p.first_seen}${p.last_event_at ? `\n   last_event_at: ${p.last_event_at}` : ''}${p.last_crawled ? `\n   last_crawled: ${p.last_crawled}` : ''}${p.last_crawl_error ? `\n   last_crawl_error: ${p.last_crawl_error}` : ''}`)
+        .join('\n\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `x402 publishers (${data.count}, captured ${data.captured_at}):\n\n${lines}`,
+            },
+        ],
+    };
+});
+// ── Tool: get_x402_leaderboard (free) ───────────────────────────────
+registerTool('get_x402_leaderboard', 'Top publishers by x402 USDC settlement volume across a 24h, 7d, or 30d window. Each leader: rank, domain, volume_usdc, count, share_pct of the sliced total. Limit clamped 1 to 25. Useful for surfacing which x402 services are receiving the most agent traffic. Free.', {
+    window: z.enum(['24h', '7d', '30d']).optional().describe('Aggregation window. Defaults to 24h.'),
+    limit: z.number().min(1).max(25).optional().describe('Top N publishers to return. Default 10, max 25.'),
+}, async ({ window, limit }) => {
+    const w = window ?? '24h';
+    const l = limit ?? 10;
+    const data = (await fetchJSON(`/x402-index/leaderboard?window=${w}&limit=${l}`));
+    if (data.leaders.length === 0) {
+        return { content: [{ type: 'text', text: `No x402 leaders for window ${data.window}.` }] };
+    }
+    const lines = data.leaders
+        .map((e) => `  ${e.rank}. ${e.domain}: $${e.volume_usdc} across ${e.count} settlements (${e.share_pct}% share)`)
+        .join('\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `x402 leaderboard (window ${data.window}, captured ${data.captured_at}):\n${lines}`,
+            },
+        ],
+    };
+});
+// ── Tool: get_x402_recent (free) ────────────────────────────────────
+registerTool('get_x402_recent', 'Most recent x402 USDC settlement events newest-first. Each event: tx_hash, block, ts, from_address, to_address, amount_usdc, publisher_domain, base_explorer_url (basescan.org link). Backed by a 100-event ring buffer updated on every indexer cron tick. Limit clamped 1 to 50, default 20. Free.', {
+    limit: z.number().min(1).max(50).optional().describe('Number of most-recent events. Default 20, max 50.'),
+}, async ({ limit }) => {
+    const l = limit ?? 20;
+    const data = (await fetchJSON(`/x402-index/recent?limit=${l}`));
+    if (data.count === 0) {
+        return { content: [{ type: 'text', text: 'No recent x402 settlement events.' }] };
+    }
+    const lines = data.events
+        .map((e, i) => `${i + 1}. ${e.ts} block ${e.block}\n   ${e.publisher_domain}: $${e.amount_usdc} USDC\n   from ${e.from_address} to ${e.to_address}\n   ${e.base_explorer_url}`)
+        .join('\n\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Recent x402 settlements (${data.count}, captured ${data.captured_at}):\n\n${lines}`,
+            },
+        ],
+    };
+});
+// ── Tool: premium_x402_publisher_receipts (1 credit) ────────────────
+registerTool('premium_x402_publisher_receipts', 'Per-publisher receipt feed for one x402-compliant domain across a from/to date range. Returns publisher meta (domain, pay_to_wallets, first_seen), window rollup (volume_usdc, count, avg_amount, daily_series), and attribution. \n\nVS FREE: get_x402_publishers tells you WHICH publishers exist but only with rolled-up scalar counters. This endpoint composes the per-day rollup across a date range with avg_amount, daily series for charts, and structured attribution license metadata in one paid call. An agent building a per-publisher analytics dashboard would otherwise need to call get_x402_publishers + reconstruct daily series from get_x402_summary per-day (impossible because /summary returns ecosystem totals not per-publisher) or wait for the next free-tier expansion. The premium endpoint saves the integration overhead and serves a forensic / compliance-grade payload for $0.02. \n\nForward-only index. Costs 1 credit ($0.02). Strict-premium; domain must exist in get_x402_publishers, otherwise 404.', {
+    domain: z.string().describe('Publisher domain to query, e.g. tensorfeed.ai. Must exist in get_x402_publishers result.'),
+    from: z.string().describe('Inclusive start date YYYY-MM-DD.'),
+    to: z.string().describe('Inclusive end date YYYY-MM-DD.'),
+}, async ({ domain, from, to }) => {
+    const params = new URLSearchParams({ from, to });
+    const data = (await fetchJSON(`/premium/x402-index/publisher/${encodeURIComponent(domain)}?${params}`, { auth: true }));
+    const series = data.rollup.daily_series
+        .map((d) => `   ${d.date}: $${d.volume_usdc} across ${d.count}`)
+        .join('\n');
+    const billing = data.billing
+        ? `\n\nCharged ${data.billing.credits_charged} credit. Remaining: ${data.billing.credits_remaining ?? '?'}.`
+        : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${data.publisher.domain} (first_seen ${data.publisher.first_seen})\nwallets: ${data.publisher.pay_to_wallets.join(', ')}\nwindow: ${data.window.from} to ${data.window.to} (${data.window.days} days)\n\nRollup:\n  volume_usdc: ${data.rollup.volume_usdc}\n  count: ${data.rollup.count}\n  avg_amount: ${data.rollup.avg_amount}\n\nDaily series:\n${series || '   none'}\n\nAttribution: ${data.attribution}\nLicense: ${data.license}${billing}`,
+            },
+        ],
+    };
+});
+// ── Tool: premium_x402_series (1 credit) ────────────────────────────
+registerTool('premium_x402_series', 'Time-series of ecosystem or per-publisher x402 settlement volume or count across a from/to date range, chart-feeding. Required: metric (volume or count), granularity (day or hour), from + to (YYYY-MM-DD). Optional: domain filter (omit for ecosystem). \n\nVS FREE: get_x402_summary returns one rolled-up scalar per call for a fixed window length (24h / 7d / 30d). For ANY chart or dashboard, the caller needs a series, not a scalar. The premium endpoint returns the full series in one call instead of N calls + N rate-limit budget burns. For a publisher-scoped series, it is the ONLY way to get per-publisher daily data (get_x402_summary is ecosystem-only). \n\nMVP supports granularity=day; hour returns an empty series with an attribution note (hourly rollups land in a future indexer version). Costs 1 credit ($0.02).', {
+    metric: z.enum(['volume', 'count']).describe('Which series to return.'),
+    granularity: z.enum(['day', 'hour']).describe('Bucket size. MVP: day only; hour returns empty series.'),
+    from: z.string().describe('Inclusive start date YYYY-MM-DD.'),
+    to: z.string().describe('Inclusive end date YYYY-MM-DD.'),
+    domain: z.string().optional().describe('Optional publisher domain filter. Omit for ecosystem-wide series.'),
+}, async ({ metric, granularity, from, to, domain }) => {
+    const params = new URLSearchParams({ metric, granularity, from, to });
+    if (domain)
+        params.set('domain', domain);
+    const data = (await fetchJSON(`/premium/x402-index/series?${params}`, { auth: true }));
+    const scope = domain ? `domain=${domain}` : 'ecosystem-wide';
+    const seriesLines = data.series.length
+        ? data.series.map((p) => `   ${p.ts}: ${p.value}`).join('\n')
+        : '   (empty)';
+    const billing = data.billing
+        ? `\n\nCharged ${data.billing.credits_charged} credit. Remaining: ${data.billing.credits_remaining ?? '?'}.`
+        : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `x402 ${data.metric} series (${data.granularity}, ${scope})\nwindow: ${data.window.from} to ${data.window.to}\n\nSeries:\n${seriesLines}\n\nAttribution: ${data.attribution}${billing}`,
+            },
+        ],
+    };
+});
 // ── Start ───────────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tensorfeed/mcp-server",
-  "version": "1.34.0",
+  "version": "1.36.0",
   "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.34.0",
+  "version": "1.36.0",
   "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.34.0",
+      "version": "1.36.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -68,7 +68,12 @@
         "status_leaderboard_free",
         "get_ai_cves_latest",
         "get_ai_cves_feed",
-        "get_ai_cves_stats"
+        "get_ai_cves_stats",
+        "get_ai_company_filings",
+        "get_x402_summary",
+        "get_x402_publishers",
+        "get_x402_leaderboard",
+        "get_x402_recent"
       ],
       "premiumTools": [
         "premium_routing",
@@ -91,7 +96,10 @@
         "create_leaderboard_rank_watch",
         "delete_watch",
         "get_account_balance",
-        "get_account_usage"
+        "get_account_usage",
+        "premium_ai_company",
+        "premium_x402_publisher_receipts",
+        "premium_x402_series"
       ]
     }
   }