@unfragile/mcp-server 0.1.0 → 0.2.0

package/dist/index.js

@@ -7,12 +7,14 @@
 // the graph learns from every interaction.
 //
 // Tools:
-//   search         — Find AI tools by intent/query
+//   search         — Find AI tools by intent/query (with Match Proof)
 //   find_mcps      — Discover MCP servers by capability need
 //   get_artifact   — Get full details + capabilities for an artifact
 //   compare        — Compare two artifacts side-by-side
 //   find_stack     — Assemble a complete harness stack for a use case
 //   feedback       — Report success/failure to close the learning loop
+//   subscribe      — Set up persistent watch for new tools
+//   unsubscribe    — Cancel a persistent watch
 // ─────────────────────────────────────────────────────────────
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -33,9 +35,9 @@ async function searchAPI(query, options = {}) {
     if (API_KEY)
         headers["X-API-Key"] = API_KEY;
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 10_000);
+    const timeout = setTimeout(() => controller.abort(), 15_000);
     try {
-        const res = await fetch(`${API_BASE}/api/v1/search?${params}`, {
+        const res = await fetch(`${API_BASE}/api/v1/search?${params}&proof=true`, {
             headers,
             signal: controller.signal,
         });
@@ -54,11 +56,35 @@ async function searchAPI(query, options = {}) {
     }
 }
 // ─── Formatters ──────────────────────────────────────────────
+/** Extract a readable name from a URL when artifact.name is a raw URL */
+function cleanName(name, url) {
+    if (!name || /^https?:\/\//.test(name)) {
+        // Try to derive name from URL path
+        try {
+            const u = new URL(url || name);
+            const parts = u.pathname.split("/").filter(Boolean);
+            // GitHub: owner/repo → repo
+            if (u.hostname === "github.com" && parts.length >= 2) {
+                return parts[1].replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+            }
+            // npm/PyPI: package name
+            if (parts.length > 0) {
+                const last = parts[parts.length - 1];
+                return last.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+            }
+        }
+        catch { }
+        // Fallback: strip protocol and trailing slash
+        return name.replace(/^https?:\/\//, "").replace(/\/$/, "");
+    }
+    return name;
+}
 function formatMatch(m, rank) {
     const lines = [];
+    const name = cleanName(m.artifact.name, m.artifact.url);
     const verified = m.artifact.verified ? " ✓" : "";
     const pricing = m.artifact.pricing.free ? "Free" : m.artifact.pricing.model;
-    lines.push(`### ${rank}. ${m.artifact.name}${verified}`);
+    lines.push(`### ${rank}. ${name}${verified}`);
     lines.push(`**Type:** ${m.artifact.type} | **Score:** ${m.compositeScore}/100 | **Rank:** ${m.artifact.unfragileRank}/100 | **Pricing:** ${pricing}`);
     lines.push(`**URL:** ${m.artifact.url}`);
     if (m.artifact.description)
@@ -75,7 +101,15 @@ function formatMatch(m, rank) {
                 lines.push(`  Limitations: ${cap.limitations.join(", ")}`);
         }
     }
-    if (m.matchGraph.timesMatched > 0) {
+    if (m.matchProof) {
+        lines.push(`\n**Match Proof:**`);
+        lines.push(`  ${m.matchProof.reasoning}`);
+        lines.push(`  Confidence: ${m.matchProof.confidence.score}/100 (${m.matchProof.confidence.topDimension})`);
+        if (m.matchProof.evidence.timesMatched > 0) {
+            lines.push(`  Evidence: ${m.matchProof.evidence.timesMatched} matches, ${Math.round(m.matchProof.evidence.successRate * 100)}% success`);
+        }
+    }
+    else if (m.matchGraph.timesMatched > 0) {
         lines.push(`\n**Graph Signal:** Matched ${m.matchGraph.timesMatched} times | ${Math.round(m.matchGraph.successRate * 100)}% success`);
     }
     lines.push(`\n→ Details: ${m.artifact.pageUrl}`);
@@ -104,7 +138,7 @@ function formatResults(data) {
 // ─── MCP Server ──────────────────────────────────────────────
 const server = new McpServer({
     name: "unfragile",
-    version: "0.1.0",
+    version: "0.2.0",
 });
 // Tool 1: General search
 server.tool("search", "Search the Unfragile match graph for AI tools, frameworks, APIs, MCP servers, agents, and more. Returns ranked results with capability matches and graph signals. Every query feeds the graph.", {
@@ -150,7 +184,8 @@ server.tool("get_artifact", "Get full details and capabilities for a specific AI
             return { content: [{ type: "text", text: `No artifact found matching "${name}".` }] };
         }
         const lines = [];
-        lines.push(`# ${match.artifact.name}`);
+        const artName = cleanName(match.artifact.name, match.artifact.url);
+        lines.push(`# ${artName}`);
         lines.push(`**Type:** ${match.artifact.type} | **UnfragileRank:** ${match.artifact.unfragileRank}/100`);
         lines.push(`**URL:** ${match.artifact.url}`);
         lines.push(`**Verified:** ${match.artifact.verified ? "Yes ✓" : "No"}`);
@@ -200,10 +235,12 @@ server.tool("compare", "Compare two AI artifacts side-by-side. Shows capabilitie
         if (!matchA && !matchB) {
             return { content: [{ type: "text", text: `Neither "${artifact_a}" nor "${artifact_b}" found.` }] };
         }
+        const nameA = matchA ? cleanName(matchA.artifact.name, matchA.artifact.url) : artifact_a;
+        const nameB = matchB ? cleanName(matchB.artifact.name, matchB.artifact.url) : artifact_b;
         const lines = [];
-        lines.push(`# Compare: ${matchA?.artifact.name || artifact_a} vs ${matchB?.artifact.name || artifact_b}\n`);
+        lines.push(`# Compare: ${nameA} vs ${nameB}\n`);
         const row = (label, a, b) => `| ${label} | ${a} | ${b} |`;
-        lines.push(`| | ${matchA?.artifact.name || "Not found"} | ${matchB?.artifact.name || "Not found"} |`);
+        lines.push(`| | ${nameA} | ${nameB} |`);
         lines.push(`|---|---|---|`);
         if (matchA && matchB) {
             lines.push(row("Type", matchA.artifact.type, matchB.artifact.type));
@@ -212,11 +249,11 @@ server.tool("compare", "Compare two AI artifacts side-by-side. Shows capabilitie
             lines.push(row("Verified", matchA.artifact.verified ? "✓" : "No", matchB.artifact.verified ? "✓" : "No"));
             lines.push(row("Times Matched", String(matchA.matchGraph.timesMatched), String(matchB.matchGraph.timesMatched)));
             lines.push(row("Capabilities", String(matchA.capabilities.length), String(matchB.capabilities.length)));
-            lines.push(`\n## ${matchA.artifact.name} Capabilities`);
+            lines.push(`\n## ${nameA} Capabilities`);
             for (const cap of matchA.capabilities) {
                 lines.push(`- **${cap.name}**: ${cap.description.slice(0, 150)}`);
             }
-            lines.push(`\n## ${matchB.artifact.name} Capabilities`);
+            lines.push(`\n## ${nameB} Capabilities`);
             for (const cap of matchB.capabilities) {
                 lines.push(`- **${cap.name}**: ${cap.description.slice(0, 150)}`);
             }
@@ -275,9 +312,10 @@ server.tool("find_stack", "Assemble a complete AI harness stack for a use case.
             totalTools += matches.length;
             lines.push(`## ${layer}\n`);
             for (const m of matches) {
+                const mName = cleanName(m.artifact.name, m.artifact.url);
                 const verified = m.artifact.verified ? " ✓" : "";
                 const pricing = m.artifact.pricing.free ? "Free" : m.artifact.pricing.model;
-                lines.push(`**${m.artifact.name}${verified}** — ${pricing} | Rank: ${m.artifact.unfragileRank}/100`);
+                lines.push(`**${mName}${verified}** — ${pricing} | Rank: ${m.artifact.unfragileRank}/100`);
                 if (m.artifact.description)
                     lines.push(`${m.artifact.description.slice(0, 200)}`);
                 if (m.capabilities.length > 0) {
@@ -348,6 +386,106 @@ server.tool("feedback", "Report whether a recommended tool worked or not. This c
         return { content: [{ type: "text", text: `Error sending feedback: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
     }
 });
+// Tool 7: Subscribe — create a monitor
+server.tool("subscribe", "Set up a persistent watch for new AI tools matching a query. Get notified daily when something new appears in the Unfragile graph. Requires at least one notification channel (email or webhook).", {
+    query: z.string().min(2).max(500).describe("What to watch for (e.g., 'new MCP server for Postgres', 'framework for building AI agents')"),
+    type: z.enum(["agent", "api", "app", "benchmark", "cli", "dataset", "extension", "finetune", "framework", "mcp", "model", "platform", "product", "prompt", "repo", "skill", "template", "webapp", "workflow"]).optional().describe("Only watch for this artifact type"),
+    email: z.string().email().optional().describe("Email address for notifications"),
+    webhook: z.string().url().optional().describe("Webhook URL for notifications (receives POST with new matches)"),
+}, async ({ query, type, email, webhook }) => {
+    log("subscribe", query);
+    if (!email && !webhook) {
+        return {
+            content: [{ type: "text", text: "Error: At least one notification channel required. Provide 'email' and/or 'webhook'." }],
+            isError: true,
+        };
+    }
+    try {
+        const headers = { "Content-Type": "application/json" };
+        if (API_KEY)
+            headers["X-API-Key"] = API_KEY;
+        const body = {
+            query,
+            notify: { email, webhook },
+            source: SOURCE,
+        };
+        if (type)
+            body.type = type;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 15_000);
+        try {
+            const res = await fetch(`${API_BASE}/api/v1/monitor`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            const data = await res.json();
+            if (!res.ok) {
+                throw new Error(data.error || `API error ${res.status}`);
+            }
+            const lines = [];
+            lines.push(`# Monitor Created`);
+            lines.push(`**ID:** ${data.id}`);
+            lines.push(`**Watching for:** ${data.query}`);
+            if (data.typeFilter)
+                lines.push(`**Type filter:** ${data.typeFilter}`);
+            lines.push(`**Frequency:** Daily`);
+            if (email)
+                lines.push(`**Email alerts:** ${email}`);
+            if (webhook)
+                lines.push(`**Webhook:** ${webhook}`);
+            lines.push(`**Expires:** ${data.expiresAt.slice(0, 10)} (90 days)`);
+            lines.push(`\n_Save the monitor ID to unsubscribe later._`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error creating monitor: ${err instanceof Error ? err.message : String(err)}` }],
+            isError: true,
+        };
+    }
+});
+// Tool 8: Unsubscribe — delete a monitor
+server.tool("unsubscribe", "Cancel a persistent watch (monitor). Use the monitor ID returned from subscribe.", {
+    monitorId: z.string().min(1).describe("Monitor ID from subscribe (e.g., 'mon_...')"),
+}, async ({ monitorId }) => {
+    log("unsubscribe", monitorId);
+    try {
+        const headers = {};
+        if (API_KEY)
+            headers["X-API-Key"] = API_KEY;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 15_000);
+        try {
+            const res = await fetch(`${API_BASE}/api/v1/monitor?id=${encodeURIComponent(monitorId)}`, {
+                method: "DELETE",
+                headers,
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const data = await res.json();
+                throw new Error(data.error || `API error ${res.status}`);
+            }
+            return {
+                content: [{ type: "text", text: `Monitor ${monitorId} cancelled. You will no longer receive alerts for this watch.` }],
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error cancelling monitor: ${err instanceof Error ? err.message : String(err)}` }],
+            isError: true,
+        };
+    }
+});
 // ─── Start ───────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unfragile/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Unfragile MCP Server — query the match graph for AI from any agent. Find AI tools, assemble harness stacks, compare artifacts.",
   "keywords": [
     "mcp",