@agentage/find-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentage
+
+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,106 @@
+# @agentage/find-mcp
+
+![Your AI finds the right tool in seconds - from 12,000+](https://github.com/agentage/find-mcp/raw/master/docs/banner.svg)
+
+Give your AI a directory of 12,000+ tools. One command connects Claude, Cursor, or VS Code to
+the public [agentage MCP directory](https://catalog.agentage.io/mcp), and your AI finds the
+right tool in seconds - free, read-only, no sign-up.
+
+## What is this?
+
+AI apps like Claude and Cursor can use outside tools - for reading databases, sending email,
+searching the web, and thousands of other things - through an open standard called
+[MCP](https://modelcontextprotocol.io). The hard part is finding the right tool.
+
+This package solves that: it gives your AI a searchable directory of 12,000+ of those tools,
+so you can simply ask for what you need and let the AI find it. Nothing to install permanently,
+no account, and it can only read the directory - it never changes anything on your machine.
+
+Prefer to look around yourself? The same directory is browsable at
+[catalog.agentage.io/mcp](https://catalog.agentage.io/mcp).
+
+## Get started
+
+Add this to your AI app, then ask away.
+
+### Claude Desktop / Cursor / VS Code (`mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "find-mcp": {
+      "command": "npx",
+      "args": ["-y", "@agentage/find-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add find-mcp -- npx -y @agentage/find-mcp
+```
+
+### Then ask your AI things like
+
+- "Find me a tool that connects you to Postgres."
+- "Is there an MCP server for Notion? How do I install it?"
+- "What are the most popular tools for browser automation?"
+
+## Tools
+
+The tool set is served by the remote directory (this proxy forwards it as-is):
+
+| Tool             | What it does                                                          |
+| ---------------- | --------------------------------------------------------------------- |
+| `mcp_search`     | Find MCP servers by keyword, with category/language/license filters   |
+| `mcp_get`        | Return one server's full packages, tools, and install command by slug |
+| `mcp_categories` | List the category/language/license values you can filter on          |
+
+## How it works
+
+This is the **npm client for the agentage MCP directory** - a thin stdio proxy that bridges
+stdio-only MCP clients to the public remote endpoint `https://catalog.agentage.io/mcp`.
+
+It is intentionally **tiny**: it holds no tool logic. On start it connects to the remote
+directory over Streamable HTTP and forwards `tools/list` and `tools/call` verbatim, so upstream
+tool changes flow through without republishing this package. Forwarding is bounded by the pinned
+MCP SDK schemas, so a brand-new upstream tool field may need an SDK bump here to pass through.
+The directory is **public and read-only** - no auth, no keys, nothing installed or executed.
+
+### Remote clients don't need this package
+
+Clients that support **remote** MCP servers can point straight at the Streamable HTTP endpoint:
+
+```
+https://catalog.agentage.io/mcp
+```
+
+This package exists only to bridge **stdio-only** clients to that same endpoint.
+
+## Configuration
+
+| Env               | Default                            | Purpose                                              |
+| ----------------- | ----------------------------------- | ---------------------------------------------------- |
+| `FIND_MCP_URL`    | `https://catalog.agentage.io/mcp`  | Override the upstream endpoint (dev)                 |
+| `CATALOG_MCP_URL` | -                                   | Deprecated alias for `FIND_MCP_URL`, still accepted   |
+
+## Develop
+
+```bash
+npm install
+npm test                # vitest: in-process mock-upstream contract + forwarding tests
+LIVE_SMOKE=1 npm test   # also runs the live smoke against the real endpoint
+npm run verify          # type-check + lint + format:check + test + build
+```
+
+## Release
+
+Releases publish to npm via GitHub Actions when a `chore(release): vX.Y.Z` commit that touches
+`package.json` lands on `master` (the squash-merge subject of a release PR). The workflow skips
+any version already on npm.
+
+## License
+
+MIT - see [LICENSE](./LICENSE).

package/dist/bin/bootstrap.d.ts

@@ -0,0 +1,10 @@
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { UpstreamClient } from '../upstream.js';
+export declare const HELP: string;
+export declare const flagOutput: (argv: readonly string[]) => string | null;
+export interface Bootstrapped {
+    upstream: UpstreamClient;
+    close: () => Promise<void>;
+}
+export declare const bootstrap: (transport: Transport) => Promise<Bootstrapped>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bin/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bin/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAwB,MAAM,gBAAgB,CAAC;AAItE,eAAO,MAAM,IAAI,QAgBhB,CAAC;AAGF,eAAO,MAAM,UAAU,GAAI,MAAM,SAAS,MAAM,EAAE,KAAG,MAAM,GAAG,IAI7D,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAID,eAAO,MAAM,SAAS,GAAU,WAAW,SAAS,KAAG,OAAO,CAAC,YAAY,CAY1E,CAAC"}

package/dist/bin/bootstrap.js

@@ -0,0 +1,44 @@
+import { UpstreamClient, DEFAULT_FIND_MCP_URL } from '../upstream.js';
+import { createFindProxyServer } from '../server/create-find-proxy.js';
+import { PACKAGE_VERSION } from '../version.js';
+export const HELP = `@agentage/find-mcp v${PACKAGE_VERSION}
+
+A thin stdio MCP proxy that bridges stdio-only MCP clients (Claude Desktop,
+Cursor, VS Code) to the public agentage MCP directory at ${DEFAULT_FIND_MCP_URL}.
+It forwards tools/list and tools/call verbatim - no auth, read-only.
+
+Usage:
+  npx -y @agentage/find-mcp        Start the stdio server (default)
+  npx -y @agentage/find-mcp --help Show this help
+  npx -y @agentage/find-mcp --version
+
+Env:
+  FIND_MCP_URL      Override the upstream endpoint (default above)
+  CATALOG_MCP_URL   Deprecated alias for FIND_MCP_URL (still accepted)
+
+Docs: https://catalog.agentage.io/mcp
+`;
+// Resolve a --help/--version flag to the text to print, or null to start the server.
+export const flagOutput = (argv) => {
+    if (argv.includes('--help') || argv.includes('-h'))
+        return HELP;
+    if (argv.includes('--version') || argv.includes('-v'))
+        return `${PACKAGE_VERSION}\n`;
+    return null;
+};
+// Wire a catalog proxy server onto the given transport and report readiness to
+// stderr (stdout is the JSON-RPC wire). Returns a teardown for clean shutdown.
+export const bootstrap = async (transport) => {
+    const upstream = new UpstreamClient();
+    const server = createFindProxyServer(upstream);
+    await server.connect(transport);
+    process.stderr.write(`[find-mcp] stdio ready, proxying to ${upstream.target}\n`);
+    return {
+        upstream,
+        close: async () => {
+            await server.close();
+            await upstream.close();
+        },
+    };
+};
+//# sourceMappingURL=bootstrap.js.map

package/dist/bin/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bin/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,CAAC,MAAM,IAAI,GAAG,uBAAuB,eAAe;;;2DAGC,oBAAoB;;;;;;;;;;;;;CAa9E,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAiB,EAAE;IACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,eAAe,IAAI,CAAC;IACrF,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAOF,+EAA+E;AAC/E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,SAAoB,EAAyB,EAAE;IAC7E,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IACjF,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/bin/find-mcp.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=find-mcp.d.ts.map

package/dist/bin/find-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-mcp.d.ts","sourceRoot":"","sources":["../../src/bin/find-mcp.ts"],"names":[],"mappings":""}

package/dist/bin/find-mcp.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// @agentage/find-mcp - the stdio MCP client for the agentage MCP directory.
+// `npx @agentage/find-mcp` bridges a stdio MCP client (Claude Desktop, Cursor,
+// VS Code) to the public remote endpoint catalog.agentage.io/mcp, forwarding
+// tools/list and tools/call verbatim. No auth - the directory is public, read-only.
+//
+// stdout is the JSON-RPC wire; ALL diagnostics MUST go to stderr.
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { bootstrap, flagOutput } from './bootstrap.js';
+const main = async () => {
+    const out = flagOutput(process.argv.slice(2));
+    if (out !== null) {
+        process.stdout.write(out);
+        process.exit(0);
+    }
+    const app = await bootstrap(new StdioServerTransport());
+    // The SDK stdio transport doesn't exit when the host closes stdin, so drive a
+    // clean shutdown ourselves. Guarded so overlapping signals tear down once.
+    let closing = false;
+    const shutdown = async () => {
+        if (closing)
+            return;
+        closing = true;
+        await app.close();
+        process.exit(0);
+    };
+    process.stdin.on('end', () => void shutdown());
+    process.on('SIGINT', () => void shutdown());
+    process.on('SIGTERM', () => void shutdown());
+};
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[find-mcp] fatal: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=find-mcp.js.map

package/dist/bin/find-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-mcp.js","sourceRoot":"","sources":["../../src/bin/find-mcp.ts"],"names":[],"mappings":";AACA,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,oFAAoF;AACpF,EAAE;AACF,kEAAkE;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAExD,8EAA8E;IAC9E,2EAA2E;IAC3E,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { UpstreamClient, DEFAULT_FIND_MCP_URL, type UpstreamOptions } from './upstream.js';
+export { createFindProxyServer, SERVER_NAME, SERVER_TITLE } from './server/create-find-proxy.js';
+export { forward } from './server/forward.js';
+export { PACKAGE_VERSION } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// @agentage/find-mcp public API - a thin stdio MCP proxy to the agentage MCP directory.
+export { UpstreamClient, DEFAULT_FIND_MCP_URL } from './upstream.js';
+export { createFindProxyServer, SERVER_NAME, SERVER_TITLE } from './server/create-find-proxy.js';
+export { forward } from './server/forward.js';
+export { PACKAGE_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAwB,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/server/create-find-proxy.d.ts

@@ -0,0 +1,6 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { UpstreamClient } from '../upstream.js';
+export declare const SERVER_NAME = "find-mcp";
+export declare const SERVER_TITLE = "Find MCP \u2014 Agentage MCP Directory";
+export declare const createFindProxyServer: (upstream: UpstreamClient) => Server;
+//# sourceMappingURL=create-find-proxy.d.ts.map

package/dist/server/create-find-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-find-proxy.d.ts","sourceRoot":"","sources":["../../src/server/create-find-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,YAAY,2CAAsC,CAAC;AAQhE,eAAO,MAAM,qBAAqB,GAAI,UAAU,cAAc,KAAG,MAmBhE,CAAC"}

package/dist/server/create-find-proxy.js

@@ -0,0 +1,22 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, CallToolResultSchema, ListToolsRequestSchema, ListToolsResultSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { forward } from './forward.js';
+import { PACKAGE_VERSION } from '../version.js';
+export const SERVER_NAME = 'find-mcp';
+export const SERVER_TITLE = 'Find MCP — Agentage MCP Directory';
+const INSTRUCTIONS = 'A public directory of Model Context Protocol (MCP) servers, crawled from the official registry. Use it to discover, compare, and look up MCP servers on request ("is there an MCP for X", "which MCP server does Y"). mcp_search finds servers by keyword and filters; mcp_get returns one server\'s full packages, tools, and install command by slug; mcp_categories lists the category/language/license values you can filter on. Read-only - it never installs or runs anything. This package is a thin stdio proxy to catalog.agentage.io/mcp; the tool set is served by the remote and may evolve.';
+// A low-level MCP Server that forwards tools/list and tools/call to the remote
+// directory verbatim - tools are NOT hard-coded, so upstream changes flow through
+// without republishing this package.
+export const createFindProxyServer = (upstream) => {
+    const server = new Server({
+        name: SERVER_NAME,
+        title: SERVER_TITLE,
+        version: PACKAGE_VERSION,
+        websiteUrl: 'https://catalog.agentage.io/mcp',
+    }, { capabilities: { tools: {} }, instructions: INSTRUCTIONS });
+    server.setRequestHandler(ListToolsRequestSchema, (req) => forward(upstream, { method: 'tools/list', params: req.params }, ListToolsResultSchema));
+    server.setRequestHandler(CallToolRequestSchema, (req) => forward(upstream, { method: 'tools/call', params: req.params }, CallToolResultSchema));
+    return server;
+};
+//# sourceMappingURL=create-find-proxy.js.map

package/dist/server/create-find-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-find-proxy.js","sourceRoot":"","sources":["../../src/server/create-find-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,mCAAmC,CAAC;AAEhE,MAAM,YAAY,GAChB,0kBAA0kB,CAAC;AAE7kB,+EAA+E;AAC/E,kFAAkF;AAClF,qCAAqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAwB,EAAU,EAAE;IACxE,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,iCAAiC;KAC9C,EACD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,CAC5D,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,CAAC,GAAG,EAAE,EAAE,CACvD,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CACvF,CAAC;IACF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE,CACtD,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CACtF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/server/forward.d.ts

@@ -0,0 +1,9 @@
+import type { AnySchema, SchemaOutput } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import type { UpstreamClient } from '../upstream.js';
+interface ForwardRequest {
+    method: string;
+    params?: Record<string, unknown>;
+}
+export declare const forward: <T extends AnySchema>(upstream: UpstreamClient, request: ForwardRequest, resultSchema: T) => Promise<SchemaOutput<T>>;
+export {};
+//# sourceMappingURL=forward.d.ts.map

package/dist/server/forward.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.d.ts","sourceRoot":"","sources":["../../src/server/forward.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AA0CD,eAAO,MAAM,OAAO,GAAU,CAAC,SAAS,SAAS,EAC/C,UAAU,cAAc,EACxB,SAAS,cAAc,EACvB,cAAc,CAAC,KACd,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAazB,CAAC"}

package/dist/server/forward.js

@@ -0,0 +1,53 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { StreamableHTTPError } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+const isDisconnect = (err) => err instanceof McpError && err.code === ErrorCode.ConnectionClosed;
+// Recover an embedded JSON-RPC error ({ code, message }) from an HTTP-error body,
+// so the upstream rate-limit envelope (HTTP 429 + code -32000) passes through.
+const embeddedRpcError = (message) => {
+    const start = message.indexOf('{');
+    if (start === -1)
+        return null;
+    try {
+        const body = JSON.parse(message.slice(start));
+        const code = body.error?.code;
+        if (typeof code !== 'number')
+            return null;
+        return new McpError(code, body.error?.message ?? 'upstream error');
+    }
+    catch {
+        return null;
+    }
+};
+// Upstream JSON-RPC errors pass through verbatim; an HTTP error surfaces its
+// embedded JSON-RPC code (e.g. -32000 rate limit) or a clear InternalError.
+// Transport/unreachable errors become an InternalError - never a crash.
+const toRpcError = (err) => {
+    if (err instanceof McpError)
+        return err;
+    if (err instanceof StreamableHTTPError) {
+        return (embeddedRpcError(err.message) ??
+            new McpError(ErrorCode.InternalError, `catalog upstream error (HTTP ${err.code}): ${err.message}`));
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return new McpError(ErrorCode.InternalError, `catalog upstream unreachable: ${message}`);
+};
+// Forward one request to the upstream client and return the response verbatim.
+// A dropped connection reconnects once before giving up.
+export const forward = async (upstream, request, resultSchema) => {
+    const client = await upstream.get();
+    try {
+        return await client.request(request, resultSchema);
+    }
+    catch (err) {
+        if (!isDisconnect(err))
+            throw toRpcError(err);
+        upstream.reset(client);
+        try {
+            return await (await upstream.get()).request(request, resultSchema);
+        }
+        catch (retryErr) {
+            throw toRpcError(retryErr);
+        }
+    }
+};
+//# sourceMappingURL=forward.js.map

package/dist/server/forward.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.js","sourceRoot":"","sources":["../../src/server/forward.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AASzF,MAAM,YAAY,GAAG,CAAC,GAAY,EAAW,EAAE,CAC7C,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,gBAAgB,CAAC;AAErE,kFAAkF;AAClF,+EAA+E;AAC/E,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAmB,EAAE;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAE3C,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,gBAAgB,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,6EAA6E;AAC7E,4EAA4E;AAC5E,wEAAwE;AACxE,MAAM,UAAU,GAAG,CAAC,GAAY,EAAY,EAAE;IAC5C,IAAI,GAAG,YAAY,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;QACvC,OAAO,CACL,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;YAC7B,IAAI,QAAQ,CACV,SAAS,CAAC,aAAa,EACvB,gCAAgC,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAC5D,CACF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,iCAAiC,OAAO,EAAE,CAAC,CAAC;AAC3F,CAAC,CAAC;AAEF,+EAA+E;AAC/E,yDAAyD;AACzD,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAC1B,QAAwB,EACxB,OAAuB,EACvB,YAAe,EACW,EAAE;IAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;YAAE,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9C,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/upstream.d.ts

@@ -0,0 +1,17 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+export declare const DEFAULT_FIND_MCP_URL = "https://catalog.agentage.io/mcp";
+export interface UpstreamOptions {
+    url?: string;
+}
+export declare class UpstreamClient {
+    private client;
+    private connecting;
+    private readonly url;
+    constructor(opts?: UpstreamOptions);
+    get target(): string;
+    get(): Promise<Client>;
+    reset(client: Client): void;
+    close(): Promise<void>;
+    private connect;
+}
+//# sourceMappingURL=upstream.d.ts.map

package/dist/upstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.d.ts","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAInE,eAAO,MAAM,oBAAoB,oCAAoC,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAaD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;gBAEd,IAAI,GAAE,eAAoB;IAItC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAc5B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAYd,OAAO;CAatB"}

package/dist/upstream.js

@@ -0,0 +1,67 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { PACKAGE_VERSION } from './version.js';
+export const DEFAULT_FIND_MCP_URL = 'https://catalog.agentage.io/mcp';
+// Resolve the upstream endpoint: explicit option -> FIND_MCP_URL env -> the deprecated
+// CATALOG_MCP_URL env (still accepted) -> default.
+const resolveUrl = (opts) => new URL(opts.url ?? process.env.FIND_MCP_URL ?? process.env.CATALOG_MCP_URL ?? DEFAULT_FIND_MCP_URL);
+// A lazily-connected SDK Client to the remote catalog over Streamable HTTP. One
+// in-flight connect is shared across concurrent calls; a dropped connection is
+// reconnected on the next get(). All slot mutations are identity-guarded so a
+// concurrent reset()+reconnect never double-connects or orphans a socket.
+export class UpstreamClient {
+    client = null;
+    connecting = null;
+    url;
+    constructor(opts = {}) {
+        this.url = resolveUrl(opts);
+    }
+    get target() {
+        return this.url.href;
+    }
+    async get() {
+        if (this.client)
+            return this.client;
+        if (!this.connecting) {
+            const pending = this.connect().finally(() => {
+                // Only clear the slot this exact attempt still owns.
+                if (this.connecting === pending)
+                    this.connecting = null;
+            });
+            this.connecting = pending;
+        }
+        return this.connecting;
+    }
+    // Drop a client known to be dead so the next get() reconnects. Identity-guarded:
+    // a concurrent caller that already installed a newer client is left untouched.
+    reset(client) {
+        if (this.client === client)
+            this.client = null;
+    }
+    // Tear down the live client (if any); tolerant of a never-connected instance.
+    async close() {
+        const client = this.client;
+        this.client = null;
+        this.connecting = null;
+        if (!client)
+            return;
+        try {
+            await client.close();
+        }
+        catch {
+            // best-effort teardown - never throw on shutdown.
+        }
+    }
+    async connect() {
+        const client = new Client({ name: 'agentage-find-mcp', version: PACKAGE_VERSION }, { capabilities: {} });
+        client.onclose = () => {
+            // Forget this client only if a newer one has not replaced it.
+            if (this.client === client)
+                this.client = null;
+        };
+        await client.connect(new StreamableHTTPClientTransport(this.url));
+        this.client = client;
+        return client;
+    }
+}
+//# sourceMappingURL=upstream.js.map

package/dist/upstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.js","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,iCAAiC,CAAC;AAMtE,uFAAuF;AACvF,mDAAmD;AACnD,MAAM,UAAU,GAAG,CAAC,IAAqB,EAAO,EAAE,CAChD,IAAI,GAAG,CACL,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,oBAAoB,CAC5F,CAAC;AAEJ,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,0EAA0E;AAC1E,MAAM,OAAO,cAAc;IACjB,MAAM,GAAkB,IAAI,CAAC;IAC7B,UAAU,GAA2B,IAAI,CAAC;IACjC,GAAG,CAAM;IAE1B,YAAY,OAAwB,EAAE;QACpC,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,OAAO,GAAoB,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC3D,qDAAqD;gBACrD,IAAI,IAAI,CAAC,UAAU,KAAK,OAAO;oBAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YAC1D,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,iFAAiF;IACjF,+EAA+E;IAC/E,KAAK,CAAC,MAAc;QAClB,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACjD,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,eAAe,EAAE,EACvD,EAAE,YAAY,EAAE,EAAE,EAAE,CACrB,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;YACpB,8DAA8D;YAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACjD,CAAC,CAAC;QACF,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const PACKAGE_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe,QAAc,CAAC"}

package/dist/version.js

@@ -0,0 +1,7 @@
+import { createRequire } from 'node:module';
+// Read the package version at runtime; a static import of package.json would break
+// tsc's rootDir:src. `../` climbs to the package root from both src (tests) and dist.
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+export const PACKAGE_VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,sFAAsF;AACtF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@agentage/find-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.agentage/find-mcp",
+  "description": "Find MCP - the npm client for the agentage MCP directory: thin stdio MCP proxy bridging stdio-only clients (Claude Desktop, Cursor, VS Code) to catalog.agentage.io/mcp - search 12,000+ MCP servers from any MCP client.",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "find-mcp",
+    "mcp-catalog",
+    "mcp-registry",
+    "claude",
+    "cursor",
+    "agentage"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentage/find-mcp.git"
+  },
+  "homepage": "https://catalog.agentage.io/mcp",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "agentage-find-mcp": "dist/bin/find-mcp.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.0.0",
+    "npm": ">=10.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src test",
+    "lint:fix": "eslint src test --fix",
+    "format": "prettier --write \"{src,test}/**/*.ts\"",
+    "format:check": "prettier --check \"{src,test}/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist *.tsbuildinfo coverage",
+    "verify": "npm run type-check && npm run lint && npm run format:check && npm run test && npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^10.7.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.2.1",
+    "prettier": "^3.4.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  }
+}