@sendinel/mcp-server 1.0.204 → 1.0.205

package/build/tools/tool-search.d.ts

@@ -12,7 +12,7 @@ export interface ScoredTool<T extends SearchableTool = SearchableTool> {
     score: number;
 }
 export interface RankResult<T extends SearchableTool = SearchableTool> {
-    /** Every tool with score > 0, best first (not truncated). */
+    /** Every eligible tool with score > 0, best first (not truncated). */
     matches: ScoredTool<T>[];
     /** Closest tools when nothing matched; empty only when `entries` is empty. */
     nearest: ScoredTool<T>[];

package/build/tools/tool-search.js

@@ -122,13 +122,32 @@ function fuzzyScore(entry, queryTokens, aliases) {
     }
     return score;
 }
+// These filler/catalog words carry no description-only signal even in a small catalog.
+// Keep them out of tokenize/scoreTool: a name, alias or group hit remains valid (#4628).
+const DESCRIPTION_FILLER = new Set(['no', 'such', 'tool', 'thing']);
 const byScoreThenName = (a, b) => b.score - a.score || a.entry.name.localeCompare(b.entry.name);
 export function rankTools(entries, query, options = {}) {
     const aliases = options.aliases ?? TOOL_ALIASES;
     const nearestLimit = options.nearestLimit ?? 5;
     const queryTokens = tokenize(query);
+    // Count each stemmed word once per description, using only the permitted/scoped catalog.
+    const descriptions = entries.map((entry) => toolTokens(entry, aliases).description);
+    const frequency = new Map();
+    for (const words of descriptions) {
+        for (const word of words)
+            frequency.set(word, (frequency.get(word) ?? 0) + 1);
+    }
+    // A single occurrence stays useful in catalogs smaller than four entries.
+    const maxFrequency = Math.max(1, Math.floor(entries.length / 4));
+    const distinctive = queryTokens.filter((token) => !STOPWORDS.has(token)
+        && !DESCRIPTION_FILLER.has(token) && (frequency.get(token) ?? 0) <= maxFrequency);
     const matches = entries
-        .map((entry) => ({ entry, score: scoreTool(entry, queryTokens, query, aliases) }))
+        .map((entry, index) => {
+        // Preserve all existing scores and OR semantics once there is meaningful evidence.
+        const eligible = scoreTool({ ...entry, description: '' }, queryTokens, query, aliases) > 0
+            || distinctive.some((token) => descriptions[index].has(token));
+        return { entry, score: eligible ? scoreTool(entry, queryTokens, query, aliases) : 0 };
+    })
         .filter((s) => s.score > 0)
         .sort(byScoreThenName);
     if (matches.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendinel/mcp-server",
-  "version": "1.0.204",
+  "version": "1.0.205",
   "description": "AI-controlled email operations control plane for campaigns, contacts, segments, analytics, and multi-provider sending via MCP.",
   "mcpName": "ai.sendinel/mcp-server",
   "type": "module",