@finchagentic/mcp 4.6.5 → 4.7.1

package/dist/cli.js

@@ -64,7 +64,7 @@ const CORE_TOOL_COUNT = (() => {
             process.env.FINCH_TOOLS = prev;
     }
 })();
-const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://befitting-porcupine-276.convex.site";
+const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://valuable-fish-533.convex.site";
 const PKG_VERSION = (() => {
     try {
         const raw = fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8");
@@ -896,7 +896,7 @@ async function doctorFlow() {
         checks.push({
             name: "Backend reachable", status: "✗",
             detail: `${CONVEX_SITE} → ${err.message}`,
-            fix: `Network issue or wrong URL. Default: https://befitting-porcupine-276.convex.site`,
+            fix: `Network issue or wrong URL. Default: https://valuable-fish-533.convex.site`,
         });
     }
     // 3. Auth state

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,81 @@
+"use strict";
+const config_js_1 = require("./config.js");
+const convex_js_1 = require("./convex.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 - never throws on auth; when a token is configured
+// it makes ONE cheap authed call (/memory/profile) and reports the REAL
+// auth state instead of a fake-healthy dashboard (the old Promise.allSettled
+// version swallowed 401s and showed empty-but-healthy, which hid expired
+// credentials entirely).
+exports.handleFinchStatus = async function handleFinchStatus() {
+    const pkg = require("./../package.json");
+    let tokenSet = false;
+    let authState = "none";
+    let authDetail = "";
+    try {
+        tokenSet = Boolean((0, config_js_1.getSavedToken)());
+    } catch { tokenSet = false; }
+    if (tokenSet) {
+        try {
+            const data = await (0, convex_js_1.callConvex)("/memory/profile", "GET", undefined, "finch_status", 8000, true);
+            authState = (data?.status === "ok") ? "valid" : "rejected";
+            if (authState === "rejected") authDetail = "the session token was rejected by the backend - re-copy it from app.finchagentic.com";
+        } catch (err) {
+            const msg = String(err?.message ?? err);
+            if (msg.includes("Authentication required")) {
+                authState = "invalid";
+                authDetail = "the backend rejected the token as expired or invalid - re-copy it from app.finchagentic.com";
+            } else {
+                authState = "unreachable";
+                authDetail = msg.slice(0, 120);
+            }
+        }
+    }
+    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 && authState === "valid"
+        ? [
+            "**Finch MCP v" + pkg.version + "** - runtime layer for agentic AI", "",
+            "- Session token: \u2705 valid (verified against the backend)",
+            "- 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).",
+        ]
+        : tokenSet
+        ? [
+            "**Finch MCP v" + pkg.version + "** - runtime layer for agentic AI", "",
+            `- Session token: \u26a0\ufe0f configured but **${authState}**`,
+            authDetail ? `- ${authDetail}` : "",
+            "- Tools are registered, but every backend-backed call will fail until the token is replaced.",
+            "",
+            "**Fix:** re-copy a fresh token from app.finchagentic.com, update FINCH_SESSION_TOKEN in your MCP config, restart the client.",
+        ]
+        : [
+            "**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/index.js

@@ -54,7 +54,7 @@ const PKG_VERSION = (() => {
         return "unknown";
     }
 })();
-const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://befitting-porcupine-276.convex.site";
+const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://valuable-fish-533.convex.site";
 // ── ANSI helpers ──────────────────────────────────────────────────────────────
 const C = {
     cyan: "\x1b[36m",

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");
@@ -130,7 +132,8 @@ exports.ALL_TOOLS = [
     ...rh_orders_js_1.RH_ORDER_TOOLS, // 5 - rh_dca_create, rh_bracket_create, rh_orders_list, rh_order_cancel, rh_orders_tick (RH automated DCA/TP/SL)
     ...rh_bridge_js_1.BRIDGE_TOOLS, // 1 - rh_stock_bridge (tokenized stock vs real equity)
     ...memory_js_1.MEMORY_TOOLS, // 9 - memory_add, memory_search, memory_context, memory_profile, memory_list, memory_delete, memory_insight, memory_extract, memory_consolidate. memory_publish removed - promised a "Memory Marketplace" that doesn't exist at any layer (no browse route, no query, no UI), see tools/memory.ts
-    ...os_js_1.OS_TOOLS, // 3 - finch_status, finch_diagnostics, finch_shell_chat
+    ...os_js_1.OS_TOOLS.filter((t) => t.name !== "finch_status"), // finch_status lives in finch-status.js (dedup)
+    // 2 - finch_diagnostics, finch_shell_chat
     ...research_js_1.RESEARCH_TOOLS, // 2 - web_scrape, web_search
     ...deep_research_js_1.DEEP_RESEARCH_TOOLS, // 1 - deep_research (search → scrape → rank → cited evidence pack; caller synthesises)
     ...research_compare_js_1.RESEARCH_COMPARE_TOOLS, // 1 - research_compare (diff two reports across time)
@@ -215,7 +218,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 +289,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/dist/tools/miroshark.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIROSHARK_TOOLS = void 0;
 exports.handleMirosharkTool = handleMirosharkTool;
 const config_js_1 = require("../config.js");
-const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://befitting-porcupine-276.convex.site";
+const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://valuable-fish-533.convex.site";
 exports.MIROSHARK_TOOLS = [
     {
         name: "miroshark_simulate",

package/dist/tools/os.js

@@ -7,7 +7,7 @@ const token_gate_js_1 = require("../token-gate.js");
 const wallet_js_1 = require("../wallet.js");
 const local_memory_js_1 = require("../local-memory.js");
 const config_js_1 = require("../config.js");
-const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://befitting-porcupine-276.convex.site";
+const CONVEX_SITE = process.env.FINCH_CONVEX_URL ?? "https://valuable-fish-533.convex.site";
 exports.OS_TOOLS = [
     {
         name: "finch_status",
@@ -114,7 +114,7 @@ async function handleOsTool(name, args) {
             return { content: [{ type: "text", text: lines.join("\n") }] };
         }
         case "finch_diagnostics": {
-            const CONVEX_URL = process.env.FINCH_CONVEX_URL ?? "https://befitting-porcupine-276.convex.site";
+            const CONVEX_URL = process.env.FINCH_CONVEX_URL ?? "https://valuable-fish-533.convex.site";
             // Ping root of each service — any non-5xx means the host is up
             const FC_URL = "https://api.firecrawl.dev";
             const SM_URL = "https://api.supermemory.ai";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finchagentic/mcp",
-  "version": "4.6.5",
+  "version": "4.7.1",
   "description": "The runtime layer for Agentic AI. Persistent memory, autonomous agents, and workflows that survive every session.",
   "main": "dist/index.js",
   "bin": {
@@ -48,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",