@finchagentic/mcp 4.6.4 → 4.7.0

package/README.md

@@ -37,13 +37,13 @@ Always pin the version. Never use `@latest`.
 
 ```bash
 # One-command installer (detects common MCP clients)
-npx -y -p @finchagentic/mcp@4.6.2 finch install
+npx -y @finchagentic/mcp@4.6.5 finch install
 ```
 
 ### Claude Code
 
 ```bash
-claude mcp add finch -s user -- npx -y -p @finchagentic/mcp@4.6.2 finch-mcp
+claude mcp add finch -s user -- npx -y @finchagentic/mcp@4.6.5
 ```
 
 ### Cursor / Windsurf / Claude Desktop
@@ -62,7 +62,7 @@ claude mcp add finch -s user -- npx -y -p @finchagentic/mcp@4.6.2 finch-mcp
 ### Hermes
 
 ```bash
-hermes mcp add finch -- npx -y -p @finchagentic/mcp@4.6.2 finch-mcp
+hermes mcp add finch -- npx -y @finchagentic/mcp@4.6.5
 ```
 
 <details>
@@ -122,7 +122,7 @@ Default palette is `core` (lighter context). Full set:
 Finch is the runtime. **Your LLM is the brain. Your data stays yours.**
 
 ```bash
-npx -y -p @finchagentic/mcp@4.6.2 finch setup
+npx -y @finchagentic/mcp@4.6.5 finch setup
 ```
 
 | Piece | Location |

package/dist/finch-output.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Output quality post-processor (CallTool choke point).
+ * Normalizes every tool response before it reaches the client:
+ *   1. Money/percent/date formatting inside the text payload (safe regex,
+ *      only touches patterns that are unambiguous).
+ *   2. Long-response triage: >200 lines get a "showing first N" head +
+ *      pointer instead of silently dumping (context window hygiene).
+ *   3. Never touches isError responses or JSON-only structuredContent-only
+ *      shapes - the client renders those natively.
+ */
+const MAX_LINES = 200;
+
+const MONEY_RE = /\$\s?([\d,]+\.\d{4,})/g;   // $0.00012345 -> $0.00012 (4dp cap)
+const ZEROS_RE = /\$0\.0+\d{0,2}(?=\b)/g;       // leave tiny prices alone
+
+function formatMoney(text) {
+  // Cap runaway precision: $0.00345678 -> $0.00346. Keeps tokens readable.
+  return text.replace(MONEY_RE, (m, num) => {
+    const n = Number(num.replace(/,/g, ""));
+    if (!Number.isFinite(n)) return m;
+    const trimmed = n.toFixed(4).replace(/0+$/, "").replace(/\.$/, "");
+    return `$${trimmed}`;
+  });
+}
+
+function truncate(text) {
+  const lines = text.split("\n");
+  if (lines.length <= MAX_LINES) return text;
+  const head = lines.slice(0, MAX_LINES).join("\n");
+  return `${head}\n\n… ${lines.length - MAX_LINES} more lines — narrow your query (smaller limit, fewer fields) for the full output.`;
+}
+
+function processResponse(response) {
+  if (!response || response.isError) return response;
+  const first = response.content?.[0];
+  if (!first || first.type !== "text" || typeof first.text !== "string") return response;
+  let text = first.text;
+  text = formatMoney(text);
+  text = truncate(text);
+  if (text !== first.text) {
+    return { ...response, content: [{ ...first, text }] };
+  }
+  return response;
+}
+
+module.exports = { processResponse, formatMoney, truncate };

package/dist/finch-status.js

@@ -0,0 +1,49 @@
+"use strict";
+const config_js_1 = require("./config.js");
+exports.FINCH_STATUS_TOOL = {
+    name: "finch_status",
+    description: "Check Finch MCP is working - no sign-in needed. Returns the version, how many tools are available, whether the session token is configured, and a ready-to-paste MCP client config snippet. Run this FIRST if anything feels off: it tells you instantly whether the problem is auth (missing token), network (backend unreachable), or the tool itself.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: "Finch status", readOnlyHint: true, openWorldHint: false },
+};
+
+// `finch_status` handler - fully local, never touches the backend, never auths.
+exports.handleFinchStatus = async function handleFinchStatus() {
+    const pkg = require("./../package.json");
+    let tokenSet = false;
+    try {
+        tokenSet = Boolean((0, config_js_1.getSavedToken)());
+    } catch { tokenSet = false; }
+    const configJson = JSON.stringify({
+        mcpServers: {
+            finch: {
+                command: "npx",
+                args: ["-y", "@finchagentic/mcp@" + pkg.version],
+                env: { FINCH_SESSION_TOKEN: "<your token>" },
+            },
+        },
+    }, null, 2);
+    const lines = tokenSet
+        ? [
+            "**Finch MCP v" + pkg.version + "** - runtime layer for agentic AI", "",
+            "- Session token: \u2705 configured",
+            "- Tools: **116** registered (surface depends on FINCH_TOOLS filter)",
+            "- Resources: finch://vault/<key> - Prompts: crypto-thesis and friends",
+            "- Tool presets: FINCH_PRESET=core|defi|research|memory (default core) - FINCH_TOOLS=all for everything",
+            "",
+            "All set. Good first calls: `memory_add` (persist a note instantly), `get_market` (live prices), `deep_research` (multi-step reports, streaming progress).",
+        ]
+        : [
+            "**Finch MCP v" + pkg.version + "** - runtime layer for agentic AI", "",
+            "- Session token: \u274c not set", "",
+            "**To sign in (60 seconds):**", "",
+            "1. Sign in at https://app.finchagentic.com (wallet or Google)",
+            "2. Copy your session token from the app",
+            "3. Add to your MCP client config:",
+            "```json",
+            configJson,
+            "```", "",
+            "Once the token is set, restart the MCP client and re-run this tool.",
+        ];
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+};

package/dist/server.js

@@ -58,6 +58,8 @@ const PKG_VERSION = (() => {
     }
 })();
 const market_js_1 = require("./tools/market.js");
+const finch_output_js_1 = require("./finch-output.js");
+const finch_status_js_1 = require("./finch-status.js");
 const defi_js_1 = require("./tools/defi.js");
 const automation_js_1 = require("./tools/automation.js");
 const insight_js_1 = require("./tools/insight.js");
@@ -215,7 +217,10 @@ exports.server = new index_js_1.Server({ name: "finch", version: PKG_VERSION },
 // withAnnotations attaches MCP behavioural hints (readOnly/destructive/etc) so
 // clients can auto-run reads and prompt before destructive/fund-moving calls.
 exports.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
-    tools: (0, annotations_js_1.withAnnotations)((0, tool_filter_js_1.filterTools)(exports.ALL_TOOLS)),
+    tools: [
+        finch_status_js_1.FINCH_STATUS_TOOL,
+        ...(0, annotations_js_1.withAnnotations)((0, tool_filter_js_1.filterTools)(exports.ALL_TOOLS)),
+    ],
 }));
 // MCP Resources - vault entries surface as `finch://vault/<key>`.
 // Clients can pull them via the standard resource flow instead of a Tool
@@ -283,14 +288,30 @@ exports.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (reques
             return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
         }
     }
+    if (name === "finch_status") {
+        return finch_status_js_1.handleFinchStatus();
+    }
     const handler = exports.HANDLER_MAP.get(name);
     if (!handler) {
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }
     try {
-        const result = await handler(name, args);
+        // Hard timeout guard: a hung tool must never wedge the client session.
+        // 180s covers deep_research's multi-stage pipeline with margin.
+        const HARD_TIMEOUT_MS = 180_000;
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(
+                `Tool timed out after 180s (${name}). The operation may still complete server-side - check the app before re-running.`
+            )), HARD_TIMEOUT_MS);
+        });
+        const result = await Promise.race([
+            handler(name, args),
+            timeoutPromise,
+        ]);
+        clearTimeout(timer);
         if (result)
-            return result;
+            return (0, finch_output_js_1.processResponse)(result);
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }
     catch (err) {

package/dist/tool-filter.js

@@ -37,7 +37,9 @@ function filterTools(allTools) {
     // Default is "core" - keeps LLM context cost low while everything
     // is still callable by name. Power users opt back in via
     // FINCH_TOOLS=all. Explicit empty env still means "all" for back-compat.
-    const raw = (process.env.FINCH_TOOLS ?? "core").trim().toLowerCase();
+    // FINCH_PRESET is the friendly alias (single preset name only); FINCH_TOOLS
+    // stays the power-user env (comma-separated combos + all).
+    const raw = (process.env.FINCH_TOOLS ?? process.env.FINCH_PRESET ?? "core").trim().toLowerCase();
     const env = raw === "" ? "core" : raw;
     if (env === "all")
         return allTools;

package/dist/tools/memory.js

@@ -302,7 +302,7 @@ exports.MEMORY_TOOLS = [
             "Unlike vault_save, memory_add is instant: no versioning, no type required. " +
             "Use for notes, decisions, preferences, or anything you want to find later. " +
             "Pass sourceUrl to fetch and index any web page, GitHub repo, or Notion page automatically - " +
-            "searchable in ~30s. Retrieval is full-text (keyword) search, not embeddings - " +
+            "searchable in ~30s. Retrieval is hybrid (semantic embeddings fused with keyword search, reranked by recency and pinned weight) - " +
             "'what did I say about ETH yield?' finds notes containing those words or close variants, " +
             "not unrelated phrasing with the same meaning. " +
             "Auto-deduplicates: identical content in your recent 50 memories is skipped (override with force:true). " +
@@ -324,11 +324,11 @@ exports.MEMORY_TOOLS = [
     },
     {
         name: "memory_search",
-        description: "Full-text (keyword) search over your stored memories, with 90-day time-decay weighting so " +
-            "recent notes outrank stale ones with similar wording. Good for exact-token lookups (env var " +
-            "names, contract addresses, IDs, specific phrases) - it does not understand meaning, so " +
-            "'low risk crypto yield' will not match a note phrased as 'conservative DeFi strategies' " +
-            "unless the words themselves overlap.",
+        description: "Search your stored memories. Hybrid retrieval: semantic embeddings fused with keyword " +
+            "search (Reciprocal Rank Fusion), reranked by recency - notes lose ~30% relevance per quarter - " +
+            "with pinned notes immune to decay. Understands meaning, not just words: 'low risk crypto yield' " +
+            "matches a note phrased as 'conservative DeFi strategies'. Exact-token lookups (env var names, " +
+            "contract addresses) also work via the lexical side.",
         inputSchema: {
             type: "object",
             properties: {
@@ -342,7 +342,7 @@ exports.MEMORY_TOOLS = [
         name: "memory_context",
         description: "Retrieve the most relevant memories for a topic, formatted as AI-ready context. " +
             "Use at the start of research tasks to prime with everything stored about a topic. " +
-            "Uses full-text (keyword) search, not embeddings - phrase your topic with the words " +
+            "Hybrid retrieval: embeddings + keyword, fused and reranked - phrasing can differ from the note. " +
             "you expect were actually used when the memory was saved.",
         inputSchema: {
             type: "object",
@@ -758,7 +758,7 @@ async function handleMemoryTool(name, args) {
                             `• memory_add (URL indexing) - ✅`,
                             `• Google Drive / Gmail / Notion - connect at finchagentic.com`,
                             ``,
-                            `**Capabilities:** Full-text (keyword) search with 90-day time-decay ranking - not embeddings, no vector search.`,
+                            `**Capabilities:** Hybrid retrieval (semantic + keyword, RRF fusion) with time-decay ranking; pinned notes bypass decay.`,
                         ].join("\n"),
                     }],
                 structuredContent: buildMemoryProfile(data),

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@finchagentic/mcp",
-  "version": "4.6.4",
+  "version": "4.7.0",
   "description": "The runtime layer for Agentic AI. Persistent memory, autonomous agents, and workflows that survive every session.",
   "main": "dist/index.js",
   "bin": {
     "finch": "dist/cli.js",
-    "finch-mcp": "dist/index.js"
+    "finch-mcp": "dist/index.js",
+    "@finchagentic/mcp": "dist/index.js"
   },
   "preferGlobal": true,
   "scripts": {
@@ -47,7 +48,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "ethers": "^6.17.0",
-    "zod": "^4.4.3"
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",