@unclick/mcp-server 0.2.5 → 0.3.1

package/dist/web-tools.js

@@ -0,0 +1,271 @@
+/**
+ * Built-in web tools for UnClick MCP: web_search, web_scrape, search_docs.
+ *
+ * These back up UnClick's "you can remove Exa/Tavily/Firecrawl/context7" nudge
+ * by giving it real first-party implementations. All three proxy to third-party
+ * APIs configured via Vercel env vars:
+ *
+ *   - TAVILY_API_KEY    (preferred for search + extract)
+ *   - EXA_API_KEY       (fallback for search)
+ *   - BRAVE_SEARCH_API_KEY (fallback for search)
+ *   - FIRECRAWL_API_KEY (preferred for scrape; Tavily extract is fallback)
+ *
+ * When none are configured, the tools return a friendly message pointing users
+ * at settings. context7 (search_docs) is free and needs no key.
+ */
+import { getBackend } from "./memory/db.js";
+async function safeJson(res) {
+    try {
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Fact auto-save helper ─────────────────────────────────────────────────
+async function saveFactSafely(fact, category, confidence = 0.5) {
+    try {
+        const db = await getBackend();
+        await db.addFact({ fact, category, confidence });
+    }
+    catch {
+        // Never let memory errors break the tool call.
+    }
+}
+function truncate(s, n) {
+    return s.length > n ? s.slice(0, n - 1) + "\u2026" : s;
+}
+async function searchTavily(query, limit, topic, apiKey) {
+    const res = await fetch("https://api.tavily.com/search", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            api_key: apiKey,
+            query,
+            max_results: limit,
+            topic: topic === "news" ? "news" : "general",
+            include_answer: false,
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`Tavily search failed: HTTP ${res.status}`);
+    const data = (await safeJson(res));
+    return (data?.results ?? []).map((r) => ({
+        title: r.title,
+        url: r.url,
+        snippet: truncate(r.content ?? "", 400),
+        score: r.score,
+    }));
+}
+async function searchExa(query, limit, apiKey) {
+    const res = await fetch("https://api.exa.ai/search", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+        },
+        body: JSON.stringify({ query, numResults: limit, contents: { text: true } }),
+    });
+    if (!res.ok)
+        throw new Error(`Exa search failed: HTTP ${res.status}`);
+    const data = (await safeJson(res));
+    return (data?.results ?? []).map((r) => ({
+        title: r.title ?? r.url,
+        url: r.url,
+        snippet: truncate(r.text ?? "", 400),
+        score: r.score,
+    }));
+}
+async function searchBrave(query, limit, apiKey) {
+    const url = new URL("https://api.search.brave.com/res/v1/web/search");
+    url.searchParams.set("q", query);
+    url.searchParams.set("count", String(limit));
+    const res = await fetch(url.toString(), {
+        headers: {
+            Accept: "application/json",
+            "X-Subscription-Token": apiKey,
+        },
+    });
+    if (!res.ok)
+        throw new Error(`Brave search failed: HTTP ${res.status}`);
+    const data = (await safeJson(res));
+    return (data?.web?.results ?? []).map((r) => ({
+        title: r.title,
+        url: r.url,
+        snippet: truncate(r.description ?? "", 400),
+    }));
+}
+export async function webSearch(args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        return { error: "query is required" };
+    const limit = Math.min(Math.max(Number(args.limit) || 5, 1), 10);
+    const topic = String(args.topic ?? "general");
+    const tavilyKey = process.env.TAVILY_API_KEY;
+    const exaKey = process.env.EXA_API_KEY;
+    const braveKey = process.env.BRAVE_SEARCH_API_KEY;
+    let results = [];
+    let provider = "";
+    try {
+        if (tavilyKey) {
+            results = await searchTavily(query, limit, topic, tavilyKey);
+            provider = "tavily";
+        }
+        else if (exaKey) {
+            results = await searchExa(query, limit, exaKey);
+            provider = "exa";
+        }
+        else if (braveKey) {
+            results = await searchBrave(query, limit, braveKey);
+            provider = "brave";
+        }
+        else {
+            return {
+                error: "Web search is not configured. Ask your admin to add a search API key (TAVILY_API_KEY, EXA_API_KEY, or BRAVE_SEARCH_API_KEY) in settings.",
+            };
+        }
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+    // Low-confidence fact so decay handles noise. The brief favors saving on scrape,
+    // but the "UnClick remembers your searches" promise needs something in the log.
+    let remembered;
+    if (results.length > 0 && query.length >= 4) {
+        const top = results[0];
+        const factText = `Searched for "${query}" on ${new Date().toISOString().slice(0, 10)}. Top result: ${top.title} (${top.url})`;
+        void saveFactSafely(factText, "search", 0.5);
+        remembered = factText;
+    }
+    return { query, results, provider, remembered };
+}
+async function scrapeFirecrawl(url, format, apiKey) {
+    const fcFormat = format === "html" ? "html" : "markdown";
+    const res = await fetch("https://api.firecrawl.dev/v1/scrape", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({ url, formats: [fcFormat] }),
+    });
+    if (!res.ok)
+        throw new Error(`Firecrawl scrape failed: HTTP ${res.status}`);
+    const data = (await safeJson(res));
+    const raw = format === "html" ? data?.data?.html : data?.data?.markdown;
+    return { content: raw ?? "", title: data?.data?.metadata?.title };
+}
+async function scrapeTavily(url, apiKey) {
+    const res = await fetch("https://api.tavily.com/extract", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ api_key: apiKey, urls: [url] }),
+    });
+    if (!res.ok)
+        throw new Error(`Tavily extract failed: HTTP ${res.status}`);
+    const data = (await safeJson(res));
+    const first = data?.results?.[0];
+    return { content: first?.raw_content ?? "" };
+}
+function markdownToText(md) {
+    return md
+        .replace(/```[\s\S]*?```/g, "")
+        .replace(/\[(.*?)\]\(.*?\)/g, "$1")
+        .replace(/[*_`#>]/g, "")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+export async function webScrape(args) {
+    const url = String(args.url ?? "").trim();
+    if (!url)
+        return { error: "url is required" };
+    const formatInput = String(args.format ?? "markdown");
+    const format = formatInput === "text" || formatInput === "html" ? formatInput : "markdown";
+    const firecrawlKey = process.env.FIRECRAWL_API_KEY;
+    const tavilyKey = process.env.TAVILY_API_KEY;
+    try {
+        let content = "";
+        let title;
+        let provider = "";
+        if (firecrawlKey) {
+            const r = await scrapeFirecrawl(url, format, firecrawlKey);
+            content = r.content;
+            title = r.title;
+            provider = "firecrawl";
+        }
+        else if (tavilyKey) {
+            const r = await scrapeTavily(url, tavilyKey);
+            content = r.content;
+            provider = "tavily";
+        }
+        else {
+            return {
+                error: "Web scrape is not configured. Ask your admin to add FIRECRAWL_API_KEY or TAVILY_API_KEY in settings.",
+            };
+        }
+        if (format === "text") {
+            content = markdownToText(content);
+        }
+        const factText = `Read ${title ?? url} on ${new Date().toISOString().slice(0, 10)} via web_scrape.`;
+        void saveFactSafely(factText, "reference", 0.6);
+        return { url, format, title, content, provider };
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+}
+async function context7JsonRpc(method, params) {
+    const res = await fetch("https://mcp.context7.com/mcp", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json, text/event-stream",
+        },
+        body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "tools/call",
+            params: { name: method, arguments: params },
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`context7 failed: HTTP ${res.status}`);
+    const data = (await safeJson(res));
+    const text = data?.result?.content?.find((c) => c.type === "text")?.text ?? "";
+    return text;
+}
+export async function searchDocs(args) {
+    const library = String(args.library ?? "").trim();
+    if (!library)
+        return { error: "library is required" };
+    const topic = args.topic ? String(args.topic) : undefined;
+    const maxTokens = Math.min(Math.max(Number(args.max_tokens) || 5000, 500), 20000);
+    try {
+        const libraryId = await context7JsonRpc("resolve-library-id", {
+            libraryName: library,
+        });
+        // resolve-library-id returns a human-readable list; extract first `/org/project`
+        const match = libraryId.match(/\/[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+/);
+        const resolvedId = match ? match[0] : library;
+        const docs = await context7JsonRpc("get-library-docs", {
+            context7CompatibleLibraryID: resolvedId,
+            tokens: maxTokens,
+            topic,
+        });
+        const factText = topic
+            ? `Looked up ${library} docs on "${topic}" via search_docs.`
+            : `Looked up ${library} documentation via search_docs.`;
+        void saveFactSafely(factText, "technical", 0.7);
+        return {
+            library,
+            library_id: resolvedId,
+            topic,
+            content: docs,
+            provider: "context7",
+        };
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+}
+//# sourceMappingURL=web-tools.js.map

package/dist/web-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-tools.js","sourceRoot":"","sources":["../src/web-tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,65 +1,69 @@
-{
-  "name": "@unclick/mcp-server",
-  "version": "0.2.5",
-  "mcpName": "io.github.malamutemayhem/unclick-mcp-server",
-  "description": "MCP server for the UnClick tool marketplace — lets AI agents discover and use every UnClick tool",
-  "type": "module",
-  "bin": {
-    "unclick-mcp": "./dist/index.js"
-  },
-  "main": "./dist/server.js",
-  "exports": {
-    ".": "./dist/server.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "logo.png",
-    "public",
-    "server.json"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@iarna/toml": "^2.2.5",
-    "@modelcontextprotocol/sdk": "^1.15.1",
-    "@types/imap": "^0.8.43",
-    "@types/nodemailer": "^8.0.0",
-    "csv-parse": "^6.2.1",
-    "csv-stringify": "^6.7.0",
-    "fast-xml-parser": "^5.5.10",
-    "imap": "^0.8.19",
-    "js-yaml": "^4.1.1",
-    "marked": "^17.0.6",
-    "nodemailer": "^8.0.5",
-    "turndown": "^7.2.4",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.0.0",
-    "@types/turndown": "^5.0.6",
-    "tsx": "^4.19.2",
-    "typescript": "^5.8.3"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "unclick",
-    "ai",
-    "tools",
-    "utilities"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/malamutemayhem/unclick-agent-native-endpoints"
-  }
-}
+{
+  "name": "@unclick/mcp-server",
+  "version": "0.3.1",
+  "mcpName": "io.github.malamutemayhem/unclick-mcp-server",
+  "description": "MCP server for the UnClick tool marketplace — lets AI agents discover and use every UnClick tool",
+  "type": "module",
+  "bin": {
+    "unclick-mcp": "./dist/index.js"
+  },
+  "main": "./dist/server.js",
+  "exports": {
+    ".": "./dist/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "logo.png",
+    "public",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "tsx --test src/memory/__tests__/hybrid-search.test.ts src/memory/__tests__/bitemporal.test.ts && vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "@modelcontextprotocol/sdk": "^1.15.1",
+    "@supabase/supabase-js": "^2.103.0",
+    "@types/imap": "^0.8.43",
+    "@types/nodemailer": "^8.0.0",
+    "csv-parse": "^6.2.1",
+    "csv-stringify": "^6.7.0",
+    "fast-xml-parser": "^5.5.10",
+    "imap": "^0.8.19",
+    "js-yaml": "^4.1.1",
+    "marked": "^17.0.6",
+    "nodemailer": "^8.0.5",
+    "turndown": "^7.2.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.6.0",
+    "@types/turndown": "^5.0.6",
+    "@unclick/wizard": "*",
+    "tsx": "^4.19.2",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unclick",
+    "ai",
+    "tools",
+    "utilities"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/malamutemayhem/unclick-agent-native-endpoints"
+  }
+}

package/public/icon.svg

@@ -1,15 +1,15 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
-  <!-- Dark rounded square background -->
-  <rect width="512" height="512" rx="61" fill="#0a0a0a"/>
-  <!-- White "U" lettermark — geometric, bold, well-centred -->
-  <text
-    x="256"
-    y="345"
-    font-family="Arial Black, Arial, Helvetica, sans-serif"
-    font-size="310"
-    font-weight="900"
-    text-anchor="middle"
-    fill="#ffffff"
-    letter-spacing="-8"
-  >U</text>
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
+  <!-- Dark rounded square background -->
+  <rect width="512" height="512" rx="61" fill="#0a0a0a"/>
+  <!-- White "U" lettermark — geometric, bold, well-centred -->
+  <text
+    x="256"
+    y="345"
+    font-family="Arial Black, Arial, Helvetica, sans-serif"
+    font-size="310"
+    font-weight="900"
+    text-anchor="middle"
+    fill="#ffffff"
+    letter-spacing="-8"
+  >U</text>
+</svg>

package/server.json

@@ -1,37 +1,37 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.malamutemayhem/unclick-mcp-server",
-  "title": "UnClick",
-  "description": "AI agent tool marketplace. 139+ tools for social, e-commerce, accounting, and messaging.",
-  "version": "0.2.4",
-  "repository": {
-    "url": "https://github.com/malamutemayhem/unclick-agent-native-endpoints.git",
-    "source": "github"
-  },
-  "icons": [
-    {
-      "src": "https://unclick.world/icon.png",
-      "mimeType": "image/png",
-      "sizes": ["512x512"]
-    }
-  ],
-  "packages": [
-    {
-      "registryType": "npm",
-      "identifier": "@unclick/mcp-server",
-      "version": "0.2.3",
-      "runtimeHint": "npx",
-      "transport": {
-        "type": "stdio"
-      },
-      "environmentVariables": [
-        {
-          "name": "UNCLICK_API_KEY",
-          "description": "Your UnClick API key from https://unclick.world",
-          "isRequired": true,
-          "isSecret": true
-        }
-      ]
-    }
-  ]
-}
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.malamutemayhem/unclick-mcp-server",
+  "title": "UnClick",
+  "description": "AI agent tool marketplace. 172+ tools for social, e-commerce, accounting, and messaging.",
+  "version": "0.2.4",
+  "repository": {
+    "url": "https://github.com/malamutemayhem/unclick-agent-native-endpoints.git",
+    "source": "github"
+  },
+  "icons": [
+    {
+      "src": "https://unclick.world/favicon.png",
+      "mimeType": "image/png",
+      "sizes": ["512x512"]
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@unclick/mcp-server",
+      "version": "0.2.3",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "UNCLICK_API_KEY",
+          "description": "Your UnClick API key from https://unclick.world",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}