@tensorfeed/mcp-server 1.23.0 → 1.25.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 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.25.0 - 2026-05-06
+
+### Added
+- Tool annotations on every registered tool (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`). All `get_*`, `*_series`, `*_search`, `compare_*`, `provider_deepdive`, `cost_projection`, `whats_new`, `*_snapshot`, `probe_*`, `list_watches`, `premium_routing`, and `premium_agents_directory` tools are flagged read-only + idempotent + open-world. The four `create_*_watch` tools are flagged write + non-idempotent. `delete_watch` is flagged destructive + idempotent. Hosts and clients can now decide whether a tool is safe to batch, retry, or call autonomously without re-prompting the user. Required by the Anthropic Connectors Directory.
+
+## 1.24.0 - 2026-05-06
+
+### Added
+- `get_model_deprecations` tool (free). Wraps the new `/api/model-deprecations` endpoint. Returns the provider-by-provider model retirement and deprecation calendar with announced / deprecation / sunset dates, recommended replacement model id, and a source URL pointing at the provider's own announcement. Optional `provider` and `status` filters. Agents that depend on a specific model id can now ask one question and learn whether the model will keep accepting traffic and, if not, what to migrate to. Closes the most-frequent agent-operator surprise in the production lifecycle.
+
 ## 1.23.0 - 2026-05-05
 
 ### Added

package/dist/index.js

@@ -56,14 +56,44 @@ const server = new McpServer({
 // covers any new endpoint that might forget it, plus protects against
 // drift between worker rules and what the MCP server should consider
 // safe. See ./sanitize.ts.
-function registerTool(name, description, paramsSchema, cb) {
+// MCP tool annotation presets. These are HINTS for hosts/clients and agents
+// so they can decide whether a tool is safe to call autonomously, batch, or
+// retry. Required by the Anthropic Connectors Directory and used by client
+// tool-pickers. See https://modelcontextprotocol.io/specification#tool-annotations
+//
+//   readOnlyHint:    true if the tool only reads, no side effects on the world
+//   destructiveHint: true if the tool may delete/destroy data
+//   idempotentHint:  true if calling twice has the same effect as once
+//   openWorldHint:   true if the tool interacts with external systems (HTTP/APIs)
+//
+// All TensorFeed tools hit the tensorfeed.ai HTTP API, so openWorldHint is
+// always true here.
+const READ_TOOL = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+const CREATE_TOOL = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+const DELETE_TOOL = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+function registerTool(name, description, paramsSchema, cb, annotations = READ_TOOL) {
     const wrapped = (async (args, extra) => {
         const result = await cb(args, extra);
         return sanitizeToolResponse(result);
     });
     // Direct dispatch to the SDK's underlying registration. Do not call
     // registerTool() here or it will recurse forever.
-    return server.tool(name, description, paramsSchema, wrapped);
+    return server.tool(name, description, paramsSchema, annotations, wrapped);
 }
 // ── Tool: get_ai_news ───────────────────────────────────────────────
 registerTool('get_ai_news', 'Get the latest AI news articles from TensorFeed.ai. Aggregates from 15+ sources including Anthropic, OpenAI, Google, TechCrunch, The Verge, arXiv, and more.', {
@@ -134,6 +164,66 @@ registerTool('get_model_pricing', 'Get AI model pricing comparison across all ma
         .join('\n\n');
     return { content: [{ type: 'text', text: `AI Model Pricing (per 1M tokens):\n\n${text}` }] };
 });
+// ── Tool: get_model_deprecations ────────────────────────────────────
+registerTool('get_model_deprecations', "Get the AI model deprecation calendar. Provider-by-provider registry of model retirements and deprecation announcements (OpenAI, Anthropic, Google, Cohere, and others). Each entry carries the announced/deprecation/sunset dates, the recommended replacement model, and a source URL pointing at the provider's own announcement. Useful for agents who need to know when a model they depend on will stop accepting traffic and what to migrate to.", {
+    provider: z
+        .string()
+        .optional()
+        .describe('Filter to a single provider (e.g. "OpenAI", "Anthropic", "Google", "Cohere"). Case-insensitive.'),
+    status: z
+        .enum(['announced', 'deprecated', 'sunsetted'])
+        .optional()
+        .describe('Filter by lifecycle stage. announced = deprecation announced but model still serves at full capacity; deprecated = past deprecation date, migration required; sunsetted = no longer accepts traffic.'),
+}, async ({ provider, status }) => {
+    const params = new URLSearchParams();
+    if (provider)
+        params.set('provider', provider);
+    if (status)
+        params.set('status', status);
+    const qs = params.toString();
+    const data = await fetchJSON(`/model-deprecations${qs ? `?${qs}` : ''}`);
+    const entries = data.deprecations ?? [];
+    if (entries.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No model deprecations matched the filter. The full calendar is at https://tensorfeed.ai/model-deprecations.',
+                },
+            ],
+        };
+    }
+    // Group by provider for readable output.
+    const byProvider = new Map();
+    for (const d of entries) {
+        const list = byProvider.get(d.provider) ?? [];
+        list.push(d);
+        byProvider.set(d.provider, list);
+    }
+    const sections = Array.from(byProvider.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([prov, list]) => {
+        const rows = list
+            .map(d => {
+            const dates = [
+                d.announcedDate ? `announced ${d.announcedDate}` : null,
+                d.deprecationDate ? `deprecated ${d.deprecationDate}` : null,
+                d.sunsetDate ? `sunset ${d.sunsetDate}` : null,
+            ]
+                .filter(Boolean)
+                .join(', ');
+            const display = d.modelDisplay ? ` (${d.modelDisplay})` : '';
+            const repl = d.replacement ? `\n     replacement: ${d.replacement}` : '';
+            const note = d.notes ? `\n     note: ${d.notes}` : '';
+            return `  ${d.model}${display} [${d.status.toUpperCase()}]\n     ${dates}${repl}${note}\n     source: ${d.sourceUrl}`;
+        })
+            .join('\n');
+        return `${prov}:\n${rows}`;
+    })
+        .join('\n\n');
+    const header = `AI Model Deprecation Calendar (${entries.length} ${entries.length === 1 ? 'entry' : 'entries'}, last updated ${data.lastUpdated ?? 'recently'}):\n\n`;
+    return { content: [{ type: 'text', text: header + sections }] };
+});
 // ── Tool: get_ai_today ──────────────────────────────────────────────
 registerTool('get_ai_today', 'Get a summary of what happened in AI today. Returns the top stories from the last 24 hours.', {
     limit: z.number().min(1).max(20).optional().describe('Number of stories (default 5)'),
@@ -667,7 +757,7 @@ registerTool('create_price_watch', 'Register a webhook watch on a model price ch
             },
         ],
     };
-});
+}, CREATE_TOOL);
 // ── Tool: create_status_watch (1 credit) ────────────────────────────
 registerTool('create_status_watch', 'Register a webhook watch on a service status transition (e.g. anthropic becomes down). Costs 1 credit. Watch lives 90 days.', {
     provider: z.string().describe('Provider name (e.g. anthropic, openai)'),
@@ -691,7 +781,7 @@ registerTool('create_status_watch', 'Register a webhook watch on a service statu
             },
         ],
     };
-});
+}, CREATE_TOOL);
 // ── Tool: create_digest_watch (1 credit) ────────────────────────────
 registerTool('create_digest_watch', 'Register a scheduled digest webhook that fires daily or weekly with a curated summary of pricing changes (regardless of whether anything dramatic happened). Costs 1 credit. Watch lives 90 days. Set-and-forget for agents that want a periodic snapshot without subscribing to realtime transitions.', {
     cadence: z.enum(['daily', 'weekly']).describe('How often the digest fires'),
@@ -713,7 +803,7 @@ registerTool('create_digest_watch', 'Register a scheduled digest webhook that fi
             },
         ],
     };
-});
+}, CREATE_TOOL);
 // ── Tool: create_leaderboard_rank_watch (1 credit) ──────────────────
 registerTool('create_leaderboard_rank_watch', 'Register a webhook that fires when a provider crosses a rank threshold on the cross-provider 7-day uptime leaderboard. Rank 1 = best (highest uptime). drops_below: was rank<=N, now rank>N (got worse). rises_above: was rank>=N, now rank<N (got better). changes: any rank movement. Costs 1 credit at registration. Watch lives 90 days.', {
     provider: z.string().describe('Provider name or slug (case-insensitive). e.g. claude, openai, gemini, bedrock, azure'),
@@ -740,14 +830,14 @@ registerTool('create_leaderboard_rank_watch', 'Register a webhook that fires whe
             },
         ],
     };
-});
+}, CREATE_TOOL);
 // ── Tool: delete_watch ──────────────────────────────────────────────
 registerTool('delete_watch', 'Delete one of your active webhook watches by id. Free, requires TENSORFEED_TOKEN.', {
     watch_id: z.string().describe('The wat_... id from create_price_watch / create_status_watch / list_watches'),
 }, async ({ watch_id }) => {
     await fetchJSON(`/premium/watches/${watch_id}`, { method: 'DELETE', auth: true });
     return { content: [{ type: 'text', text: `Deleted watch ${watch_id}.` }] };
-});
+}, DELETE_TOOL);
 // ── Tool: probe_latest (free) ───────────────────────────────────────
 registerTool('probe_latest', 'Last 24 hours of measured LLM endpoint latency and availability per provider (Anthropic, OpenAI, Google, Mistral, Cohere). TensorFeed pings each provider\'s chat completion endpoint every 15 min and records time-to-first-byte, total response time, and HTTP status. Returns per-provider success rate and ttfb/total p50/p95/p99 latency. The data is unique because we measure it ourselves, not self-reported by the providers. Useful when an agent needs to pick a provider whose SLA you can verify, or to detect ongoing incidents before they hit a status page. Free, no auth.', {}, async () => {
     const data = (await fetchJSON('/probe/latest'));
@@ -826,7 +916,7 @@ registerTool('mcp_registry_snapshot', 'Today\'s summary of the official Model Co
         content: [
             {
                 type: 'text',
-                text: `MCP Server Registry — ${s.date}\n` +
+                text: `MCP Server Registry, ${s.date}\n` +
                     `Total servers: ${s.total_servers} (across ${s.total_versions} versioned entries)\n` +
                     `Status: ${statusLine}\n${delta}\n\n` +
                     `Top namespaces:\n${topNs}` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tensorfeed/mcp-server",
-  "version": "1.23.0",
+  "version": "1.25.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.23.0",
+  "version": "1.25.0",
   "websiteUrl": "https://tensorfeed.ai/developers/agent-payments",
   "repository": {
     "url": "https://github.com/RipperMercs/tensorfeed-mcp",
@@ -14,7 +14,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@tensorfeed/mcp-server",
-      "version": "1.23.0",
+      "version": "1.25.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"