@smithery/api 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.24.0 (2026-01-21)
+
+Full Changelog: [v0.23.0...v0.24.0](https://github.com/smithery-ai/typescript-api/compare/v0.23.0...v0.24.0)
+
+### Features
+
+* add SmitheryConnectTransport for MCP SDK integration [SMI-1270] ([#39](https://github.com/smithery-ai/typescript-api/issues/39)) ([e607f59](https://github.com/smithery-ai/typescript-api/commit/e607f596a85ab4f25920781ae74a8e6c8e2237f5))
+
 ## 0.23.0 (2026-01-21)
 
 Full Changelog: [v0.22.0...v0.23.0](https://github.com/smithery-ai/typescript-api/compare/v0.22.0...v0.23.0)

package/lib/mcp-transport.d.mts

@@ -0,0 +1,97 @@
+/**
+ * SmitheryConnectTransport - An MCP Transport that routes JSON-RPC messages through Smithery Connect.
+ *
+ * This allows you to use the official MCP SDK's Client class with Smithery Connect as the transport layer.
+ *
+ * **Important:** Smithery Connect handles MCP initialization server-side when a connection is created.
+ * This transport lazily fetches/creates the connection on first message and uses its server info
+ * to satisfy the MCP SDK's initialization flow without re-initializing the already-established connection.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import Smithery from '@smithery/api';
+ * import { SmitheryConnectTransport } from '@smithery/api/mcp';
+ *
+ * const smithery = new Smithery({ apiKey: process.env.SMITHERY_API_KEY });
+ * // Option 1: Let Smithery generate a connection ID
+ * const transport = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * // Option 2: Use a specific connection ID (retrieves existing or creates new)
+ * const transport2 = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   connectionId: 'my-connection',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * const mcpClient = new Client({ name: 'my-app', version: '1.0.0' }, { capabilities: {} });
+ * await mcpClient.connect(transport);
+ *
+ * // Now use the MCP SDK's ergonomic API
+ * const { tools } = await mcpClient.listTools();
+ * const result = await mcpClient.callTool({ name: 'my-tool', arguments: {} });
+ * ```
+ */
+import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { JSONRPCMessage, ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import type { Smithery } from "../client.mjs";
+export interface SmitheryConnectTransportOptions {
+    /**
+     * The Smithery client instance to use for making RPC calls.
+     */
+    client: Smithery;
+    /**
+     * The namespace for the Smithery Connect connection.
+     */
+    namespace: string;
+    /**
+     * The connection ID for the Smithery Connect connection.
+     * If not provided, a new connection will be created with an auto-generated ID.
+     */
+    connectionId?: string;
+    /**
+     * The MCP server URL. Required when creating a new connection.
+     * If connectionId is provided, this is used to create the connection if it doesn't exist.
+     * If connectionId is not provided, this is required and a new connection will be created.
+     */
+    mcpUrl?: string;
+    /**
+     * Optional server capabilities for the initialize response.
+     * If not provided, defaults to advertising tools, resources, and prompts support.
+     */
+    capabilities?: ServerCapabilities;
+}
+export declare class SmitheryConnectTransport implements Transport {
+    private _client;
+    private _namespace;
+    private _connectionId;
+    private _mcpUrl;
+    private _started;
+    private _closed;
+    private _capabilities;
+    private _connection;
+    onmessage?: (message: JSONRPCMessage) => void;
+    onerror?: (error: Error) => void;
+    onclose?: () => void;
+    sessionId?: string;
+    /**
+     * Returns the connection ID. If no connectionId was provided in options,
+     * this returns the auto-generated ID after the first message is sent.
+     */
+    get connectionId(): string | undefined;
+    constructor(options: SmitheryConnectTransportOptions);
+    start(): Promise<void>;
+    /**
+     * Lazily ensures the Smithery Connect connection exists.
+     * Called on first message to defer network IO until actually needed.
+     */
+    private _ensureConnection;
+    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mcp-transport.d.mts.map

package/lib/mcp-transport.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-transport.d.mts","sourceRoot":"","sources":["../src/lib/mcp-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;OAEI,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,+CAA+C;OAC7F,KAAK,EAAE,cAAc,EAAmB,kBAAkB,EAAE,MAAM,oCAAoC;OACtG,KAAK,EAAE,QAAQ,EAAE;AAGxB,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAKD,qBAAa,wBAAyB,YAAW,SAAS;IACxD,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,WAAW,CAA2B;IAE9C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;gBAEW,OAAO,EAAE,+BAA+B;IAoB9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;OAGG;YACW,iBAAiB;IAiCzB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkG7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/lib/mcp-transport.d.ts

@@ -0,0 +1,97 @@
+/**
+ * SmitheryConnectTransport - An MCP Transport that routes JSON-RPC messages through Smithery Connect.
+ *
+ * This allows you to use the official MCP SDK's Client class with Smithery Connect as the transport layer.
+ *
+ * **Important:** Smithery Connect handles MCP initialization server-side when a connection is created.
+ * This transport lazily fetches/creates the connection on first message and uses its server info
+ * to satisfy the MCP SDK's initialization flow without re-initializing the already-established connection.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import Smithery from '@smithery/api';
+ * import { SmitheryConnectTransport } from '@smithery/api/mcp';
+ *
+ * const smithery = new Smithery({ apiKey: process.env.SMITHERY_API_KEY });
+ * // Option 1: Let Smithery generate a connection ID
+ * const transport = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * // Option 2: Use a specific connection ID (retrieves existing or creates new)
+ * const transport2 = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   connectionId: 'my-connection',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * const mcpClient = new Client({ name: 'my-app', version: '1.0.0' }, { capabilities: {} });
+ * await mcpClient.connect(transport);
+ *
+ * // Now use the MCP SDK's ergonomic API
+ * const { tools } = await mcpClient.listTools();
+ * const result = await mcpClient.callTool({ name: 'my-tool', arguments: {} });
+ * ```
+ */
+import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { JSONRPCMessage, ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import type { Smithery } from "../client.js";
+export interface SmitheryConnectTransportOptions {
+    /**
+     * The Smithery client instance to use for making RPC calls.
+     */
+    client: Smithery;
+    /**
+     * The namespace for the Smithery Connect connection.
+     */
+    namespace: string;
+    /**
+     * The connection ID for the Smithery Connect connection.
+     * If not provided, a new connection will be created with an auto-generated ID.
+     */
+    connectionId?: string;
+    /**
+     * The MCP server URL. Required when creating a new connection.
+     * If connectionId is provided, this is used to create the connection if it doesn't exist.
+     * If connectionId is not provided, this is required and a new connection will be created.
+     */
+    mcpUrl?: string;
+    /**
+     * Optional server capabilities for the initialize response.
+     * If not provided, defaults to advertising tools, resources, and prompts support.
+     */
+    capabilities?: ServerCapabilities;
+}
+export declare class SmitheryConnectTransport implements Transport {
+    private _client;
+    private _namespace;
+    private _connectionId;
+    private _mcpUrl;
+    private _started;
+    private _closed;
+    private _capabilities;
+    private _connection;
+    onmessage?: (message: JSONRPCMessage) => void;
+    onerror?: (error: Error) => void;
+    onclose?: () => void;
+    sessionId?: string;
+    /**
+     * Returns the connection ID. If no connectionId was provided in options,
+     * this returns the auto-generated ID after the first message is sent.
+     */
+    get connectionId(): string | undefined;
+    constructor(options: SmitheryConnectTransportOptions);
+    start(): Promise<void>;
+    /**
+     * Lazily ensures the Smithery Connect connection exists.
+     * Called on first message to defer network IO until actually needed.
+     */
+    private _ensureConnection;
+    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mcp-transport.d.ts.map

package/lib/mcp-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-transport.d.ts","sourceRoot":"","sources":["../src/lib/mcp-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;OAEI,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,+CAA+C;OAC7F,KAAK,EAAE,cAAc,EAAmB,kBAAkB,EAAE,MAAM,oCAAoC;OACtG,KAAK,EAAE,QAAQ,EAAE;AAGxB,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAKD,qBAAa,wBAAyB,YAAW,SAAS;IACxD,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,WAAW,CAA2B;IAE9C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;gBAEW,OAAO,EAAE,+BAA+B;IAoB9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;OAGG;YACW,iBAAiB;IAiCzB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkG7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/lib/mcp-transport.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * SmitheryConnectTransport - An MCP Transport that routes JSON-RPC messages through Smithery Connect.
+ *
+ * This allows you to use the official MCP SDK's Client class with Smithery Connect as the transport layer.
+ *
+ * **Important:** Smithery Connect handles MCP initialization server-side when a connection is created.
+ * This transport lazily fetches/creates the connection on first message and uses its server info
+ * to satisfy the MCP SDK's initialization flow without re-initializing the already-established connection.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import Smithery from '@smithery/api';
+ * import { SmitheryConnectTransport } from '@smithery/api/mcp';
+ *
+ * const smithery = new Smithery({ apiKey: process.env.SMITHERY_API_KEY });
+ * // Option 1: Let Smithery generate a connection ID
+ * const transport = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * // Option 2: Use a specific connection ID (retrieves existing or creates new)
+ * const transport2 = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   connectionId: 'my-connection',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * const mcpClient = new Client({ name: 'my-app', version: '1.0.0' }, { capabilities: {} });
+ * await mcpClient.connect(transport);
+ *
+ * // Now use the MCP SDK's ergonomic API
+ * const { tools } = await mcpClient.listTools();
+ * const result = await mcpClient.callTool({ name: 'my-tool', arguments: {} });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmitheryConnectTransport = void 0;
+// MCP protocol version
+const LATEST_PROTOCOL_VERSION = '2024-11-05';
+class SmitheryConnectTransport {
+    /**
+     * Returns the connection ID. If no connectionId was provided in options,
+     * this returns the auto-generated ID after the first message is sent.
+     */
+    get connectionId() {
+        return this._connectionId;
+    }
+    constructor(options) {
+        this._started = false;
+        this._closed = false;
+        this._connection = null;
+        this._client = options.client;
+        this._namespace = options.namespace;
+        this._connectionId = options.connectionId;
+        this._mcpUrl = options.mcpUrl;
+        // Validate: mcpUrl is required if connectionId is not provided
+        if (!this._connectionId && !this._mcpUrl) {
+            throw new Error('mcpUrl is required when connectionId is not provided');
+        }
+        this._capabilities = options.capabilities ?? {
+            // Default to advertising common capabilities
+            // The actual MCP server behind Smithery Connect will handle the real capabilities
+            tools: {},
+            resources: {},
+            prompts: {},
+        };
+    }
+    async start() {
+        if (this._started) {
+            throw new Error('SmitheryConnectTransport already started! If using Client class, note that connect() calls start() automatically.');
+        }
+        if (this._closed) {
+            throw new Error('Transport has been closed');
+        }
+        this._started = true;
+    }
+    /**
+     * Lazily ensures the Smithery Connect connection exists.
+     * Called on first message to defer network IO until actually needed.
+     */
+    async _ensureConnection() {
+        if (this._connection) {
+            return;
+        }
+        if (this._connectionId) {
+            // Connection ID provided: try to retrieve, or create if mcpUrl is provided
+            try {
+                this._connection = await this._client.beta.connect.connections.retrieve(this._connectionId, {
+                    namespace: this._namespace,
+                });
+            }
+            catch (error) {
+                // If connection doesn't exist and we have mcpUrl, create it with the specified ID
+                if (this._mcpUrl) {
+                    this._connection = await this._client.beta.connect.connections.set(this._connectionId, {
+                        namespace: this._namespace,
+                        mcpUrl: this._mcpUrl,
+                    });
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        else {
+            // No connection ID: create a new connection with auto-generated ID
+            // mcpUrl is guaranteed to be present (validated in constructor)
+            this._connection = await this._client.beta.connect.connections.create(this._namespace, {
+                mcpUrl: this._mcpUrl,
+            });
+            // Store the generated connection ID for subsequent RPC calls
+            this._connectionId = this._connection.connectionId;
+        }
+    }
+    async send(message, _options) {
+        if (!this._started) {
+            throw new Error('Transport not started');
+        }
+        if (this._closed) {
+            throw new Error('Transport has been closed');
+        }
+        // Only handle outgoing requests and notifications (messages with a method)
+        if (!('method' in message)) {
+            return;
+        }
+        // Lazily ensure connection exists before processing any message
+        await this._ensureConnection();
+        // Intercept 'initialize' request - Smithery Connect handles initialization server-side
+        // Return the real serverInfo from the connection
+        if (message.method === 'initialize' && 'id' in message && message.id !== undefined) {
+            if (this.onmessage) {
+                const serverInfo = this._connection?.serverInfo ?? {
+                    name: 'smithery-connect',
+                    version: '1.0.0',
+                };
+                const initializeResponse = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: {
+                        protocolVersion: LATEST_PROTOCOL_VERSION,
+                        serverInfo: {
+                            name: serverInfo.name,
+                            version: serverInfo.version,
+                        },
+                        capabilities: this._capabilities,
+                    },
+                };
+                // Use setTimeout to make this async and match real transport behavior
+                setTimeout(() => this.onmessage(initializeResponse), 0);
+            }
+            return;
+        }
+        // Intercept 'notifications/initialized' - no response needed, just acknowledge
+        if (message.method === 'notifications/initialized') {
+            return;
+        }
+        try {
+            // Build the RPC call params, only including id if it's defined
+            const rpcParams = {
+                namespace: this._namespace,
+                jsonrpc: '2.0',
+                method: message.method,
+            };
+            // Only add id if present (for requests, not notifications)
+            if ('id' in message && message.id !== undefined) {
+                rpcParams.id = message.id;
+            }
+            // Only add params if present
+            if ('params' in message && message.params !== undefined) {
+                rpcParams.params = message.params;
+            }
+            const response = await this._client.beta.connect.rpc.call(this._connectionId, rpcParams);
+            // Route the response back via onmessage callback for requests (messages with an id)
+            if ('id' in message && message.id !== undefined && this.onmessage) {
+                const jsonRpcResponse = {
+                    jsonrpc: '2.0',
+                    id: response.id,
+                    result: response.result,
+                };
+                this.onmessage(jsonRpcResponse);
+            }
+        }
+        catch (error) {
+            const normalizedError = error instanceof Error ? error : new Error(String(error));
+            // For requests, send an error response via onmessage
+            if ('id' in message && message.id !== undefined && this.onmessage) {
+                const errorResponse = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    error: {
+                        code: -32603, // Internal error
+                        message: normalizedError.message,
+                    },
+                };
+                this.onmessage(errorResponse);
+            }
+            // Also report via onerror callback
+            this.onerror?.(normalizedError);
+        }
+    }
+    async close() {
+        this._closed = true;
+        this._started = false;
+        this.onclose?.();
+    }
+}
+exports.SmitheryConnectTransport = SmitheryConnectTransport;
+//# sourceMappingURL=mcp-transport.js.map

package/lib/mcp-transport.js.map

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

package/lib/mcp-transport.mjs

@@ -0,0 +1,209 @@
+/**
+ * SmitheryConnectTransport - An MCP Transport that routes JSON-RPC messages through Smithery Connect.
+ *
+ * This allows you to use the official MCP SDK's Client class with Smithery Connect as the transport layer.
+ *
+ * **Important:** Smithery Connect handles MCP initialization server-side when a connection is created.
+ * This transport lazily fetches/creates the connection on first message and uses its server info
+ * to satisfy the MCP SDK's initialization flow without re-initializing the already-established connection.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import Smithery from '@smithery/api';
+ * import { SmitheryConnectTransport } from '@smithery/api/mcp';
+ *
+ * const smithery = new Smithery({ apiKey: process.env.SMITHERY_API_KEY });
+ * // Option 1: Let Smithery generate a connection ID
+ * const transport = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * // Option 2: Use a specific connection ID (retrieves existing or creates new)
+ * const transport2 = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   connectionId: 'my-connection',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * const mcpClient = new Client({ name: 'my-app', version: '1.0.0' }, { capabilities: {} });
+ * await mcpClient.connect(transport);
+ *
+ * // Now use the MCP SDK's ergonomic API
+ * const { tools } = await mcpClient.listTools();
+ * const result = await mcpClient.callTool({ name: 'my-tool', arguments: {} });
+ * ```
+ */
+// MCP protocol version
+const LATEST_PROTOCOL_VERSION = '2024-11-05';
+export class SmitheryConnectTransport {
+    /**
+     * Returns the connection ID. If no connectionId was provided in options,
+     * this returns the auto-generated ID after the first message is sent.
+     */
+    get connectionId() {
+        return this._connectionId;
+    }
+    constructor(options) {
+        this._started = false;
+        this._closed = false;
+        this._connection = null;
+        this._client = options.client;
+        this._namespace = options.namespace;
+        this._connectionId = options.connectionId;
+        this._mcpUrl = options.mcpUrl;
+        // Validate: mcpUrl is required if connectionId is not provided
+        if (!this._connectionId && !this._mcpUrl) {
+            throw new Error('mcpUrl is required when connectionId is not provided');
+        }
+        this._capabilities = options.capabilities ?? {
+            // Default to advertising common capabilities
+            // The actual MCP server behind Smithery Connect will handle the real capabilities
+            tools: {},
+            resources: {},
+            prompts: {},
+        };
+    }
+    async start() {
+        if (this._started) {
+            throw new Error('SmitheryConnectTransport already started! If using Client class, note that connect() calls start() automatically.');
+        }
+        if (this._closed) {
+            throw new Error('Transport has been closed');
+        }
+        this._started = true;
+    }
+    /**
+     * Lazily ensures the Smithery Connect connection exists.
+     * Called on first message to defer network IO until actually needed.
+     */
+    async _ensureConnection() {
+        if (this._connection) {
+            return;
+        }
+        if (this._connectionId) {
+            // Connection ID provided: try to retrieve, or create if mcpUrl is provided
+            try {
+                this._connection = await this._client.beta.connect.connections.retrieve(this._connectionId, {
+                    namespace: this._namespace,
+                });
+            }
+            catch (error) {
+                // If connection doesn't exist and we have mcpUrl, create it with the specified ID
+                if (this._mcpUrl) {
+                    this._connection = await this._client.beta.connect.connections.set(this._connectionId, {
+                        namespace: this._namespace,
+                        mcpUrl: this._mcpUrl,
+                    });
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        else {
+            // No connection ID: create a new connection with auto-generated ID
+            // mcpUrl is guaranteed to be present (validated in constructor)
+            this._connection = await this._client.beta.connect.connections.create(this._namespace, {
+                mcpUrl: this._mcpUrl,
+            });
+            // Store the generated connection ID for subsequent RPC calls
+            this._connectionId = this._connection.connectionId;
+        }
+    }
+    async send(message, _options) {
+        if (!this._started) {
+            throw new Error('Transport not started');
+        }
+        if (this._closed) {
+            throw new Error('Transport has been closed');
+        }
+        // Only handle outgoing requests and notifications (messages with a method)
+        if (!('method' in message)) {
+            return;
+        }
+        // Lazily ensure connection exists before processing any message
+        await this._ensureConnection();
+        // Intercept 'initialize' request - Smithery Connect handles initialization server-side
+        // Return the real serverInfo from the connection
+        if (message.method === 'initialize' && 'id' in message && message.id !== undefined) {
+            if (this.onmessage) {
+                const serverInfo = this._connection?.serverInfo ?? {
+                    name: 'smithery-connect',
+                    version: '1.0.0',
+                };
+                const initializeResponse = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: {
+                        protocolVersion: LATEST_PROTOCOL_VERSION,
+                        serverInfo: {
+                            name: serverInfo.name,
+                            version: serverInfo.version,
+                        },
+                        capabilities: this._capabilities,
+                    },
+                };
+                // Use setTimeout to make this async and match real transport behavior
+                setTimeout(() => this.onmessage(initializeResponse), 0);
+            }
+            return;
+        }
+        // Intercept 'notifications/initialized' - no response needed, just acknowledge
+        if (message.method === 'notifications/initialized') {
+            return;
+        }
+        try {
+            // Build the RPC call params, only including id if it's defined
+            const rpcParams = {
+                namespace: this._namespace,
+                jsonrpc: '2.0',
+                method: message.method,
+            };
+            // Only add id if present (for requests, not notifications)
+            if ('id' in message && message.id !== undefined) {
+                rpcParams.id = message.id;
+            }
+            // Only add params if present
+            if ('params' in message && message.params !== undefined) {
+                rpcParams.params = message.params;
+            }
+            const response = await this._client.beta.connect.rpc.call(this._connectionId, rpcParams);
+            // Route the response back via onmessage callback for requests (messages with an id)
+            if ('id' in message && message.id !== undefined && this.onmessage) {
+                const jsonRpcResponse = {
+                    jsonrpc: '2.0',
+                    id: response.id,
+                    result: response.result,
+                };
+                this.onmessage(jsonRpcResponse);
+            }
+        }
+        catch (error) {
+            const normalizedError = error instanceof Error ? error : new Error(String(error));
+            // For requests, send an error response via onmessage
+            if ('id' in message && message.id !== undefined && this.onmessage) {
+                const errorResponse = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    error: {
+                        code: -32603, // Internal error
+                        message: normalizedError.message,
+                    },
+                };
+                this.onmessage(errorResponse);
+            }
+            // Also report via onerror callback
+            this.onerror?.(normalizedError);
+        }
+    }
+    async close() {
+        this._closed = true;
+        this._started = false;
+        this.onclose?.();
+    }
+}
+//# sourceMappingURL=mcp-transport.mjs.map

package/lib/mcp-transport.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smithery/api",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "The official TypeScript library for the Smithery API",
   "author": "Smithery <contact@smithery.ai>",
   "types": "./index.d.ts",
@@ -15,7 +15,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {},
   "exports": {
     ".": {
       "require": {
@@ -75,6 +74,16 @@
     "./index.mjs": {
       "default": "./index.mjs"
     },
+    "./lib/*.mjs": {
+      "default": "./lib/*.mjs"
+    },
+    "./lib/*.js": {
+      "default": "./lib/*.js"
+    },
+    "./lib/*": {
+      "import": "./lib/*.mjs",
+      "require": "./lib/*.js"
+    },
     "./pagination": {
       "import": "./pagination.mjs",
       "require": "./pagination.js"
@@ -134,6 +143,29 @@
     },
     "./version.mjs": {
       "default": "./version.mjs"
+    },
+    "./mcp": {
+      "require": {
+        "types": "./lib/mcp-transport.d.ts",
+        "default": "./lib/mcp-transport.js"
+      },
+      "types": "./lib/mcp-transport.d.mts",
+      "default": "./lib/mcp-transport.mjs"
+    }
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "mcp": [
+        "./lib/mcp-transport.d.ts"
+      ]
     }
   },
   "scripts": {

package/src/lib/mcp-transport.ts

@@ -0,0 +1,277 @@
+/**
+ * SmitheryConnectTransport - An MCP Transport that routes JSON-RPC messages through Smithery Connect.
+ *
+ * This allows you to use the official MCP SDK's Client class with Smithery Connect as the transport layer.
+ *
+ * **Important:** Smithery Connect handles MCP initialization server-side when a connection is created.
+ * This transport lazily fetches/creates the connection on first message and uses its server info
+ * to satisfy the MCP SDK's initialization flow without re-initializing the already-established connection.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+ * import Smithery from '@smithery/api';
+ * import { SmitheryConnectTransport } from '@smithery/api/mcp';
+ *
+ * const smithery = new Smithery({ apiKey: process.env.SMITHERY_API_KEY });
+ * // Option 1: Let Smithery generate a connection ID
+ * const transport = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * // Option 2: Use a specific connection ID (retrieves existing or creates new)
+ * const transport2 = new SmitheryConnectTransport({
+ *   client: smithery,
+ *   namespace: 'my-namespace',
+ *   connectionId: 'my-connection',
+ *   mcpUrl: 'https://mcp.example.com/sse',
+ * });
+ *
+ * const mcpClient = new Client({ name: 'my-app', version: '1.0.0' }, { capabilities: {} });
+ * await mcpClient.connect(transport);
+ *
+ * // Now use the MCP SDK's ergonomic API
+ * const { tools } = await mcpClient.listTools();
+ * const result = await mcpClient.callTool({ name: 'my-tool', arguments: {} });
+ * ```
+ */
+
+import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { JSONRPCMessage, JSONRPCResponse, ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import type { Smithery } from '../client';
+import type { Connection } from '../resources/beta/connect/connections';
+
+export interface SmitheryConnectTransportOptions {
+  /**
+   * The Smithery client instance to use for making RPC calls.
+   */
+  client: Smithery;
+
+  /**
+   * The namespace for the Smithery Connect connection.
+   */
+  namespace: string;
+
+  /**
+   * The connection ID for the Smithery Connect connection.
+   * If not provided, a new connection will be created with an auto-generated ID.
+   */
+  connectionId?: string;
+
+  /**
+   * The MCP server URL. Required when creating a new connection.
+   * If connectionId is provided, this is used to create the connection if it doesn't exist.
+   * If connectionId is not provided, this is required and a new connection will be created.
+   */
+  mcpUrl?: string;
+
+  /**
+   * Optional server capabilities for the initialize response.
+   * If not provided, defaults to advertising tools, resources, and prompts support.
+   */
+  capabilities?: ServerCapabilities;
+}
+
+// MCP protocol version
+const LATEST_PROTOCOL_VERSION = '2024-11-05';
+
+export class SmitheryConnectTransport implements Transport {
+  private _client: Smithery;
+  private _namespace: string;
+  private _connectionId: string | undefined;
+  private _mcpUrl: string | undefined;
+  private _started = false;
+  private _closed = false;
+  private _capabilities: ServerCapabilities;
+  private _connection: Connection | null = null;
+
+  onmessage?: (message: JSONRPCMessage) => void;
+  onerror?: (error: Error) => void;
+  onclose?: () => void;
+
+  sessionId?: string;
+
+  /**
+   * Returns the connection ID. If no connectionId was provided in options,
+   * this returns the auto-generated ID after the first message is sent.
+   */
+  get connectionId(): string | undefined {
+    return this._connectionId;
+  }
+
+  constructor(options: SmitheryConnectTransportOptions) {
+    this._client = options.client;
+    this._namespace = options.namespace;
+    this._connectionId = options.connectionId;
+    this._mcpUrl = options.mcpUrl;
+
+    // Validate: mcpUrl is required if connectionId is not provided
+    if (!this._connectionId && !this._mcpUrl) {
+      throw new Error('mcpUrl is required when connectionId is not provided');
+    }
+
+    this._capabilities = options.capabilities ?? {
+      // Default to advertising common capabilities
+      // The actual MCP server behind Smithery Connect will handle the real capabilities
+      tools: {},
+      resources: {},
+      prompts: {},
+    };
+  }
+
+  async start(): Promise<void> {
+    if (this._started) {
+      throw new Error(
+        'SmitheryConnectTransport already started! If using Client class, note that connect() calls start() automatically.',
+      );
+    }
+    if (this._closed) {
+      throw new Error('Transport has been closed');
+    }
+
+    this._started = true;
+  }
+
+  /**
+   * Lazily ensures the Smithery Connect connection exists.
+   * Called on first message to defer network IO until actually needed.
+   */
+  private async _ensureConnection(): Promise<void> {
+    if (this._connection) {
+      return;
+    }
+
+    if (this._connectionId) {
+      // Connection ID provided: try to retrieve, or create if mcpUrl is provided
+      try {
+        this._connection = await this._client.beta.connect.connections.retrieve(this._connectionId, {
+          namespace: this._namespace,
+        });
+      } catch (error) {
+        // If connection doesn't exist and we have mcpUrl, create it with the specified ID
+        if (this._mcpUrl) {
+          this._connection = await this._client.beta.connect.connections.set(this._connectionId, {
+            namespace: this._namespace,
+            mcpUrl: this._mcpUrl,
+          });
+        } else {
+          throw error;
+        }
+      }
+    } else {
+      // No connection ID: create a new connection with auto-generated ID
+      // mcpUrl is guaranteed to be present (validated in constructor)
+      this._connection = await this._client.beta.connect.connections.create(this._namespace, {
+        mcpUrl: this._mcpUrl!,
+      });
+      // Store the generated connection ID for subsequent RPC calls
+      this._connectionId = this._connection.connectionId;
+    }
+  }
+
+  async send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void> {
+    if (!this._started) {
+      throw new Error('Transport not started');
+    }
+    if (this._closed) {
+      throw new Error('Transport has been closed');
+    }
+
+    // Only handle outgoing requests and notifications (messages with a method)
+    if (!('method' in message)) {
+      return;
+    }
+
+    // Lazily ensure connection exists before processing any message
+    await this._ensureConnection();
+
+    // Intercept 'initialize' request - Smithery Connect handles initialization server-side
+    // Return the real serverInfo from the connection
+    if (message.method === 'initialize' && 'id' in message && message.id !== undefined) {
+      if (this.onmessage) {
+        const serverInfo = this._connection?.serverInfo ?? {
+          name: 'smithery-connect',
+          version: '1.0.0',
+        };
+
+        const initializeResponse: JSONRPCResponse = {
+          jsonrpc: '2.0',
+          id: message.id,
+          result: {
+            protocolVersion: LATEST_PROTOCOL_VERSION,
+            serverInfo: {
+              name: serverInfo.name,
+              version: serverInfo.version,
+            },
+            capabilities: this._capabilities,
+          } as Record<string, unknown>,
+        };
+        // Use setTimeout to make this async and match real transport behavior
+        setTimeout(() => this.onmessage!(initializeResponse), 0);
+      }
+      return;
+    }
+
+    // Intercept 'notifications/initialized' - no response needed, just acknowledge
+    if (message.method === 'notifications/initialized') {
+      return;
+    }
+
+    try {
+      // Build the RPC call params, only including id if it's defined
+      const rpcParams: Parameters<typeof this._client.beta.connect.rpc.call>[1] = {
+        namespace: this._namespace,
+        jsonrpc: '2.0',
+        method: message.method,
+      };
+
+      // Only add id if present (for requests, not notifications)
+      if ('id' in message && message.id !== undefined) {
+        rpcParams.id = message.id;
+      }
+
+      // Only add params if present
+      if ('params' in message && message.params !== undefined) {
+        rpcParams.params = message.params as Record<string, unknown>;
+      }
+
+      const response = await this._client.beta.connect.rpc.call(this._connectionId!, rpcParams);
+
+      // Route the response back via onmessage callback for requests (messages with an id)
+      if ('id' in message && message.id !== undefined && this.onmessage) {
+        const jsonRpcResponse: JSONRPCResponse = {
+          jsonrpc: '2.0',
+          id: response.id!,
+          result: response.result as Record<string, unknown>,
+        };
+        this.onmessage(jsonRpcResponse);
+      }
+    } catch (error) {
+      const normalizedError = error instanceof Error ? error : new Error(String(error));
+
+      // For requests, send an error response via onmessage
+      if ('id' in message && message.id !== undefined && this.onmessage) {
+        const errorResponse: JSONRPCResponse = {
+          jsonrpc: '2.0',
+          id: message.id,
+          error: {
+            code: -32603, // Internal error
+            message: normalizedError.message,
+          },
+        };
+        this.onmessage(errorResponse);
+      }
+
+      // Also report via onerror callback
+      this.onerror?.(normalizedError);
+    }
+  }
+
+  async close(): Promise<void> {
+    this._closed = true;
+    this._started = false;
+    this.onclose?.();
+  }
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.23.0'; // x-release-please-version
+export const VERSION = '0.24.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.23.0";
+export declare const VERSION = "0.24.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.23.0";
+export declare const VERSION = "0.24.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.23.0'; // x-release-please-version
+exports.VERSION = '0.24.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.23.0'; // x-release-please-version
+export const VERSION = '0.24.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map