@tensorfeed/mcp-server 1.24.0 → 1.25.0

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 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

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.', {
@@ -727,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)'),
@@ -751,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'),
@@ -773,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'),
@@ -800,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'));
@@ -886,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.24.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.24.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.24.0",
+      "version": "1.25.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"