@luthersystems/agentsearch 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luther Systems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @luthersystems/agentsearch
+
+Model Context Protocol server for [AgentSearch](https://agentsearch.luthersystems.com).
+
+Lets any MCP-compatible client (Claude Desktop, Claude Code, Cursor, …) search a
+daily-scored, curated index of AI agents and MCP servers — ranked by
+reachability, usability, functionality, and per-query relevance.
+
+## Install & run
+
+```bash
+npx -y @luthersystems/agentsearch
+```
+
+## Add to your MCP client
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` (or the
+equivalent location for your client):
+
+```json
+{
+  "mcpServers": {
+    "agentsearch": { "command": "npx", "args": ["-y", "@luthersystems/agentsearch"] }
+  }
+}
+```
+
+## Tools exposed
+
+| Tool | Description |
+|---|---|
+| `search` | Ranked agents for a natural-language query (final_score = query_fit × agent_quality) |
+| `agent_details` | Full scored profile of one indexed agent |
+| `found_agent` | Live-score any arbitrary agent URL using the same rubric |
+| `browse` | Paginated list of every indexed agent, ranked by overall quality |
+| `stats` | Index-level summary stats |
+
+## Configuration
+
+| Env var | Default | Purpose |
+|---|---|---|
+| `AGENTSEARCH_BASE_URL` | `https://agentsearch.luthersystems.com` | Override to point at a self-hosted instance |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+// AgentSearch MCP server.
+// Speaks the Model Context Protocol over stdio and proxies tool calls to the
+// public AgentSearch HTTP endpoints at https://agentsearch.luthersystems.com.
+//
+// Add to any MCP-compatible client (Claude Desktop, Claude Code, Cursor, …):
+//
+//   {
+//     "mcpServers": {
+//       "agentsearch": { "command": "npx", "args": ["-y", "@luthersystems/agentsearch"] }
+//     }
+//   }
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const BASE_URL = process.env.AGENTSEARCH_BASE_URL || "https://agentsearch.luthersystems.com";
+const USER_AGENT = "agentsearch-mcp/0.1.0";
+// ── Tool definitions ────────────────────────────────────────────────────────
+const TOOLS = [
+    {
+        name: "search",
+        description: "Search the AgentSearch index for AI agents and MCP servers matching a natural-language query. " +
+            "Results are ranked by final_score = query_fit × agent_quality. " +
+            "Use this when the user asks 'find me an agent that does X' or 'what MCP server can Y'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Natural-language description of what the agent should do." },
+                limit: { type: "integer", minimum: 1, maximum: 25, default: 10 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "agent_details",
+        description: "Get the full scored profile for one indexed agent (by name). Returns inventory data, layer scores " +
+            "(Fame / Usability / Functionality / Call Graph), reasoning, and live blocker status.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Exact agent name as it appears in the index." },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "found_agent",
+        description: "Live-score an arbitrary agent URL that may or may not be in the index. Crawls the URL, runs the " +
+            "viability + probe gates, then scores Fame / Usability / Functionality via the same rubric prompts " +
+            "the batch pipeline uses. Useful when the user mentions an agent you can't find in `search`.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "Primary URL of the agent (homepage, GitHub repo, A2A card, …)." },
+                name: { type: "string", description: "Display name (optional — defaults to the URL)." },
+                query: { type: "string", description: "Optional user query, used for the search-match judge." },
+            },
+            required: ["url"],
+        },
+    },
+    {
+        name: "browse",
+        description: "Paginated list of every indexed agent, ranked by overall quality. Use to skim the top of the index " +
+            "or to explore systematically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: { type: "integer", minimum: 1, default: 1 },
+                page_size: { type: "integer", minimum: 1, maximum: 200, default: 100 },
+            },
+        },
+    },
+    {
+        name: "stats",
+        description: "Index-level statistics: total agents, source breakdown, license breakdown, top capability clusters, " +
+            "and how many agents are reachable right now.",
+        inputSchema: { type: "object", properties: {} },
+    },
+];
+// ── HTTP helpers ────────────────────────────────────────────────────────────
+async function postJson(path, body) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        method: "POST",
+        headers: { "content-type": "application/json", "user-agent": USER_AGENT },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new Error(`${path} → HTTP ${res.status}`);
+    return res.json();
+}
+async function getJson(path) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        headers: { accept: "application/json", "user-agent": USER_AGENT },
+    });
+    if (!res.ok)
+        throw new Error(`${path} → HTTP ${res.status}`);
+    return res.json();
+}
+// ── Tool dispatch ───────────────────────────────────────────────────────────
+async function callTool(name, args) {
+    switch (name) {
+        case "search": {
+            const { query, limit } = args;
+            const data = await postJson("/api/search", { query, limit });
+            return { query, results: (data.results ?? []).slice(0, limit ?? 10) };
+        }
+        case "agent_details": {
+            const { name: agentName } = args;
+            return getJson(`/api/agent/${encodeURIComponent(agentName)}`);
+        }
+        case "found_agent": {
+            const { url, name: agentName, query } = args;
+            return postJson("/api/found-agent", { url, name: agentName, query });
+        }
+        case "browse": {
+            const { page = 1, page_size = 100 } = args;
+            return getJson(`/api/browse?page=${page}&page_size=${page_size}`);
+        }
+        case "stats": {
+            return getJson("/api/stats");
+        }
+        default:
+            throw new Error(`unknown tool: ${name}`);
+    }
+}
+// ── Server bootstrap ────────────────────────────────────────────────────────
+const server = new Server({ name: "agentsearch", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args = {} } = req.params;
+    try {
+        const result = await callTool(name, args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            isError: true,
+            content: [{ type: "text", text: `agentsearch error: ${msg}` }],
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+// Stderr is reserved for human-readable diagnostics in MCP; never log to stdout.
+console.error(`[agentsearch-mcp] connected · proxying to ${BASE_URL}`);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@luthersystems/agentsearch",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for AgentSearch — find AI agents and MCP servers ranked by reachability, usability and quality.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "agentsearch-mcp": "dist/index.js"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "agent-discovery",
+    "agent-search",
+    "a2a",
+    "ai-agents"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/luthersystems/agentsearch.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://agentsearch.luthersystems.com"
+}